TikTok Shop Fetch Products By Category ID

2.07 credits/call
ae_tiktok_shop_fetch_products_by_category_id

Retrieve products in a category for a selected region. The required category_id must match the region; you can obtain it from the category-list operation. The optional region defaults to US and supports US, SG, MY, PH, TH, VN, ID, JP, and MX; GB and BR are unavailable. The optional offset defaults to 0. Products appear at data.data.productList, with pagination status at data.data.hasMore. A page may contain fewer than 20 products. When collecting multiple pages, deduplicate by product_id and stop when hasMore is false or no new products are returned. Product fields including image, product_price_info, rate_info, sold_info, seller_info, and seo_url are objects.

Productivity
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.07 credits/call

2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
offsetintegerNo翻页偏移量/Offset for pagination0
regionstringNo地区代码/Region code: US, SG, MY, PH, TH, VN, ID, JP, MX。GB 和 BR 暂不支持 / GB and BR are unavailable.US
category_idintegerYes分类ID/Category ID—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tiktok_shop_fetch_products_by_category_id' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "category_id": 963976
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "code": 0,
    "data": {
      "productList": [
        {
          "image": {
            "height": 1200,
            "uri": "tos-useast5-i-omjb5zjo8w-tx/007a7437f24e4f2785b7ffeeef673ce1",
            "url_list": [],
            "width": 1200
          },
          "product_id": "1732394021320691747",
          "product_marketing_info": {
            "placement_labels": {},
            "placement_labels_ui": {}
          },
          "product_price_info": {
            "currency_name": "USD",
            "currency_show_mode": 1,
            "currency_symbol": "$",
            "sale_price_decimal": "15.99",
            "sale_price_decimal_part_format": "99",
            "sale_price_format": "15.99"
          },
          "rate_info": {
            "review_count": "6",
            "score": 3.3
          },
          "title": "Aoqta Women's Elastic Knit Workout Exercise Dress - Sleeveless Halter Quick-Dry Bodycon Sporty Dress with Sleek Lines, Tennis Casual & Yoga Athletic Alternative to Skirts for Running & Everyday Wear"
        }
      ]
    },
    "message": "success"
  },
  "docs": "https://api.tikhub.io/#/TikTok-Shop-Web-API/fetch_products_by_category_id_api_v1_tiktok_shop_web_fetch_products_by_category_id_get",
  "message": "Request successful. This request will incur a charge."
}

This example shows part of the response. Copied content is valid JSON.