TikTok Shop

TikTok Shop Search

Search the TikTok Shop US catalog by keyword. Returns up to 30 products per page — title, canonical URL, image, exact price (current, original, discount, and the min/max across variants), rating, units sold, variant count, brand, shop, and promotion labels — plus a brand carousel and a pagination cursor, as JSON. This endpoint returns exact prices; the product detail endpoint does not, and only about 44% of the product ids returned here resolve on it, so treat search results as the authoritative listing rather than as input to a guaranteed detail lookup. Costs 1 credit per request.

POST/api/v1/tiktok-shop/search

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

searchstringrequired

The search keyword (1-200 characters). Search covers the US catalog only; there is no region parameter here because the source rejects every other region.

Example: phone case

cursorstring

Opaque cursor from a previous response's next_cursor. Keep passing it while has_more is true. Pages can repeat a product that appeared on an earlier page, so dedupe by product_id across pages (duplicates within a single page are already removed).

Example: eyJrIjoic2VhcmNoIiwibyI6MzAsInQiOiIyMDI2...

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
results = client.tiktok_shop.search(search="phone case")
print(results)

Response

"query": "phone case",

"next_cursor": "eyJrIjoic2VhcmNoIiwibyI6MzAsInQiOiIyMDI2MDcyOTAyMTg0MDVGNDlGNjM2QjgzMTk0MTE1RjlFIn0",

"has_more": true,

"degraded": false

"response_time": 2870,

"credits_used": 1,

"credits_remaining": 4820

}