TikTok User Search Scraper avatar

TikTok User Search Scraper

Pricing

from $2.40 / 1,000 user profiles

Go to Apify Store
TikTok User Search Scraper

TikTok User Search Scraper

Search public TikTok users by keyword and export creator profiles with account statistics, bios, verification, ranking, and query attribution.

Pricing

from $2.40 / 1,000 user profiles

Rating

0.0

(0)

Developer

Fetch Cat

Fetch Cat

Maintained by Community

Actor stats

0

Bookmarked

8

Total users

0

Monthly active users

a month ago

Last modified

Features

Limited permissions

Share

TikTok User Search Scraper lets you search TikTok users by keyword and export public creator profiles with account statistics, biographies and query attribution. Use this TikTok creator search scraper to build creator shortlists, research niches and compare public accounts without a TikTok login.

Each query saves up to 10 matching profiles. Public search availability varies, and not every query returns the requested number of accounts.

Quick start

Enter one or more search keywords, choose how many profiles to save per query and click Start. For a small first run, use:

{
"queries": ["coffee"],
"maxUsersPerQuery": 3
}

When the run finishes, open its dataset to review and export the profiles.

Prefer a video guide? This short Apify walkthrough shows you how to set up and run an Actor. It uses a different Actor, but the setup steps are the same.

Ready-to-run examples

Choose an example to start with a small, preconfigured input.

What you get

  • Public creator profiles: Account IDs, usernames, display names and profile URLs.
  • Profile context: Available biographies, bio links, avatars and account flags.
  • Account statistics: Available follower, following, heart, video and liked-video counts.
  • Query attribution: The search keyword and a per-query position for each exported profile.

Repeated accounts are removed within a query. An account matching two different queries can appear once for each query, preserving attribution.

Who is it for?

  • Influencer marketing teams building niche-specific creator shortlists.
  • Talent agencies reviewing public audience and activity signals.
  • Brand researchers comparing how topics and names appear in user search.
  • Developers sending creator discovery records to spreadsheets, CRMs or data warehouses.

Input settings

SettingAPI keyDescription
Search queriesqueriesRequired list of 1–20 non-empty keywords, names, niches or topics. Repeated queries are combined without regard to case.
Maximum users per querymaxUsersPerQueryInteger from 1 to 10. Defaults to 10. Limits saved profiles for each query, not a guaranteed result count.

Niche creator discovery

{"queries":["vegan recipes","home workouts"],"maxUsersPerQuery":5}

Brand-name research

{"queries":["Acme"],"maxUsersPerQuery":3}

The Actor does not accept TikTok login credentials or offer a proxy setting.

Output data

Each dataset row represents one profile for one query. Optional text and account statistics can be null when unavailable. Account flags reflect the public information returned by TikTok and are not independently verified.

FieldsMeaning
query, rankSearch keyword and the profile's position in the exported results for that query.
id, secUid, username, displayNameAccount identifiers, handle and display name.
profileUrl, avatarUrlProfile and available avatar URLs.
bio, bioLinkAvailable public biography and website link.
verified, privateAccount, sellerPublic account flags. No private account content is collected.
followingCount, followerCountAvailable following and follower counts.
heartCount, videoCount, diggCountAvailable total hearts, published-video count and liked-video count.
collectedAt, sourceCollection timestamp and user-search source URL.

Illustrative shape only, not a newly collected profile:

{
"query": "coffee",
"rank": 1,
"id": "example-account-id",
"secUid": null,
"username": "example_creator",
"displayName": "Example creator",
"profileUrl": "https://www.tiktok.com/@example_creator",
"avatarUrl": null,
"bio": null,
"bioLink": null,
"verified": false,
"privateAccount": false,
"seller": false,
"followingCount": null,
"followerCount": null,
"heartCount": null,
"videoCount": null,
"diggCount": null,
"collectedAt": "2026-10-26T00:00:00.000Z",
"source": "https://www.tiktok.com/search/user"
}

Download your results

