datasets_creators_search
Search the TikTok creators dataset. Searches TikTok creators stored in a search index (one document per creator), with follower counts, verified status, niche, and engagement. Deleted and private accounts are excluded by default; set include_inactive=true to include them for historical lookups. S...
This record as markdown: /tools/crawlora-mcp/datasets-creators-search.md
What datasets_creators_search does on Crawlora
AI agents call datasets_creators_search to retrieve information from Crawlora without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | — | Full-text query over handle, nickname and bio, max 256 characters |
page | integer | — | Page number, defaults to 1 |
sort | string | — | Sort enum: followers_desc, engagement_desc, likes_desc, relevance. engagement_desc ranks by post-level engagement rate, currently populated for a subset of crea |
niche | string | — | Exact content-niche filter, max 128 characters |
handle | string | — | Exact handle lookup (case-insensitive), e.g. khaby.lame; returns the single creator with that exact @handle |
country | string | — | Exact creator country/region filter, max 128 characters |
verified | boolean | — | Filter by verified badge; true keeps only verified creators |
has_email | boolean | — | Filter by contact-email presence; true keeps only creators with an email |
page_size | integer | — | Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000 |
min_followers | integer | — | Minimum follower count |
include_inactive | boolean | — | Include deleted/private accounts; defaults to false (only live accounts returned) |
Parameters from the server's own tool schema.
Why datasets_creators_search is rated Low
This tool retrieves and queries publicly available creator data (follower counts, verified status, niche, engagement metrics). It has no side effects—it only reads from an index. The inclusion of inactive accounts via a parameter does not change the read-only nature.
From the tool's definition Tool performs searches on a TikTok creators dataset with sorting and filtering options. Described as 'Search the TikTok creators dataset' and 'Searches TikTok creators stored in a search index.' No modification, deletion, or execution of external operations…
Risk signalsHigh parameter count (11 properties)
Attacks that exploit this kind of access
The rule that runs datasets_creators_search safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Crawlora, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For datasets_creators_search, this is the rule to start with:
datasets_creators_search is read-only, so it stays allowed. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Crawlora, apply this rule, and every datasets_creators_search call is checked against it from then on.
Questions about datasets_creators_search
Search the TikTok creators dataset. Searches TikTok creators stored in a search index (one document per creator), with follower counts, verified status, niche, and engagement. Deleted and private accounts are excluded by default; set include_inactive=true to include them for historical lookups. Sort enum: followers_desc, engagement_desc, likes_desc, relevance. Coverage note: followers_desc, likes_desc, and relevance are backed by profile fields present across the full dataset; the post-level engagement metrics (engagement_rate, avg_views, and the nested post_stats object) and the engagement_desc sort are currently populated for a growing subset of creators, prioritizing the highest-reach accounts. Creators without these metrics are still returned but sort last under engagement_desc and omit those fields. It is categorised as a Read tool in the Crawlora MCP Server, which means it retrieves data without modifying state.
datasets_creators_search accepts 11 parameters: q, page, sort, niche, handle, country, verified, has_email, page_size, min_followers, include_inactive. The full parameter table on this page comes from the server's own tool schema.
Register the Crawlora MCP server in PolicyLayer and add a rule for datasets_creators_search: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Crawlora. Nothing to install.
datasets_creators_search is a Read tool with low risk. Read-only tools are generally safe to allow by default.
Yes. Add a rate_limit block to the datasets_creators_search rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for datasets_creators_search. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
datasets_creators_search is provided by the Crawlora MCP server (crawlora-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Crawlora, and thousands of servers like it.
This server
Across the catalogue