Skip to main content
POST
TikTok Shop Category Products API

TikTok Shop Category Products

Browse a TikTok Shop category the way shoppers do. Pass a category ID and get its products with title, price, units sold, rating, reviews, shop and images. Pair it with TikTok Shop Categories to sweep a whole vertical, compare price bands between subcategories, or watch how a category’s best sellers change over time.
Provide a category ID from TikTok Shop Categories in category_id. region defaults to US; US, SG, MY, PH, TH, VN, ID, JP and MX are available. results_limit defaults to 30 and accepts integers from 1 to 500. Each product costs 0.5 credits.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide a category ID from TikTok Shop Categories in category_id. region defaults to US. results_limit defaults to 30 and accepts integers from 1 to 500.

category_id
string
required

Numeric category ID, as returned by TikTok Shop Categories.

Pattern: ^[0-9]{1,20}$
callback_url
string<uri>
region
enum<string>
default:US

Country or region code of the TikTok Shop market.

Available options:
ID,
JP,
MX,
MY,
PH,
SG,
TH,
US,
VN
Minimum string length: 1
results_limit
integer
default:30
Required range: 1 <= x <= 500

Response

Task accepted

code
integer
data
object