Open your run's dataset, choose Export and select JSON, CSV or Excel. JSON keeps nested fields together. CSV and Excel are useful when you want to review the records in a spreadsheet.

See Apify's download and export guide for the available formats and field options.

Pricing

This Actor uses pay-per-event pricing. The start event is charged once when a validated run begins its work.

The result event is charged for each saved profile. The same account returned under two queries counts as two saved results. Failed queries do not produce paid error rows, but a run that saves no profiles can still incur its start charge.

See the live Pricing tab for current rates and discounts.

Tips for best results

  • Start with one query. Check relevance before adding more keywords.
  • Use focused niches. Specific names or topics make creator shortlists easier to review.
  • Keep batches small. More queries share the same run time and may not all finish.
  • Download avatars promptly. Signed image URLs can expire.
  • Keep query attribution. It helps explain why an account appears in a multi-query export.

Limits and caveats

  • Public TikTok search can be challenged, unavailable or change its ordering. Results can vary by region and collection time.
  • A run accepts at most 20 queries and saves at most 10 profiles per query. These are ceilings, not completeness guarantees.
  • An unsuccessful query does not discard profiles already saved for other queries. A run can fail when it saves no profiles.
  • Private content, inferred demographics, posts, comments and follower graphs are not collected.
  • This is an independent tool and is not an official TikTok API.

Automation and integrations

Save your settings for next time

Once you have an input that works for you, save it as an Apify task. This keeps your settings together so you can use them again without filling in the form from scratch.

Run on a schedule

Need fresh results regularly? You can schedule the Actor or a saved task to run at a time that suits you.

Each scheduled run collects the data again. If you want to compare results or highlight changes, add that step in your own workflow.

Send results to your other tools

Use n8n, Make or Zapier to connect this scraper to the rest of your workflow. For example, you could pass its results to an AI assistant or add records to a spreadsheet. Follow the Apify integration guides for your chosen tool.

For a custom connection, an Apify webhook can notify your app when a run finishes or fails. Your app can then fetch the results or handle the failure.

API usage

Want to collect this data from your own app or automation? These TikTok user search API examples send input to the scraper and show how to collect its results.

The Node.js and Python examples wait for the run to finish before reading its results. The cURL example starts the run and returns its details. Wait for that run to finish, then use its defaultDatasetId to fetch the results.

For setup instructions, see Apify's JavaScript client guide, Python client guide and Actor runs API reference.

cURL

curl -X POST "https://api.apify.com/v2/acts/fetch_cat~tiktok-user-search-scraper/runs" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"queries":["coffee"],"maxUsersPerQuery":3}'

