TikTok Shop Search
TikTok Shop Search results are public products matched to a keyword in a selected market, with product and seller identity, prices, images, ratings, review counts, and sold counts. These commerce records support regional product discovery, price comparison, seller research, and repeatable market snapshots.
Features
- Keyword and market controlPair a product query with one of 16 supported region values to search the intended public market catalog.
- Bounded unique collectionRequest 20 through 2,000 results while collection pages are deduplicated by public product identity.
- Product and seller identityReturn product IDs, titles, descriptions, canonical links, and exposed seller or shop details.
- Prices and visible commerce signalsPreserve sale price, original price, currency, discount, rating, review count, and sold count when exposed.
- Media and product contextKeep public images, categories, SKU structures, status, search query, region, and collection time with each record.
Parameters
| Parameters | Required | Description |
|---|---|---|
query | Required | Required non-empty product keyword or phrase. |
results_limit | Optional | Requested unique result cap from 20 through 2,000. Defaults to 100. |
region | Optional | Market region: US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, or IE. Defaults to US. |
How to Use
Choose a concrete product phrase and market, then submit one asynchronous search request.
- Set a non-empty query, choose a supported region, and set results_limit from 20 through 2,000.
- POST the request to /v1/tiktok-shop/search and save the returned task_id.
- Poll /v1/tasks/{task_id} until the task reaches succeeded or failed.
- Read data.results.items. When has_more is true, continue with next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"running shoes","results_limit":100,"region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueBest Use Cases
- Regional product discovery: Map public products matching a category, need, brand, or product phrase in a selected market.
- Price and discount comparison: Compare available sale price, original price, currency, and discount fields across returned products.
- Reputation and demand comparison: Compare exposed ratings, review counts, and sold counts without converting missing metrics into zero.
- Product and shop shortlisting: Use product links, seller identity, images, categories, and SKU context to select candidates for deeper review.
Pro Tips
- Always store query and region together because the same phrase can resolve to different public catalogs.
- Set results_limit to the volume you need and follow next_cursor until has_more is false to read the complete task result.
- Treat a missing price, rating, review count, or sold count as unavailable rather than zero.
- Retain search_query and collected_at with every record so regional snapshots remain reproducible.
- Pass a selected PDP URL to the TikTok Shop Product API when you need a fresh detail-level enrichment.
Related APIs
Use these APIs when you need a different type of public TikTok Shop data.
- TikTok Shop Products API — Collect public products from one TikTok Shop store URL with seller, price, media, category, SKU, rating, review, and sold-count fields.
- TikTok Shop Product API — Retrieve one public TikTok Shop product from a PDP URL with seller, price, media, category, SKU, rating, review, and sold-count fields.
- TikTok Shop Product Reviews API — Collect public reviews for one TikTok Shop PDP URL with text, rating, reviewer, image, SKU, country, and purchase-context fields.
- TikTok Shop User Showcase API — Collect public showcase products for one TikTok username with price, seller, media, rating, review, sold-count, and regional context.