Product research on TikTok Shop starts with three questions: what is selling in a market, what sits inside a category, and what shoppers type when they search. SocQ already returned product search, store catalogs, product pages, reviews and creator showcases; 7 Best TikTok Shop APIs and Scrapers compares those. On 2026-11-17 four endpoints were added to the TikTok Shop platform page to answer the three questions directly.
This guide covers what each endpoint returns, the request, the price, and how to chain them into a category sweep.
Quick answer: Send a JSON body to
POST https://api.socq.ai/v1/tiktok-shop/<endpoint>. Save the returnedtask_id, pollGET /v1/tasks/{task_id}untilstatusissucceeded, then readdata.results.items.
The New TikTok Shop Endpoints
1 SocQ credit = $0.005.
| Endpoint | What it returns | Price |
|---|---|---|
| TikTok Shop Hot Products API | Hot-selling products of a market, in TikTok Shop's order, with price, units sold, rating and shop | 0.5 credits ($0.0025) per product |
| TikTok Shop Categories API | The full category tree of a market, one row per category with ID, level and parent | 0.5 credits ($0.0025) per call |
| TikTok Shop Category Products API | Products in one category with price, units sold, rating, reviews and shop | 0.5 credits ($0.0025) per product |
| TikTok Shop Search Suggestions API | Up to 20 search completions for the start of a query, ranked | 0.5 credits ($0.0025) per call |
Supported Markets
| Endpoint | region values | Default |
|---|---|---|
| Hot Products | ID, JP, MX, MY, PH, SG, TH, VN | none, required |
| Categories, Category Products, Search Suggestions | US, SG, MY, PH, TH, VN, ID, JP, MX | US |
Hot Products does not list US. For US product research, use Categories and Category Products.
Authentication and the Async Task Flow
All requests authenticate with an API key. The same header is used for submit, task status and result requests:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Every collection runs as a background task:
submit -> task_id -> queued -> running -> succeeded
\-> failed
The submit call returns immediately with data.task_id and data.status. Poll the task with that ID:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
When status is succeeded, the response includes result_count, credits_amount and the first page of normalized records in data.results.items. limit defaults to 50 and goes up to 500. If results.has_more is true, pass results.next_cursor as cursor to read the next page. A failed task carries error_message.
Each endpoint also accepts an optional callback_url. SocQ sends one POST with a task summary when the task finishes; read the records from the task endpoint. A client-side timeout does not cancel a task, so resume with the same task ID instead of submitting again. A 402 means the account is out of credits, and a 429 means the key hit a rate or credit limit.
Hot Products: What Is Selling in a Market
The Hot Products API returns a market's hot-selling products in the order TikTok Shop ranks them. Each product has its title, price (amount, currency and formatted string), sold_count, rating, reviews_count, seller and images, plus the product page url. region is required. results_limit defaults to 50 and accepts 1 to 200. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok-shop/hot-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"region": "MY", "results_limit": 50}'
When to use it: a weekly snapshot per market to spot breakout products, benchmark prices, or pick products to source and promote. Prices come back in the local currency, such as MYR for Malaysia, so convert before you compare markets.
Categories: The Full Category Tree
The Categories API returns every category of a market in one call. Each row has the category id, name, English slug, level, parent_id, is_leaf, path (the names above it), cover_url and region. Top-level categories have parent_id: null and level: 1, so you can rebuild the hierarchy as a tree or keep it as a flat lookup table. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok-shop/categories" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"region": "US"}'
When to use it: once per market, then cache the result. You need the IDs for Category Products, and the tree is useful for mapping TikTok Shop categories to your own catalog.
Category Products: Browse a Category Like a Shopper
The Category Products API takes a numeric category_id from the Categories API and returns that category's products with title, price, units sold, rating, reviews, shop and images. region defaults to US. results_limit defaults to 30 and accepts 1 to 500. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok-shop/category-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"category_id": "601450", "region": "US", "results_limit": 30}'
When to use it: to compare price bands between subcategories, or to watch how a category's best sellers change over time.
Search Suggestions: What Shoppers Type
The Search Suggestions API takes the start of a shopping search in query and returns up to 20 completions, ranked from 1, in the order TikTok Shop suggests them. Each row has the keyword, the query you sent, its rank and the region. region defaults to US. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok-shop/search-suggestions" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "phone case", "region": "US"}'
When to use it: keyword research for listings, ads and content. For phone case, the top completion in the docs example is phone cases 17 pro max, which shows the device models shoppers are buying for. Feed the completions into TikTok Shop Search to see which products rank for each one.
A Category Sweep in Three Calls
A typical research run for one market:
- Call Categories once for the market and store the tree (0.5 credits).
- Pick the leaf categories you care about (
is_leaf: true) and call Category Products for each. - Call Search Suggestions with the core product words of each category to see how shoppers phrase their searches.
Ten categories at 30 products each is 300 products, or 150 credits. Add the tree (0.5) and ten suggestion calls (5) and the run costs 155.5 credits, about $0.78. In a market Hot Products supports, a 50-product snapshot adds 25 credits ($0.125).
Read the Fields Carefully
Product rows use the same normalized shape across the three product endpoints. Like other SocQ fields, a value the source does not provide is null, not 0. In the docs examples, rating, reviews_count and sold_count are null for the products shown, so treat missing sales or ratings as unknown, not as zero, before you rank products by them.
To go deeper on a single product, pass its url to the TikTok Shop Product API, which currently serves the US region only, and to the Product Reviews API. For other ways to get TikTok Shop data, see TikTok Shop API Alternatives. Products sold during LIVE streams are covered by the TikTok Live Shopping API in the new TikTok endpoints guide.
FAQ
Does this need a TikTok Shop seller or partner account?
No. The endpoints read public TikTok Shop data, and you authenticate with a SocQ API key.
Why does Hot Products reject US?
US is not one of its region values. Hot Products covers ID, JP, MX, MY, PH, SG, TH and VN. The other three endpoints support US and use it by default.
Where do category IDs come from?
From the Categories API. Each row's id is the category_id that Category Products takes, for the same region.
How is each endpoint billed?
Categories and Search Suggestions cost 0.5 credits per call, however many rows they return. Hot Products and Category Products cost 0.5 credits per product returned.
How many suggestions does one query return?
Up to 20, ranked from 1 in TikTok Shop's order.
TIKTOK SHOP API
Test the workflow with a public TikTok Shop URL
Submit public inputs and receive normalized records with traceable source context.
Explore TikTok Shop APIs