Title98/100
Research a niche
The title clearly communicates the tool’s action and subject. Keep it concise.
Description95/100
Use when the Customer asks what is working in a niche: one Run searches TikTok, Instagram and YouTube (Facebook if in platforms), analyses and ranks the top videos, and returns a Digest (themes, hooks, formulas, gaps, angles) with ranked ids. Not for a quick page of videos or one phrase's stats: search_videos or get_keyword cost far less. Named Creators: breakdown. Re-read with get_research (free). Price: 1,036 credits for up to 50 enriched videos, then 20 credits each, at most 4,036 credits. 1-3 minutes for 50 videos: waits up to 60 s, then returns a run id for get_run. estimate=true quotes.
The description explains the capability, when to use it, and what to expect.
Inputs53/100
6 of 9 inputs have descriptions. Add descriptions to the missing inputs, including where to obtain IDs and how to supply values.
estimate
Quote the price in Credits: no Run, no charge
Clear enough to supply this argument.
max_credits
Not provided
Missing description. Explain what this value means and how to supply it.
idempotency_key
Reuse on a retry: replays the original Run, not charged again
Clear enough to supply this argument.
intent
Plain-language goal, e.g. 'find what is working for no-equipment home workouts this month'
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
keywords
Optional seed keywords, at most 4; derived from intent if omitted
Clear enough to supply this argument.
platforms
Omit for TikTok, Instagram and YouTube. `facebook` is opt-in: name it to research Facebook videos and Reels too
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
region
Two-letter region code, e.g. US
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
window
Not provided
Missing description. Explain what this value means and how to supply it.
max_videos
Not provided
Missing description. Explain what this value means and how to supply it.
Annotations100/100
All four behavior hints are declared.
{
"title": "Research a niche",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}Output schema28/100
Declare the result fields and their types in the output schema.
View output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"run": {
"type": "object",
"additionalProperties": {}
},
"cached": {
"type": "boolean"
},
"result": {
"$ref": "#/properties/run",
"description": "A finished Research."
},
"poll_url": {
"type": "string",
"format": "uri"
},
"estimate_credits": {
"type": "integer"
}
},
"additionalProperties": true
}