InsightSocial API
TikTok Shop

TikTok Shop Products API reference

Your first 10 calls are free, no card needed. Pricing and FAQ

Get a free API key
Example request
curl "https://api.insightsocial.app/v1/tiktokshop/products?url=https%3A%2F%2Fwww.tiktok.com%2Fshop%2Fstore%2Fgoli-nutrition%2F7495794203056835079" \
  -H "x-api-key: $INSIGHTSOCIAL_API_KEY"
GET
/v1/tiktokshop/products

Returns the products listed on a TikTok Shop storefront: title, images, canonical URL, price and discount, sold count, review count, rating, SKU ID, and the shop's own profile.

Beta. The source's own structure under our naming rules (snake_case keys, string ids, ISO times where the source gives a timestamp), not one of the schema-2 entities. Fields may change. See Beta endpoints.

Use it when you have a storefront URL and want everything it sells; use search to find products across storefronts by keyword.

10 credits per call.

Paginates by cursor: see Pagination.

x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

url*string

Full URL of the TikTok Shop page

sort_by?string

Sort products by best-selling (top) or newest (new_releases). Defaults to top.

Value in

  • "top"
  • "new_releases"
region?string

Region to get shop products from. A storefront is only reachable from its own market, so a GB shop needs region=GB; the default is US. Prices are decimal amounts in the major unit of price.currency, and each row's price belongs to the SKU in product.ext.sku_id.

Value in

  • "US"
  • "GB"
  • "DE"
  • "FR"
  • "IT"
  • "ID"
  • "MY"
  • "MX"
  • "PH"
  • "SG"
  • "ES"
  • "TH"
  • "VN"
  • "BR"
  • "JP"
  • "IE"
cursor?string

Pagination cursor. Pass back pagination.next_cursor from the previous response.

max_pages?integer

1 to 50 (default 1). Walk up to this many pages in one call and return the rows from all of them.

Range1 <= value <= 50
max_age_s?integer

The 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 600 seconds old is served; this endpoint keeps copies for 3600 seconds, so a value up to 3600 can save a call. A lower value fetches fresh (billed) when the copy is older, and 0 always fetches live, like Cache-Control: no-cache.

Range0 <= value <= 3600
dry_run?"1"

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Value in

  • "1"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.insightsocial.app/v1/tiktokshop/products?url=string"
{  "success": true,  "platform": "string",  "endpoint": "string",  "schema_version": "2",  "pagination": {    "next_cursor": "string",    "has_more": true,    "page_size": 0,    "stopped_at": "since"  },  "unavailable": [    "string"  ],  "credits_used": 0,  "credits_remaining": 0,  "request_id": "string",  "cached": true,  "idempotent_replay": true,  "charge_reason": "string",  "free_call": true,  "data": {    "property1": null,    "property2": null  }}