Search content ideas (Content AI)
search_contentContent AI (lite) search: find short-video content ideas by meaning — Instagram Reels, TikTok and YouTube Shorts ranked for a free-text query (a topic, a niche, a hook, an idea, up to 500 characters; any language). One row = one video. Rows carry id, platform, views, likes, comments, shares (null when the platform hides it), viral_score, published_at, language and duration_sec. AUTHORS, CAPTIONS, TITLES AND LINKS ARE NOT RETURNED — Content AI masks them by design; never invent them, and send the user to Content AI on spytrend.com for the full cards. Filters: platforms (instagram, tiktok, youtube — a list; empty = all), published_within_days (7, 30 or 90 — only videos published in that window), sort (best_match default, fire, views, likes, comments, newest). The tool returns the FIRST page only (limit at most 10): there is no paging, repeat the search with a sharper query instead. total is the number of matches found so far for the query (not an exact market size) and can be absent; low_relevance=true means nothing matched well — say so instead of presenting weak rows as ideas. filters_applied=false means this deployment ignored sort, platforms and published_within_days for this call — do not claim the result was filtered by them. Each search also counts against the account's daily Content AI search limit; a repeated identical query is served from cache. Gate errors are reported as tool errors: subscription_required (Content AI needs a subscription or token balance on the account), not available, or busy (retry after the indicated delay). QUOTA: 1 MCP credit per delivered row; 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": {
"query": "<query>"
},
"name": "search_content"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | order: best_match (default), fire, views, likes, comments or newest | |
| limit | No | max rows (default 10, at most 10; each delivered row costs 1 MCP credit). There is no paging. | |
| query | Yes | what to look for: a topic, niche, idea or hook in free text, 1-500 characters, any language | |
| platforms | No | limit to platforms: instagram, tiktok, youtube (a list; empty = all) | |
| published_within_days | No | only videos published in the last 7, 30 or 90 days |
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. | |
| total | 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. | |
| 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. | |
| low_relevance | No | ||
| filters_applied | No | ||
| semantic_unavailable | No |