Social Fetch
TikTok

Get TikTok Shop product

Returns detailed catalog data for a TikTok Shop product page URL, including offer and media fields when the page resolves. Response shape may change as the catalog updates.

Operation

GET/v1/tiktok/products
Cost: 1 credit

Headers

x-api-keystringrequired(header)

API key (`sfk_...`)

Parameters

urlstringrequired(query)

Public TikTok Shop product detail page URL for the product to retrieve.

min 1 chars · max 4096 chars

regionstring(query)

Optional country or region code for the product catalog. When omitted, the default catalog region applies.

one of: US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, IE

Response fields

data
objectrequired

Endpoint-specific response payload.

dataproduct
objectrequired

Product detail data from the catalog, when the product page could be resolved.

meta
objectrequired

Metadata describing the request and billing outcome.

metarequestId
stringrequired

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integerrequired

Credits charged for this request.

≥ 0

metaversion
stringrequired

Public API version that served the response.

one of: v1

Code example

Responses

Product detail for the given product page URL.

Error codes

bad_requestinsufficient_creditsinternal_errorlookup_failedtemporarily_unavailableunauthorized

On this page