# TikTok User Search Scraper (`deepmine/tiktok-user-search`) Actor Find TikTok accounts by keyword, as TikTok's Users search shows them: username, name, followers, total likes, bio, verified badge, avatar and profile link, with each account's rank. Keywords in, clean JSON out. No login. - **URL**: https://apify.com/deepmine/tiktok-user-search.md - **Developed by:** [DeepMine](https://apify.com/deepmine) (community) - **Categories:** Social media, Videos - **Features:** Limited permissions - **Stats:** 13 total users, 8 monthly users, 92.7% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.19 / 1,000 accounts This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## TikTok User Search Scraper **Type a niche, a name or a brand, get the TikTok accounts TikTok's Users search shows for it:** username, display name, followers, total likes, bio, verified badge, photo, profile link and each account's rank. Turn on **Creator details** for following and video counts, join date, bio link and the email in the bio. No login. **$2.29 per 1,000 accounts on the Starter plan ($2.69 Free, $1.79 Scale, $1.19 Business). The prefilled run (100 accounts) costs about $0.23.** Collected 2026-10-27 by the prefilled run (`fitness coach`, 100 accounts, Creator details off, build 0.2.17): 100 accounts, 100 charged, 35 s from start to finish on Apify datacenter proxy at 256 MB. A bio on 84 of 100 (the rest have none on TikTok). One observed run, not a speed promise. **Export:** open the run's **Output** tab and click **Export** (CSV, Excel, JSON, XML or HTML), or read `https://api.apify.com/v2/datasets//items?format=csv` from your code. | Account | πŸ‘€ Name | πŸ“ Bio | πŸ‘₯ Followers | ❀️ Likes | πŸ… Rank | |---|---|---|---:|---:|---:| | [@aleestefaniafitness](https://www.tiktok.com/@aleestefaniafitness) | Aleestefaniafitness | Mis programas de entrenamiento y nutriciΓ³n aquΓ­ πŸ‘‡πŸ» | 2,300,000 | 21,982,134 | 1 | | [@chagaev4xxx20](https://www.tiktok.com/@chagaev4xxx20) | chagaev4xx20 | My official TikTok Account I don't have another Ti… | 3,100,000 | 57,962,155 | 2 | | [@maiahenryfit](https://www.tiktok.com/@maiahenryfit) | maiahenryfit | Strength x Pilates Coach IG: Maiahenryfit NEW SERI… | 2,400,000 | 85,160,470 | 3 | ### Why this one - **Up to ~250 accounts per keyword.** The Actor pages through everything TikTok's Users search shows logged-out visitors (245 for "fitness coach", 254 for "skincare", 255 for "nail artist" on 2026-09-27). - **Lead-list ready.** Follower count, total likes and the full bio come with every account: find contact hints in bios and open profiles with one click. - **Creator details, same price.** Turn on `creatorDetails` and each row also gets following, videos, friends, join date, bio link, the email written in the bio (`email`, `hasEmail`, `hasPhone`), private, TikTok Shop seller and business-account flags, app language and a large photo, from the account's profile page. No extra charge. - **Follower range filter.** Set `minFollowers` / `maxFollowers` (say 10k to 500k) to keep only micro or mid-size creators. Accounts outside the range are skipped and cost nothing. - **Many keywords per run**, each with its own limit and summary. Rows come keyword by keyword, in your order. - **Handles TikTok's picky search.** TikTok answers this search on only some IPs. The Actor tries several fresh IPs at once until one answers, keeps using it for the whole run, and starts your next run on it, so you don't have to. - **Fails loudly, never silently.** Every run saves a per-keyword summary (`OUTPUT`). If TikTok refuses a keyword on every retry, the run is marked failed instead of quietly returning less. ### Input | Field | What it does | Default | |---|---|---| | `keywords` | Search terms, one per line: `fitness coach`, `real estate agent`, `nail artist`. | `fitness coach` | | `maxUsersPerKeyword` | Accounts per keyword, up to 1,000 (TikTok shows up to about 250). With a follower range, it counts the accounts you keep. | 100 | | `creatorDetails` | Also read each account's profile page: following, videos, friends, join date, bio link, email from the bio and more (see Output). Same price; adds about 15 seconds per 100 accounts (41 s instead of 25 s for 100 in our test). | off | | `minFollowers` | Keep only accounts with at least this many followers. `0` = no minimum. | 0 | | `maxFollowers` | Keep only accounts with at most this many followers. `0` = no maximum. | 0 | | `proxyConfiguration` | Apify Proxy. Keep datacenter (the default): the Actor finds IPs TikTok answers on by itself; residential doesn't help here. | Apify datacenter | Example: ```json { "keywords": ["fitness coach", "real estate agent"], "maxUsersPerKeyword": 200 } ``` With a follower range: ```json { "keywords": ["skincare", "nail artist"], "minFollowers": 10000, "maxFollowers": 500000, "maxUsersPerKeyword": 250 } ``` 25 accounts with every column (Creator details on), a quick look before a bigger run: ```json { "keywords": ["fitness coach"], "maxUsersPerKeyword": 25, "creatorDetails": true } ``` | Account | πŸ‘₯ Followers | βž• Following | 🎬 Videos | πŸ“… Joined | 🌐 Bio Link | 🌐 App Language | |---|---:|---:|---:|---|---|---| | [@aleestefaniafitness](https://www.tiktok.com/@aleestefaniafitness) | 2,300,000 | 115 | 116 | 2019-11-17 | https://aleestefania.com/retos | es | | [@maiahenryfit](https://www.tiktok.com/@maiahenryfit) | 2,400,000 | 27 | 5,655 | 2021-04-13 | https://ladder.fit/define | en | | [@coach_nino](https://www.tiktok.com/@coach_nino) | 2,300,000 | 242 | 2,044 | 2018-05-01 | https://linktr.ee/CoachNinofit | en | Collected 2026-10-27 (build 0.2.18, Apify datacenter proxy, 256 MB): 25 accounts, 25 charged ($0.06 on Starter), 24 s from start to finish, the first row after 8 s. 27 columns instead of 14: join date, videos, language and the large photo on 25 of 25, following on 24, friends on 21, a bio link on 19, an email in the bio on 1. With 100 accounts: 41 s, join date on 95 (4 private accounts show nothing), a bio link on 44. One observed run each, not a promise. **A follower range returns fewer rows.** TikTok shows about 250 accounts per keyword, and the range can't add more: the Actor pages through all of them and keeps the ones in range, so a narrow range may give a few dozen accounts, or none. Add more keywords to get more accounts. `rank` stays the account's position in TikTok's full results. An account whose follower count TikTok doesn't send is left out of a range, since it can't be shown to be in it. ### Output One row per account, keyword by keyword in your order, each keyword's accounts in TikTok's order. Table views in the Console: - **πŸ“Š Overview**: πŸ–ΌοΈ Photo, 🏷️ Username, πŸ‘€ Name, πŸ“ Bio, πŸ”— TikTok, βœ”οΈ Verified, πŸ‘₯ Followers, ❀️ Likes, πŸ” Keyword, πŸ… Rank - **πŸ“ˆ Stats**: 🏷️ Username, πŸ”— TikTok, βœ”οΈ Verified, πŸ‘₯ Followers, ❀️ Likes, πŸ” Keyword, πŸ… Rank - **πŸ‘€ Creator Details (Creator details on)**: needs **Creator details** on; without it, only the photo, username and followers columns fill: πŸ–ΌοΈ Photo, 🏷️ Username, πŸ‘₯ Followers, βž• Following, 🎬 Videos, πŸ“… Joined, 🌐 Bio Link, πŸ“§ Email, πŸ“ž Phone, πŸ”’ Private, 🌐 App Language #### Output fields Every row has these keys, in this order; the ones marked "With Creator details" are there only with `creatorDetails` on. A value TikTok didn't send is `null` (never an empty string or a made-up 0); with Creator details, a profile TikTok wouldn't show leaves its columns `null`. - `avatar`: profile picture. - `name`: display name. - `bio`: the full bio, line breaks kept. - `bioSnippet`: the bio's first 50 characters on one line, for tables. - `username`: TikTok username, without @. - `profileUrl`: the profile on TikTok. - `verified`: TikTok's verified badge. - `followers`: followers (TikTok rounds large counts in search results). - `likes`: total likes on all their videos. - `following`: accounts they follow. With Creator details. - `videos`: their public videos. With Creator details. - `friends`: accounts they follow that follow them back. With Creator details. - `joinedAt`: when the account was created (UTC). With Creator details. - `bioLinkUrl`: the link in their bio (often a link-in-bio page or a site). With Creator details. - `email`: the first email address written in their bio. With Creator details. - `hasEmail`: their bio shows an email address. With Creator details. - `hasPhone`: their bio shows a phone number. With Creator details. - `private`: the account is private (TikTok then shows nothing else). With Creator details. - `isSeller`: TikTok marks the account as a TikTok Shop seller. With Creator details. - `isCommerceAccount`: a TikTok business (commerce) account. With Creator details. - `language`: their TikTok app language (`en`, `es`, ...). With Creator details. - `avatarLarge`: their profile picture in the largest size the profile page shows. With Creator details. - `rank`: position in TikTok's results for the keyword. - `keyword`: the search keyword (your input). - `userId`: TikTok's user ID. - `secUid`: TikTok's secUid, the ID its own web API uses. - `scrapedAt`: when it was collected (UTC). Example row: ```json { "avatar": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068...", "name": "Bubble Skincare", "bio": "Built by dermatologists.\nπŸ‡ΊπŸ‡ΈUlta, Walmart, Target, CVS, Amazon\nπŸ‡¬πŸ‡§Boots, ASOS πŸ‡¨πŸ‡¦Shoppers Drug Mart πŸ‡¦πŸ‡ΊPriceline, Woolworths πŸ–€Sephora ME", "bioSnippet": "Built by dermatologists. πŸ‡ΊπŸ‡ΈUlta, Walmart, Target,…", "username": "bubble", "profileUrl": "https://www.tiktok.com/@bubble", "verified": true, "followers": 4100000, "likes": 25806095, "rank": 2, "keyword": "skincare", "userId": "6686777110134309894", "secUid": "MS4wLjABAAAAFWOchAcsCCCbzd_y7DnpY8XB_5aIgPEoCgVvwXuRVIrZi25OEtLVsJNoRBqa49f4", "scrapedAt": "2026-09-27T19:07:59Z" } ``` Notes: - `rank` is the account's position in TikTok's results; with a follower range, accounts left out keep their place, so gaps are normal. - TikTok's search itself shows only followers, likes and the bio. Following, videos, bio link, join date and the rest come from each account's profile page with `creatorDetails` on. - TikTok rounds large follower counts in search (4.1M shows as `4100000`). - **Image links expire.** `avatar` is signed by TikTok and stops working about 2 days after the run. Download the images you need soon after the run. #### Run summary (`OUTPUT`) ```json { "results": 491, "answeringIps": 1, "outage": false, "inputs": [ {"input": "fitness coach", "status": "ok", "results": 245, "stopReason": "end", "keyword": "fitness coach"}, {"input": "nail artist", "status": "ok", "results": 246, "stopReason": "end", "keyword": "nail artist"} ] } ``` With a follower range, each keyword also carries `filteredOut`: the accounts TikTok showed that were outside the range (skipped, not charged). With Creator details, `creatorDetails` counts the profile pages read, private, missing and failed. `savedIps` says how many IPs remembered from your earlier runs were tried and answered (see below). `status` per keyword: `ok`, `no_results` (TikTok shows nothing, or hides results for that term), `invalid`, `blocked` (no IP TikTok answered on after many tries; the run fails so you notice), `stopped` (your spending limit). `stopReason`: `max_results`, or `end` when TikTok showed no more accounts. If TikTok answers user search on none of the IPs the Actor tries (a TikTok outage, for example), the run stops early after about 160 tries instead of retrying every keyword, fails with a clear message and sets `"outage": true` in `OUTPUT`. Keywords it couldn't collect cost nothing; accounts already delivered stay in your dataset. Try again later. ### How long does a run take? The first accounts usually arrive **within about 15 seconds** of starting the run, and within about 10 when the Actor ran in the last 30 minutes: TikTok answers this search on only some IPs, and the Actor remembers the ones that answered (see the FAQ). 100 accounts take about 25 seconds; with Creator details, about a minute (one profile page per account). Several keywords in one run are cheaper and faster than one run per keyword. ### Pricing Pay per result, no start fee and no minimum. Example: 1,000 accounts cost $2.29 on the Starter plan. | Your Apify plan | Per 1,000 accounts | |---|---| | Free | $2.69 | | Starter | $2.29 | | Scale | $1.79 | | Business | $1.19 | You pay only for rows that reach your dataset. Keywords with no results, invalid inputs and accounts outside your follower range cost nothing. When your spending limit is reached, the run stops. An account found under several keywords in one run is one row and one charge: it comes back once, under the first keyword that found it, and the run summary counts the repeats for each keyword (`alreadyDeliveredUnderEarlierInput`). ### FAQ **Do I need a TikTok account?** No. The Actor reads only what TikTok shows logged-out visitors. **Why do results repeat after ~250?** TikTok stops showing new accounts for a search at about that point; the Actor ends the search there instead of paying you for repeats. **The same account under two keywords?** It's one row and one charge, under the first keyword that found it, with that keyword's `rank`; the run summary counts it for the later keyword as `alreadyDeliveredUnderEarlierInput` (see Pricing). **What is the `tiktok-user-search-ipbook` key-value store in my account?** The Actor keeps the proxy sessions TikTok answered this search on there (session names and times, nothing else) for 30 minutes, so your next run starts on them instead of searching for an IP again. You can delete it any time; the next run just starts a little slower. **Can I find creators by what they post, not by their name?** Use our [TikTok Video Search Scraper](https://apify.com/deepmine/tiktok-video-search): every video row carries its creator and follower count. For a creator's videos and exact profile counts, pass the usernames to [TikTok Profile Scraper](https://apify.com/deepmine/tiktok-profile-videos). ### Feedback Missing a field, or a result that doesn't look right? Open an issue on the **Issues** tab and we'll look into it. If the data helps you, a short review on this page helps other people find it. # Actor input Schema ## `keywords` (type: `array`): Search terms, one per line, e.g. a niche, a name or a brand. Example: fitness coach ## `maxUsersPerKeyword` (type: `integer`): Accounts to get per keyword, in TikTok's order. TikTok shows logged-out visitors up to about 250 accounts per search. You pay per account. ## `creatorDetails` (type: `boolean`): Also open each account's profile page for its following, video and friend counts, join date, bio link, the email written in its bio (and whether the bio shows a phone number), private, TikTok Shop seller and business-account flags, app language and a large photo. Included in the price per account; adds about 15 seconds per 100 accounts. ## `minFollowers` (type: `integer`): Keep only accounts with at least this many followers (0 = no minimum). TikTok shows about 250 accounts per keyword, so a follower range returns fewer rows: only the accounts in range, and you pay only for those. ## `maxFollowers` (type: `integer`): Keep only accounts with at most this many followers (0 = no maximum). Example: 10000 to 500000 for micro and mid-size creators. TikTok rounds large counts (3.6M = 3,600,000). ## `proxyConfiguration` (type: `object`): TikTok is reached through Apify Proxy. TikTok answers this search on only some IPs; the Actor tries fresh datacenter IPs until one answers. Residential proxies don't help here. ## Actor input object example ```json { "keywords": [ "fitness coach" ], "maxUsersPerKeyword": 100, "creatorDetails": false, "minFollowers": 0, "maxFollowers": 0, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (type: `string`): No description ## `summary` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keywords": [ "fitness coach" ], "maxUsersPerKeyword": 100, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("deepmine/tiktok-user-search").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keywords": ["fitness coach"], "maxUsersPerKeyword": 100, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("deepmine/tiktok-user-search").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keywords": [ "fitness coach" ], "maxUsersPerKeyword": 100, "proxyConfiguration": { "useApifyProxy": true } }' | apify call deepmine/tiktok-user-search --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,deepmine/tiktok-user-search" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/BeESSv3J4OdILBYOQ/builds/Uzhca0DtyJtDq1CLO/openapi.json