InsightSocial APISearch › Suggestions
Returns the autocomplete suggestions TikTok's own search box shows for a partial query, as a list of suggestion rows.
Use it for keyword research, or to expand a seed term before running search or search/top.
20 credits per call.
Re-running the exact same call within 1h is free.
Authorization
apiKey Your key from the dashboard. It starts with isk_.
In: header
Query Parameters
Partial search query to autocomplete.
ISO 3166-1 alpha-2 country code to localize suggestions.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/tiktok/search/suggestions?query=string"{ "success": true, "platform": "instagram", "endpoint": "/v1/instagram/profile/posts", "data": { "items": [ "…" ], "dropped": 0 }, "pagination": { "next_cursor": "is2.eyJwIjoyfQ", "has_more": true, "page_size": 12 }, "credits_used": 20, "credits_remaining": 9980, "request_id": "req_1a2b3c4d5e6f", "cached": false, "idempotent_replay": false, "charge_reason": "miss", "free_call": false}Search › Music GET
Returns TikTok sounds matching a keyword, each with title, artist, duration, cover art, a preview audio URL, and how many videos use it. Use it to size a sound trend, or to join a TikTok sound to Apple Music, Spotify and Amazon through the store ids on ext.dsp_ids. **20 credits** per call. Re-running the exact same call within 1h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).
Search › Top GET
Returns the videos TikTok ranks highest for a keyword on its Top tab, each with caption, author, engagement counts, a music id, and post.ext.region (the country the video is registered to). Use it for TikTok's own relevance ranking. region= only sets the proxy; filter on post.ext.region for one country. search/users returns accounts, which this endpoint does not include. **20 credits** per call. Re-running the exact same call within 1h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).