# TikTok Search Suggestions API. Suggestions matching your search. Search box autocomplete for a partial query. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dtiktok.search_suggestions) ## TikTok Search Suggestions API at a glance Returns the searches TikTok's search box completes a partial query to, in TikTok's order, from a word, part of a word or a name. Each suggestion has its text, rank, language, TikTok's predicted click rate and a link to its results. An account TikTok proposes comes with its user ID, username, display name, picture and verified badge. Set country to get what people there search. GET `/v1/tiktok/search_suggestions` [Read the API reference](https://socialtap.dev/docs/reference/tiktok/search_suggestions/index.md) - **1 credit** per page, $0.75–$1.97 per 1,000 pages - **9 typed fields** null when unknown - **20** suggestions per page, TikTok's search box order (most likely search first) - **`query`** is all it needs, e.g. `cook` ## Send one request. Get up to 20 suggestions back. Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free. `$ npm install socialtap` `query = cook` [Open in playground](https://socialtap.dev/playground/?endpoint=tiktok.search_suggestions) cURL: ```shell curl 'https://socialtap.dev/v1/tiktok/search_suggestions?query=cook' \ -H "x-api-key: $SOCIALTAP_API_KEY" ``` TypeScript SDK: ```typescript import { SocialTap } from "socialtap"; const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY const res = await client.tiktok.searchSuggestions.list({ query: "cook" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ query: "cook", }); const res = await fetch(`https://socialtap.dev/v1/tiktok/search_suggestions?${params}`, { headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" }, }); const body = await res.json(); if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`); const { data, page, meta } = body; console.log(data, meta.credits_charged); ``` Python (requests): ```python import os import requests res = requests.get( "https://socialtap.dev/v1/tiktok/search_suggestions", params={"query": "cook"}, headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]}, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}") data, page, meta = body["data"], body["page"], body["meta"] print(data, meta["credits_charged"]) ``` Go (net/http): ```go package main import ( "encoding/json" "fmt" "log" "net/http" "net/url" "os" ) func main() { q := url.Values{} q.Set("query", "cook") req, err := http.NewRequest("GET", "https://socialtap.dev/v1/tiktok/search_suggestions?"+q.Encode(), nil) if err != nil { log.Fatal(err) } req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var body struct { Data json.RawMessage `json:"data"` Page json.RawMessage `json:"page"` Meta map[string]any `json:"meta"` Error *struct { Code string `json:"code"` Message string `json:"message"` } `json:"error"` } if err := json.NewDecoder(res.Body).Decode(&body); err != nil { log.Fatal(err) } if body.Error != nil { log.Fatalf("%s: %s", body.Error.Code, body.Error.Message) } fmt.Println(string(body.Data), body.Meta["credits_charged"]) } ``` 200 OK: ```json { "data": [ { "approximate_fields": [], "hashtag": null, "platform": "tiktok", "platform_specific": { "tiktok": { "language": "en", "score": 0.0033766124 } }, "position": 0, "profile": null, "text": "cooking big hyatt", "type": "query", "unknown_fields": [], "url": "https://www.tiktok.com/search?q=cooking+big+hyatt" }, { "approximate_fields": [], "hashtag": null, "platform": "tiktok", "platform_specific": { "tiktok": { "language": "en", "score": 0.025226826 } }, "position": 1, "profile": null, "text": "cooking with kya", "type": "query", "unknown_fields": [], "url": "https://www.tiktok.com/search?q=cooking+with+kya" }, { "approximate_fields": [], "hashtag": null, "platform": "tiktok", "platform_specific": { "tiktok": { "language": "en", "score": 0.0131212715 } }, "position": 2, "profile": null, "text": "cooking food videos", "type": "query", "unknown_fields": [], "url": "https://www.tiktok.com/search?q=cooking+food+videos" } ], "page": { "has_more": false, "next_cursor": null, "next_cursor_expires_at": null, "end_reason": "platform_limit" }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "tiktok", "source": "api", "is_cached": false, "credits_charged": 1, "latency_ms": 0, "fetched_at": "2026-10-25T12:00:00Z", "input": null, "credits_remaining": 9999, "client_request_id": null, "warnings": [] } } ``` Long arrays and strings are shortened here. Real responses are complete. ## One schema on 3 platforms. The [response reference](https://socialtap.dev/docs/reference/tiktok/search_suggestions/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/suggestion/index.md). - ### Null means unknown A field TikTok doesn't show is null, never zero or an empty string, so a real zero always means zero. - ### What it accepts The start of a search, as typed into TikTok's search box: a word, part of a word, a name or a username, in any language (cook, taylor sw, 料理). - ### Write one parser TikTok, Instagram and Google Ads Transparency Center answer in these fields, so the code that reads one reads them all. - **`platform`string**: Platform whose search box offers the suggestion. - **`text`string**: The suggestion as the platform shows it, whitespace-trimmed: the completed search for a query suggestion, the account's name for a profile one, the domain for a website one. - **`type`string**: query = a completed search to run; profile = an account (or community) the platform proposes, described in profile; hashtag = a hashtag, described in hashtag; website = a website the platform proposes: text is its domain (nike.com), as the platform's searches by website take it. New values may be added. - **`position`integer**: Zero-based rank of the suggestion in the list, counting every type: the platform's order (each endpoint's notes say how a list combining several of the platform's searches is ordered). - **`url`string**: Where the suggestion leads on the platform: the search results page for a query, the account's page for a profile, the hashtag's page for a hashtag, the platform's page for the website for a website. - **`profile`object**: The account a profile suggestion names; null for every other type. - **`hashtag`object**: The hashtag a hashtag suggestion names, keyed as the platform's hashtag endpoints key it; null for every other type. - **`approximate_fields`string\[\]**: JSON paths of values rounded or capped by the platform (hashtag.metrics.post_count at Instagram's ceiling). \[\] when all exact. Live data from 33 platforms. [TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md) ## What teams build with the TikTok Search Suggestions API. - ### Find the long-tail keywords people search on TikTok - ### Build keyword lists for TikTok SEO and ads - ### Compare what each country searches for a word - ### Resolve a creator's name to their account - ### Add TikTok autocomplete to your own search box ## Good to know before you build. - TikTok serves one list per query. A full list ends with page.end_reason platform_limit, a shorter one with end. - An account suggestion has type profile and the account in profile. Its text is what the search box shows, which can be a display name instead of the username. - platform_specific.tiktok.score is TikTok's predicted click rate, not the order of the list. position is the rank. - Suggestions are the ones TikTok offers people in the country you ask for (the United States by default), in whatever language you type. - country takes the countries where TikTok's answers were checked to be that country's own. Any other code is invalid_input. - The answer carries no country, so a list can in rare cases be another country's. - Capitals and a leading # or @ are sent as typed and can change the order. - A query made only of punctuation, or one TikTok withholds suggestions for (a sensitive term), returns an empty page. A query with no visible character is invalid_input. - profile.avatar_url is a CDN link that expires. ## 1 credit per page. Failed requests are free. Buy credits once and spend them on any endpoint, on any platform. [Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/tiktok/search_suggestions/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful page | Per 1,000 pages | | --- | --- | --- | | Platform API `api` | 1 credit | $0.75–$1.97 | - Cache hits are free. - Credits from packs and top-ups never expire. - A monthly plan's credits are spent first, and what is left of them ends at each renewal. - Prices exclude tax: sales tax is added at checkout where it applies. - Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID. ## Questions about the TikTok Search Suggestions API. More in the [API reference](https://socialtap.dev/docs/reference/tiktok/search_suggestions/index.md). **How much does the TikTok Search Suggestions API cost?** A page of up to 20 suggestions costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. **How do I get the next page?** Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 24 hours. Other platforms ## Suggestions on 2 more platforms. - [Instagram Search Suggestions API](https://socialtap.dev/apis/instagram/search_suggestions/index.md) (1 credit / page · `GET /v1/instagram/search_suggestions`) - [Google Ads Transparency Center Search Suggestions API](https://socialtap.dev/apis/google/search_suggestions/index.md) (1 credit / page · `GET /v1/google/search_suggestions`) More TikTok ## TikTok API. 31 endpoints, one key. - [TikTok Post API](https://socialtap.dev/apis/tiktok/post/index.md) (1 credit · `GET /v1/tiktok/post`) - [TikTok Posts API](https://socialtap.dev/apis/tiktok/posts/index.md) (1 credit / page · `GET /v1/tiktok/posts`) - [TikTok Search API](https://socialtap.dev/apis/tiktok/search_posts/index.md) (1 credit / page · `GET /v1/tiktok/search_posts`) - [TikTok Top Videos API](https://socialtap.dev/apis/tiktok/top_posts/index.md) (1 credit / page · `GET /v1/tiktok/top_posts`) - [TikTok Liked Posts API](https://socialtap.dev/apis/tiktok/liked_posts/index.md) (1 credit / page · `GET /v1/tiktok/liked_posts`) - [TikTok Place Posts API](https://socialtap.dev/apis/tiktok/place_posts/index.md) (1 credit / page · `GET /v1/tiktok/place_posts`) - [TikTok Sound Posts API](https://socialtap.dev/apis/tiktok/sound_posts/index.md) (1 credit / page · `GET /v1/tiktok/sound_posts`) - [TikTok Effect Posts API](https://socialtap.dev/apis/tiktok/effect_posts/index.md) (1 credit / page · `GET /v1/tiktok/effect_posts`) - [TikTok Hashtag Posts API](https://socialtap.dev/apis/tiktok/hashtag_posts/index.md) (1 credit / page · `GET /v1/tiktok/hashtag_posts`) - [TikTok Playlist Posts API](https://socialtap.dev/apis/tiktok/playlist_posts/index.md) (1 credit / page · `GET /v1/tiktok/playlist_posts`) - [TikTok Trending Videos API](https://socialtap.dev/apis/tiktok/trending_posts/index.md) (1 credit / page · `GET /v1/tiktok/trending_posts`) - [TikTok Profile API](https://socialtap.dev/apis/tiktok/profile/index.md) (1 credit · `GET /v1/tiktok/profile`) - [TikTok Followers API](https://socialtap.dev/apis/tiktok/followers/index.md) (1 credit / page · `GET /v1/tiktok/followers`) - [TikTok Following API](https://socialtap.dev/apis/tiktok/following/index.md) (1 credit / page · `GET /v1/tiktok/following`) - [TikTok Comment API](https://socialtap.dev/apis/tiktok/comment/index.md) (1 credit · `GET /v1/tiktok/comment`) - [TikTok Comments API](https://socialtap.dev/apis/tiktok/comments/index.md) (1 credit / page · `GET /v1/tiktok/comments`) - [TikTok Comment Replies API](https://socialtap.dev/apis/tiktok/replies/index.md) (1 credit / page · `GET /v1/tiktok/replies`) - [TikTok Transcript API](https://socialtap.dev/apis/tiktok/transcript/index.md) (From 1 credit · `GET /v1/tiktok/transcript`) - [TikTok Hashtag API](https://socialtap.dev/apis/tiktok/hashtag/index.md) (1 credit · `GET /v1/tiktok/hashtag`) - [TikTok Trending Hashtags API](https://socialtap.dev/apis/tiktok/trending_hashtags/index.md) (1 credit / page · `GET /v1/tiktok/trending_hashtags`) - [TikTok Top Search API](https://socialtap.dev/apis/tiktok/search_top/index.md) (From 1 credit / page · `GET /v1/tiktok/search_top`) - [TikTok User Search API](https://socialtap.dev/apis/tiktok/search_profiles/index.md) (From 1 credit / page · `GET /v1/tiktok/search_profiles`) - [TikTok Sound Search API](https://socialtap.dev/apis/tiktok/search_sounds/index.md) (From 1 credit / page · `GET /v1/tiktok/search_sounds`) - [TikTok Hashtag Search API](https://socialtap.dev/apis/tiktok/search_hashtags/index.md) (From 1 credit / page · `GET /v1/tiktok/search_hashtags`) - [TikTok Playlists API](https://socialtap.dev/apis/tiktok/playlists/index.md) (1 credit / page · `GET /v1/tiktok/playlists`) - [TikTok Engagement API](https://socialtap.dev/apis/tiktok/engagement/index.md) (1 credit · `GET /v1/tiktok/engagement`) - [TikTok Live API](https://socialtap.dev/apis/tiktok/live/index.md) (1 credit · `GET /v1/tiktok/live`) - [TikTok Sound API](https://socialtap.dev/apis/tiktok/sound/index.md) (1 credit · `GET /v1/tiktok/sound`) - [TikTok Download API](https://socialtap.dev/apis/tiktok/download/index.md) (1 credit · `GET /v1/tiktok/download`) - [TikTok Effect API](https://socialtap.dev/apis/tiktok/effect/index.md) (1 credit · `GET /v1/tiktok/effect`) ## Try it with your own search. Type it in the playground, or copy the request into your code. 100free credits - No credit card - Failed requests are free - Works on all 218 endpoints [Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md) --- [HTML version](https://socialtap.dev/apis/tiktok/search_suggestions/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)