Skip to content
truescrape
Free key

Contents

Site

TikTok Shop Search API

Open in ChatGPTOpen in ClaudeOpen in Gemini

The products TikTok Shop search returns for a query, page by page, with price, rating, review and sales counts. US market. Calls cost 1 credit each. A cache hit is free, and a failed or empty response is never charged.

Try it

Prefilled with the request that produced the example below. No key yet? Get a free key.

Request

GET/v1/tiktok/shop/search
ParameterTypeRequiredDescription
querystringyesSearch terms
countnumbernoItems per page (default 20, max 50)
cursorstringnopagination.cursor from a previous response
regionstringnoTwo-letter market code (US, GB, ID…). TikTok feeds and catalogues are per-market.

Also accepts cache_max_age (a hit costs 0 credits) and include_raw (returns the untouched upstream payload under raw).

curl
curl "$API/v1/tiktok/shop/search?query=running%20shoes&region=US&cache_max_age=7d" \
  -H "x-api-key: $KEY"
JavaScript
const query = new URLSearchParams({
  query: 'running shoes',
  region: 'US',
  cache_max_age: '7d',
});

const response = await fetch(`${API}/v1/tiktok/shop/search?${query}`, {
  headers: { 'x-api-key': KEY },
});

const body = await response.json();
if (!body.success) throw new Error(body.error.code);

// 1 credit, 0 on a cache hit
console.log(body.data, body.meta.creditsCharged);
Python
import os, httpx

r = httpx.get(
    f"{os.environ['API']}/v1/tiktok/shop/search",
    params={
        "query": "running shoes",
        "region": "US",
        "cache_max_age": "7d",
    },
    headers={"x-api-key": os.environ["KEY"]},
    timeout=30,
)

body = r.json()
if not body["success"]:
    raise RuntimeError(body["error"]["code"])

print(body["data"], body["meta"]["creditsCharged"])

Example response

Captured on , with raw removed and lists cut to two items. A live call returns current data.

