Search influencers
search_influencersSearch the INFLUENCER directory (the website's /influence page): YouTube channels and Instagram accounts with audience size and activity. One row = one creator. platform is required: youtube or instagram. Filters: q (name / topic words), country (ISO-2 code such as US, or the English country name as the directory writes it, comma separated), category and niche (YouTube only; the directory's own labels, exact match, comma separated — YouTube category examples: Gaming, Music, Education, Comedy, Sports, 'Beauty & Makeup', 'Tech, AI & Software', 'Finance & Cryptocurrency', 'Food, Drink & Cooking', Fitness, 'Travel & Events'; when unsure of a label search by q instead), followers_min / followers_max (subscribers / followers), last_video_days (creators active in the last N days: last video on YouTube, last post on Instagram), has_email (true = creators with an email in the directory), sort (YouTube: followers default, views, videos, last_video; Instagram: followers only). Instagram rows carry the account handle in username and have no niche, avg_views or lang_hint. Rows: slug, name, platform, followers, avg_views (YouTube: average views per video), count_views (YouTube: total views), media_count (videos / posts), country, niche, category, lang_hint (YouTube writing-script hint such as 'latin' — NOT a language), last_video_at / last_post_at, has_email, url (YouTube creator page on spytrend.com). CONTACTS ARE NEVER RETURNED: no emails, phones, websites, social links or bios — has_email is only a yes/no. total_estimate is an ESTIMATE scaled to the directory size, never an exact count. Pagination: limit is at most 10; offset must be a multiple of limit. Callers without an Influence subscription get subscription_locked=true: only the first row carries statistics, the others are name/country/niche teasers (stats_hidden=true, not charged) and there is no second page. QUOTA: 1 MCP credit per row that carries statistics; teaser rows and short pages are refunded. PRICING: price × number of filters set (min 1), on paid plans ×1 after 500 MCP credits/month; one-time consent via accept_pricing_terms; before calling, get the maximum debit from estimate_cost (free) and tell the user.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"platform": "<platform>"
},
"name": "search_influencers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | name or topic words to search for (creator name, channel topic) | |
| sort | No | order: followers (default), views, videos or last_video; Instagram supports followers only | |
| limit | No | max rows (default 10, at most 10; each row with statistics costs 1 MCP credit) | |
| niche | No | YouTube only: the directory's own niche label (exact match, comma separated), e.g. 'Mobile Games'. Unsure of the label — use q | |
| offset | No | pagination offset, a multiple of limit (0, 10, 20…) | |
| country | No | ISO-2 code (US, BR, DE…) or the English country name as the directory writes it ('United States'); comma separated for several. Matches the creator's country, not the audience's | |
| category | No | the directory's own category label (exact match, comma separated), e.g. Gaming or 'Beauty & Makeup'. Unsure of the label — use q | |
| platform | Yes | directory to search: youtube or instagram | |
| has_email | No | true = only creators with an email in the directory (the email itself is never returned) | |
| followers_max | No | maximum subscribers (YouTube) / followers (Instagram) | |
| followers_min | No | minimum subscribers (YouTube) / followers (Instagram) | |
| last_video_days | No | only creators active in the last N days (last video on YouTube, last post on Instagram) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| note | No | ||
| error | No | Present only when isError is true: machine-readable failure. The human explanation stays in content. | |
| offset | No | ||
| params | No | Request parameter echo: applied = parameters that shaped this result; normalized = parameters rewritten before applying (alias, type coercion, resolved id); ignored = parameters that were accepted but NOT applied, with the reason. | |
| has_more | No | ||
| platform | No | ||
| total_note | No | ||
| addon_hints | No | Add-on modules that have additional data for objects of this result (no prices, no paid values). subscription_status=active: the account has the module — use its normal path. Do not push a purchase the user did not ask about. | |
| contacts_note | No | ||
| total_estimate | No | ||
| credits_exhausted | No | ||
| subscription_locked | No |