SocialPipe docs

TikTok Shop hot selling products list API

GET/v1/tiktok/shop/web/fetch_hot_selling_products_list

Returns personal data about people in bulk. The response carries accounts who are not the subject of your request. See our terms for what you may do with it.

Costs 1 credit. A cache hit costs nothing, and an answer that contains no data is never charged.

curl "https://api.socialpipe.dev/v1/tiktok/shop/web/fetch_hot_selling_products_list" \  -H "Authorization: Bearer $SOCIALPIPE_KEY"
AuthorizationBearer <token>

Your SocialPipe API key, as Authorization: Bearer sp_live_…. Create one in the dashboard.

In: header

Query Parameters

region?|

Region code: US, SG, MY, PH, TH, VN, ID, JP, MX, BRGB / GB temporarily unavailable. HTTP 200data.region_supported=false supported_regions / Unsupported regions return HTTP 200 with data.region_supported=false and supported_regions.

count?|

20/Number of products to return, default 20

exclude_product_ids?|

ID/Comma-separated product IDs you already have, used for paging

cache_ttl?|

Max acceptable age of a cached result, in seconds. A lower value demands fresher data; it does not shorten what is stored.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/tiktok/shop/web/fetch_hot_selling_products_list"
{  "cache_age": 0,  "cached": false,  "credits_remaining": 0,  "credits_used": 0,  "data": {},  "schema_version": "2",  "success": true,  "took_ms": 0}