TikTok Search Suggestions Scraper: a-z, questions, CSV/JSON

TikTok search-box suggestions as CSV/JSON rows. Give it seed keywords; it requests the suggestions TikTok shows as a user types, for the seed, seed + a to z, question words, and prepositions (comparisons and numbers only if you enable those expansions), for the region and language you set. One flat row per unique suggestion per seed, each with a stable id. $0.25 per 1,000 rows.

This is not video scraping, not profile scraping, and not hashtag stats. It does not return video IDs, captions, view counts, follower counts, or challenge/hashtag metrics. It is the dropdown list from TikTok's search box, nothing else.

Same engine, other search boxes: Google, YouTube, Amazon, Bing, DuckDuckGo, Etsy, Pinterest. Same input shape, same flat rows, one run per engine.

What you get

Field	Example
id	stable per seed, region, language, query and suggestion
keyword	makeup (your seed)
query	makeup (the exact string sent)
suggestion	makeup tutorials
rank	1 (position in TikTok's list for that query)
expansion	direct, alphabet, question, preposition, comparison, number, depth
modifier	b, how, for, vs
depth	1 or 2
hotLevel	TikTok's hot_level flag, or null
ecomIntent	TikTok's ecom_intent flag, or null
language, region	en, us
engine	tiktok
fetchedAt	ISO timestamp

Rows are deduplicated per seed (case-insensitive), so a suggestion that appears under several modifiers is counted once, under the first query that produced it.

Want the file instead of running the actor? A keyword list from live autocomplete for your seeds is $10, made to order, at https://tallyrake.com/files (CSV and XLSX by email within 24 hours of your order details).

Example input

{
  "keywords": ["makeup"],
  "expansions": ["alphabet", "questions", "prepositions"],
  "depth": 1,
  "language": "en",
  "region": "us",
  "proxyConfiguration": { "useApifyProxy": true }
}

Paste seeds one per line. The default expansions send 52 queries per seed (1 seed + 26 letters + 14 question words + 11 prepositions = 52). Comparisons and numbers are not in that 52; they are extra expansions. One seed is not one billable unit: you are billed unique dataset rows, not queries.

Proxy defaults to Apify Proxy with no proxy group (datacenter). TikTok localises suggestions by exit IP as well as the region parameter; pin a country on the proxy for a genuine other market.

Recipes

Content brief for one topic. Seeds: your topic. Expansions: questions, prepositions. Depth 1. Output: the questions and phrasings TikTok suggests for the topic, each with the engine rank on the query that first produced it (dedup keeps the first hit, not a single global order).

Keyword list for a niche. Seeds: 10 to 50 head terms. Expansions: alphabet. Depth 2. TikTok returns about 10 suggestions per query, and maxQueriesPerKeyword (default 300) caps the requests per seed, so one seed can produce at most 3,000 dataset rows before dedup (at most $0.75 at $0.25 per 1,000). Empty queries bill $0. Start at concurrency 3; the log shows 429 or 403 when a proxy or a split is needed.

Localized suggestions. Same seeds, language and region set per run. Rows carry both codes so runs can be merged. For a market that is not the run's own IP, enable Apify Proxy and pin that country.

Brand and competitor monitoring. Seeds: brand names. Expansions: comparisons, questions. Schedule daily. Diff the suggestion column between runs.

Reliability and cost

Pay per event: $0.25 per 1,000 dataset rows, plus Apify platform usage for the run. Empty queries produce no rows and no results charge. Every request is paced with a jittered delay (pacingMs, default 200 ms). If the engine answers 429 or 403, the run rotates its session and retries.

No soaked run has been measured on Apify yet, so this README does not state a success rate or a platform-usage cost.

Cost limit

If a run reaches the "Maximum total charge per run" you set, it stops in process rather than being aborted by the platform: the run ends with status SUCCEEDED, and the run status message on the run detail says how many rows were written and how many were found but not written and not billed. Re-running the same input writes and bills the same prefix again, so raise the cap before re-running if you want the rest.

Bigger jobs

Running thousands of TikTok keywords, or need this as a one-off file instead of a run? We build custom exports — any keywords, countries and date ranges, delivered as flat CSV or JSON within 24 hours: https://tallyrake.com/datasets/

Limits

This is TikTok's suggestion list for the region and language you set, at the time of the run. It carries no search volume. TikTok returns about 10 suggestions per query. Export CSV for Excel and Google Sheets. Export JSON for pipelines.

It is not a video scraper, not a profile scraper, and not a hashtag-stats scraper. It does not log in, does not download media, and does not walk search-result pages.

Where this sits on the shelf

Apify Store, read 2026-10-15. This actor is not published; the $0.25 per 1,000 rows figure above is the placeholder price, and the maintainer sets pay-per-result on the Store. Nothing in this build charges a custom event. One default dataset row is one result.

Listing	Users (30d)	Total users	Price per 1,000 rows
memo23/tiktok-suggestions-scraper	30	80	$2.00
tallyrake/tiktok-autocomplete-scraper (this actor)	0	0	$0.25