How to run a TikTok Shop shop search
GET request to /v1/tiktok-shop/shop-search with your input. You get clean JSON back in seconds for 2 credits per call — no OAuth, scraping or platform SDKs. TikTok Shop keyword search — priced products with sold, rating/reviews, originalPrice/discount, seller id.How to run a TikTok Shop shop search (step by step)
- 1
Get a free API key
Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.
- 2
Call the TikTok Shop Search API
Send an authenticated GET request to /v1/tiktok-shop/shop-search with your input. No OAuth, no scraping setup.
- 3
Read the JSON response
Parse the clean JSON response. Pass cache=true for a free 24h cache hit; default is always fresh.
Code example
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_..."What the response looks like
{
"success": true,
"data": {
"query": "phone case",
"region": "US",
"totalReturned": 5,
"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 (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
| q | string | Yes | Product search query (min 2 characters), e.g. phone case. |
| region | string | No | Two-letter market region for the search (default US). Echoed on the response as data.region — not a creator home country. |
| limit | integer | No | Max items to return (default 20, max 200). Flat 2 credits per call. |
| cache | boolean | No | Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. |
Frequently asked questions
What does the TikTok Shop Search API do?
The TikTok Shop Search API lets you search and return matching results from a public TikTok Shop query using one GET request to /v1/tiktok-shop/shop-search. It returns clean JSON — no OAuth or infrastructure setup required.
How many credits does the TikTok Shop Search API cost?
Each successful call costs 2 credits. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Failed or empty results are never charged.
Do I need a TikTok Shop API key or OAuth?
No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle proxies, rate limits, retries, and authentication for you.
Is the TikTok Shop Search API suitable for production use?
Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Use it for analytics, monitoring, and content automation.
Ready to run a TikTok Shop shop search?
Start free with 100 credits — no credit card required.
Get your free API key