TikTok Shop Search API

What is the TikTok Shop Search API?

Search TikTok Shop by keyword and get products as clean JSON: id, url, title, price + originalPrice + discountPercent + savingsAmount, currency (only when an amount exists), sold when the PDP exposes a per-product figure, rating + reviews (always keyed; null when the PDP has no score yet), image, and seller{id,name,url}. Native search is a single SERP window (Google/DDG site:tiktok.com/shop/pdp → PDP hydrate) — Shop search HTML is WAF-gated, so this is not TikTok's full catalog and there is no cursor. limit equals windowMax: default 10, max 10 (Google's first-page organic PDP links). Asking for more than 10 is a 422. The envelope names the yield: requested, totalReturned, serpHits, windowMax=10, hydrateFailures (SERP ids that did not become a priced row), hasMore (true only when you sliced below the 10-cap — raise limit, do not pass a cursor), windowKind (serp-pdp, or extended when the native SERP missed and the scraper tier served — matching the source vocabulary, no vendor names), and truncatedReason=serp-window when the window is exhausted. timings{serpMs,hydrateMs,totalMs} show where the seconds went. top-level region is an echo of the region query param you sent (default US) — market selection, not a creator country and not AI-inferred. price is the SERP promo-min (priceBasis=serp-promo-min) — a different promo tier than Product Details' pdp-promo-min on the same product. sold is a list-row field here and on Shop Products; Product Details omits it. Flat 2 credits per call. Pass cache=true for the 24h shared cache.

What you get

• rating + reviews always keyed on every hit
• originalPrice + discountPercent + savingsAmount (typed; no display strings)
• Honest envelope: requested / serpHits / windowMax=10 / hydrateFailures / hasMore
• seller{id,name,url}
• region = request param echo (not AI / no regionSource)
• Flat 2 credits

Fill in the parameters below and copy a ready-to-run request, or open the live Playground to run it against your account (no API key paste).

curl "https://api.captapi.com/v1/tiktok-shop/shop-search?q=phone%20case" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

Example response

{
  "success": true,
  "data": {
    "query": "phone case",
    "region": "US",
    "totalReturned": 2,
    "products": [
      {
        "platform": "tiktok_shop",
        "id": "1732313842426745420",
        "url": "https://shop.tiktok.com/us/pdp/plum-polka-dot-cute-phone-case-for-iphone-x-17-tough-stylish/1732313842426745420?source=product_detail&enter_method=url_semantic_301",
        "title": "Plum Polka Dot Cute Phone Case for iPhone - Durable & Stylish",
        "price": 12.68,
        "originalPrice": 21.2,
        "currency": "USD",
        "discount": "40%",
        "sold": 532,
        "image": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/db875350dd404f64bb4b6bc79ae26a09~tplv-fhlh96nyum-crop-webp:1290:1290.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
        "seller": {
          "id": "7495626050433419852",
          "name": "Anthony Z Sierra Store",
          "url": "https://www.tiktok.com/shop/store/Anthony%20Z%20Sierra%20Store/7495626050433419852"
        },
        "rating": 4.8,
        "reviews": 2493,
        "savings": null
      },
      {
        "platform": "tiktok_shop",
        "id": "1731098552908944370",
        "url": "https://shop.tiktok.com/us/pdp/trendy-pink-ed-hardy-tough-phone-cases-impact-resistant-wireless-charging-shock-absorption/1731098552908944370?source=product_detail&enter_method=url_semantic_301",
        "title": "Trendy Pink Ed Hardy Inspired Tough Phone Cases, Phone Durable, Gift, Accessories Top Trendy Phone Cases Phone Cover Hard Case Tough 2-piece Phone Case",
        "price": 22.54,
        "originalPrice": 24.09,
        "currency": "USD",
        "discount": "6%",
        "sold": 512,
        "image": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/cc79ccfd6a324d548de31cb761b6c3c4~tplv-fhlh96nyum-crop-webp:794:794.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=e1be8f53&idc=useast5&from=2378011839",
        "seller": {
          "id": "7496126292994264050",
          "name": "Timeless Teapot Creations",
          "url": "https://www.tiktok.com/shop/store/timeless-teapot-creations/7496126292994264050"
        },
        "rating": 4.6,
        "reviews": 48,
        "savings": "Saving $1.55"
      }
    ]
  }
}

Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Source. Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.

Response structure

A successful call returns success and a data object with the following fields:

Parameters

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 2 credits. Pass cache=true for a free 24h cache hit; default is always fresh.

How it works

1. 1. Sign up — get 100 free credits, no card required.
2. 2. Create a key from your dashboard.
3. 3. Send one request to /v1/tiktok-shop/shop-search and parse the JSON response.

Use cases

Frequently asked questions

More TikTok Shop APIs