response
{
  "success": true,
  "data": {
    "items": [
      {
        "platform": "tiktok",
        "id": "1732423766407353143",
        "title": "Xtep 2000km Series Men's Pro Running Shoes | Breathable Comfort Training Sneakers for Jogging, Marathon & Road Run",
        "url": "https://shop.tiktok.com/us/pdp/xtep-2000km-series-mens-pro-running-shoes-breathable-stable/1732423766407353143",
        "description": null,
        "price": {
          "amount": 76.69,
          "currency": "USD",
          "formatted": "$76.69"
        },
        "originalPrice": {
          "amount": null,
          "currency": "USD",
          "formatted": null
        },
        "imageUrls": [
          "https://p16-oec-general-useast8.ttcdn-us.com/tos-useast8-i-rt0ujvrtvp-tx2/8c38ead8da6d45ce897e2c4ca4f0871a~tplv-fhlh96nyum-crop-webp:1254:1254.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839"
        ],
        "rating": 4.7,
        "reviewCount": 26,
        "soldCount": 397,
        "inStock": null,
        "sellerId": "7496108937431518007",
        "sellerName": "XtepOfficial",
        "categoryName": null,
        "fetchedAt": "2026-10-21T01:55:14.025Z"
      },
      {
        "platform": "tiktok",
        "id": "1732768857503863009",
        "title": "All Black Fabric Trail Running Shoes, Thick Non-slip Sole for Outdoor Trekking & Daily Wear",
        "url": "https://shop.tiktok.com/us/pdp/1732768857503863009",
        "description": null,
        "price": {
          "amount": 105.66,
          "currency": "USD",
          "formatted": "$105.66"
        },
        "originalPrice": {
          "amount": null,
          "currency": "USD",
          "formatted": null
        },
        "imageUrls": [
          "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/01f2c0ad4bc64595a0e3569157aa92a8~tplv-fhlh96nyum-crop-webp:604:600.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839"
        ],
        "rating": 0,
        "reviewCount": 0,
        "soldCount": 1,
        "inStock": null,
        "sellerId": "7494975709237576929",
        "sellerName": "Jay Suraj Investors Llc",
        "categoryName": null,
        "fetchedAt": "2026-10-21T01:55:14.025Z"
      }
    ]
  },
  "pagination": {
    "cursor": "eyJwYXJhbXMiOnsib2Zmc2V0IjoyMCwicGFnZV90b2tlbiI6IjIwMjYxMDIxMDE1NTExOUEwOTkyRDk3RDc3OTM2NDdFREEiLCJhcGlfc291cmNlIjoxfSwic2VlbiI6WyIxNzMyNDIzNzY2NDA3MzUzMTQzIiwiMTczMjc2ODg1NzUwMzg2MzAwOSIsIjE3MzI3NzMyNjc2MzUwMTY2MjciLCIxNzMyNTU3MTI3ODAwNzU0NzI5IiwiMTczMjc2OTA3NTI5MDQxMTU4NCIsIjE3MzI3NjkwODcyNTQwNzM5MjAiLCIxNzMyNjk0MTE3NTA0Njg0OTIwIiwiMTczMjc2OTE0Mzg5MDAyMjk3NiIsIjE3MzI2OTg2MzYxODUwODA0MzUiLCIxNzMyNjk4NjIzNDcyODY1OTA3IiwiMTczMjY5ODgwNDgwNjg0OTEzOSIsIjE3MzI0NTY5NzY5NzIyMjI5NzUiLCIxNzMxNzA4MDk4MTYxNTEzMzQ0IiwiMTczMjYwODYzMzgxODc0NzIzNiIsIjE3MzI1NDE4OTU2MjM0Nzk2NzIiLCIxNzMyNzAyNzM4NTM3ODEyNTk1IiwiMTcyOTQxNjQzMTA5OTg3NjE1NCIsIjE3MzIzNTAzNTA3MTkxNjEwNTIiLCIxNzMyNzYxMDY2MTQxNjg0NDM4IiwiMTczMDcxODM5MTE4MDQ5Nzc5MiJdfQ",
    "hasMore": true,
    "count": 20
  },
  "meta": {
    "platform": "tiktok",
    "endpoint": "tiktok.shopSearch",
    "creditsCharged": 1,
    "cached": false,
    "cacheAgeSeconds": null,
    "durationMs": 2838,
    "requestId": "req_zl0g5idkpjn97wjvj91t"
  }
}

Returns

Returns a list of object in data.items.

Fields
FieldTypePresentDescription
platform"tiktok"always
idstringalways
titlestringalways
urlstring | nullalways
descriptionstring | nullalways
priceobjectalways
price.amountnumber | nullalwaysNumeric amount in major units (12.99, not 1299). Null if unparseable.
price.currencystring | nullalwaysISO-4217 where TikTok gives one. Null means we will not guess.
price.formattedstring | nullalwaysExactly what TikTok displayed, e.g. "$12.99".
originalPriceobjectalways
originalPrice.amountnumber | nullalwaysNumeric amount in major units (12.99, not 1299). Null if unparseable.
originalPrice.currencystring | nullalwaysISO-4217 where TikTok gives one. Null means we will not guess.
originalPrice.formattedstring | nullalwaysExactly what TikTok displayed, e.g. "$12.99".
imageUrlsstring[]always
ratingnumber | nullalwaysStar rating out of 5. Null on a product with no reviews yet.
reviewCountnumber | nullalways
soldCountnumber | nullalways
inStockboolean | nullalways
sellerIdstring | nullalways
sellerNamestring | nullalways
categoryNamestring | nullalways
fetchedAtstringalways

Cost and behaviour

Credits1 per live request, 0 on a cache hit
Cacheableyes: cache_max_age accepts a cached copy
Batchableyes: usable as a target in POST /v1/jobs/batch
Subscribableno

Other TikTok endpoints

All TikTok endpointsThe unified schema