InsightSocial
GET /v1/tiktokshop/searchbeta

TikTok Shop Search API

Returns TikTok Shop products matching a keyword across every storefront, each with price, rating, sold count, seller trust label, ship-from location, and promotion badges.

10 credits a call · cursor pagination · failed calls free · 10 free calls to start

curl "https://api.insightsocial.app/v1/tiktokshop/search?query=phone+case" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "tiktokshop",
"endpoint": "/v1/tiktokshop/search",
"schema_version": "2",
"data": {
"<field>": "<value>"
},
"pagination": {
"next_cursor": "<string | null>",
"has_more": "<boolean>"
},
"unavailable": [],
"credits_used": "<integer>"
}

When to use it

Use it to find products by keyword across every storefront; use products when you already know the storefront.

Parameters

Query parameters for GET /v1/tiktokshop/search. Send your key in the x-api-key header.

NameRequiredDescription
queryYesSearch keyword or phrase to find TikTok Shop products
pageNoPage number to retrieve. Prefer passing back pagination.next_cursor, which carries the same position.
regionNoRegion to search shop products in. Results, prices and currency follow the market; defaults to US. price.current and price.original are always decimal amounts in the major unit of price.currency in every region (10.90 means 10.90 EUR). Search rows do not name the SKU a price belongs to (product.ext.sku_id is null); tiktokshop/products on the seller's storefront names it.
max_pagesNo1 to 50 (default 1). Walk up to this many pages in one call and return the rows from all of them.
max_age_sNoThe oldest cached copy you accept, in seconds. A copy that old or younger is served, with its age in age_s and the X-Cache-Age header. Without it a copy up to 120 seconds old is served. A lower value fetches fresh (billed) when the copy is older, and 0 always fetches live, like Cache-Control: no-cache.
cursorNoThe pagination.next_cursor from the previous page, sent back unchanged. Omit it for the first page.

Response

This endpoint is beta: data holds the platform's own fields under our naming rules (snake_case keys, string ids, ISO times where the platform gives a timestamp) rather than a unified post or profile, and those fields may change.

Every field, error and example is in the TikTok Shop Search API reference.

How much does the TikTok Shop Search API cost?

10 credits per successful call.

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Know the price first

    Add dry_run=1 and the response quotes the call without making it. Nothing is charged.

  • One balance

    API calls and Chrome extension exports share the same credits, on the free plan too.

TikTok Shop Search API: frequently asked questions

Send GET /v1/tiktokshop/search with the query parameter and your key in the x-api-key header. Returns TikTok Shop products matching a keyword across every storefront, each with price, rating, sold count, seller trust label, ship-from location, and promotion badges.