TikTok Shop Search Suggestions
TikTok Shop Search Suggestions are the completions the shop search box offers as a shopper types, each a full keyword phrase with its position in the list and the market it was suggested in. Because they come from what people actually search, these phrases surface product variants, compatible models and buying angles to target in listing titles, ads and content.
TikTok Shop Search Suggestions API Features
- Completions for a partial searchquery takes the opening words of a search, such as phone case, and each row returns a longer phrase shoppers complete it to, such as phone cases 17 pro max.
- TikTok Shop's own suggestion orderIn the TikTok Shop Search Suggestions API, rank numbers the suggestions from 1 in the order TikTok Shop shows them, with up to 20 per query.
- Suggestions per marketregion selects one of US, SG, MY, PH, TH, VN, ID, JP and MX, defaulting to US, and every row repeats its query and region so results stay traceable.
TikTok Shop Search Suggestions API Parameters
| Parameters | Required | Description |
|---|---|---|
query | Required | The start of a shopping search to complete, such as phone case. |
region | Optional | Search market: US, SG, MY, PH, TH, VN, ID, JP or MX. Defaults to US. |
How to Use the TikTok Shop Search Suggestions API
Send the opening words of a shopping search to the TikTok Shop Search Suggestions API and read the completions in rank order.
- POST {"query": "phone case", "region": "US"} to /v1/tiktok-shop/search-suggestions.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- Read keyword and rank from results.items; when has_more is true, fetch the remainder with results.next_cursor.
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"}'TikTok Shop Search Suggestions API Use Cases
- Choosing listing title keywords: Pick keyword phrases that name models, sizes or variants and work them into product titles and descriptions.
- Building ad and content keyword sets: Collect the keyword column across several seed queries to assemble keyword lists for ads, video captions and content planning.
- Tracking how suggestions shift: Re-run the same query and region over time and compare rank per keyword to see which phrases rise, fall or newly appear.
- Comparing how markets finish a search: Send one query to the TikTok Shop Search Suggestions API for several regions and set the keyword lists side by side to see how shoppers in each market complete the same words.
TikTok Shop Search Suggestions API Pro Tips
- Seed the TikTok Shop Search Suggestions API with a short stem rather than a full phrase, because suggestions extend the start of the query and a long phrase leaves little to complete.
- Go one level deeper by sending a returned keyword back as a new query, which turns one seed into a tree of longer phrases.
- Deduplicate results from several seeds on keyword, which is also the row id, since related stems can return the same phrase.
- Pass a promising keyword to TikTok Shop Search with the same region to see the products behind that suggestion.
Related APIs
Beyond the TikTok Shop Search Suggestions API, use these APIs when you need a different type of public TikTok Shop data.
- TikTok Shop Search API — Search public TikTok Shop products by keyword and market region with seller, price, media, rating, review, and sold-count fields.
- 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 Hot Products API — Collect a TikTok Shop market's hot-selling products by region code, in ranking order, with price, currency, units sold, rating and shop.
- TikTok Shop Categories API — Retrieve the full category tree of a TikTok Shop market with category IDs, names, English slugs, levels, parents and paths.