Node.js

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('fetch_cat/tiktok-user-search-scraper').call({
queries: ['coffee'],
maxUsersPerQuery: 3,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

import os
from apify_client import ApifyClient
client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('fetch_cat/tiktok-user-search-scraper').call(run_input={
'queries': ['coffee'],
'maxUsersPerQuery': 3,
})
items = client.dataset(run['defaultDatasetId']).list_items().items
print(items)

MCP and AI agents

You can ask your AI assistant to collect data with TikTok User Search Scraper and help you work with the results. The scraper returns the data, and your assistant can then summarize it, compare records or prepare notes.

Connect your assistant through the Apify MCP server. MCP gives your assistant a way to find this scraper, run it and read the results. Follow the official setup and sign-in guide for your app.

Easier setup with an Apify plugin

If you use a supported coding assistant, the official Apify plugin can set up the connection for you. It connects your assistant to Apify and includes instructions for common tasks. Follow the guide for your particular app.

Use Apify AI in Console

Prefer to keep everything in Apify? Open Apify AI in Console and ask it to find Fetch Cat's TikTok User Search Scraper. You can describe the data you want and ask questions about the results.

Apify AI is currently in beta. It asks for confirmation before starting an Actor, and normal run charges apply.

Choose your assistant

Connect just this scraper

To keep your setup focused on this scraper, add this server configuration to a compatible MCP client:

{
"mcpServers": {
"apify": {
"url": "https://mcp.apify.com?tools=fetch_cat/tiktok-user-search-scraper"
}
}
}

Sign in to Apify when your client asks. If your client uses a Bearer token instead, follow its setup guide and keep the token in its secure configuration. Configuration formats vary by app, so use the linked guide if your client needs a different format.

Use Apify's general server

Already connected to the general Apify MCP server at https://mcp.apify.com? You can use it to find this scraper without adding another server. Ask your assistant to use TikTok User Search Scraper by Fetch Cat, or give it the identifier fetch_cat/tiktok-user-search-scraper.

Your assistant can check the available settings and retrieve the results from the returned run. If the run is still working, it should follow that run rather than start it again. Both connection options use Apify's hosted service.

Example requests

  • “Find up to five public TikTok accounts matching specialty coffee and make a shortlist with their profile links and available follower counts.”
  • “Search for fitness coach and pilates instructor accounts, then group the returned profiles by the search that found them.”
  • “Find public TikTok accounts matching vegan recipes and prepare a spreadsheet of their biographies, profile links and available audience statistics.”

Normal Apify charges apply. Check the live Pricing tab before asking your assistant to run a larger batch.

Pay with x402

If your AI agent has a funded wallet, it can pay for Apify usage through x402. This experimental option lets an agent use Apify without a conventional account.

Apify AGI provides a prepaid API token with a spending cap after payment. Your agent can use that token to run this scraper through the Apify API or an authenticated MCP connection.

Some MCP setups also support paying for each request directly. That is a different payment option, so check the official guide for its availability.

Follow the official guide for wallet setup, supported payment options and current terms. Apify handles the payments. Keep wallet keys and payment tokens in your agent's secure configuration.

Other ways for agents to pay

Apify also supports MPP for prepaid access through AGI and Skyfire for eligible Actors. If your agent already uses one of these, see the agentic payment guide to choose the right setup.

FAQ

Can I search TikTok users without an account?

Yes. This scraper uses public user search and does not ask for a TikTok login. TikTok can still limit public access.

Can I search by phone number, photograph or location?

No. Inputs are text queries and a per-query profile limit. There are no phone-number, image or location filters.

Why are some statistics missing?

TikTok does not expose every field for every account. Unavailable optional values remain null rather than being invented.

Are duplicate users removed?

Within each query, yes. A profile matching different queries remains attributed to each query.

What if a query returns no data?

Review the run log and try a clear, public keyword. Public search may be unavailable or return no matching profiles. Results from completed queries remain saved. A run that saves no profiles can fail, so success is not guaranteed for every keyword.

Can I export the results or use an API?

Yes. Export the dataset to JSON, CSV or Excel, or use the API and MCP examples above. For individual known accounts rather than keyword discovery, consider the related TikTok Profile Scraper.

More TikTok scrapers

  • TikTok Profile Scraper — Collect public TikTok profile details, aggregate counts and available recent video summaries.
  • TikTok Ads Library Scraper — Collect curated TikTok Creative Center Top Ads and available public performance indicators, rather than a complete ad archive.
  • TikTok Video Scraper — Collect public TikTok video metadata and available engagement from known full video URLs.
  • TikTok AI Transcript Extractor — Collect available TikTok caption-transcript text and metadata from known video URLs, without generating speech-to-text.
  • TikTok Followers and Following Scraper — Collect exposed public TikTok follower or following relationship rows, with available account identities and profile details.

Support and feedback

For custom additions or integrations, email hello@fetchcat.dev.

Found an error or have a feature request? Open an issue with the run URL, a non-sensitive input example and what you expected.

Need help sharing it? See Apify’s guide to sharing a run when reporting an issue. Sharing a run can give the developer access to its input, logs and results, so use a run that contains no sensitive data. Please leave out API tokens, passwords, cookies, private documents and personal data. Use a public sample URL or a redacted example instead.

Tried this scraper? We'd love to hear how it worked for you. Leave a review to help others choose the right tool and help us improve it. Your feedback means a lot to us.

Made with care for curious people, AI agents and the possibilities in data. ♥