Keyword Research
Run FoxCue keyword research on a silo: discover, enrich or refresh, with a budget up to $10, then target keywords and add them to video opportunities.
The Keywords tab is not in the sidebar. It may not be enabled on your workspace yet. If you do not see it on the silo, keyword runs are still available on the API when your key has the scopes below.
Keyword research is a spend-capped run on a silo. The API is POST /strategy/silos/{siloId}/keyword-runs. The Keywords tab is where you read the groups after a run.
Start a run
The body needs kind (discover, enrich or refresh) and idempotency_key. Optional budget_usd must be greater than 0 and at most $10. The default is $1 for discover or refresh and $0.50 for enrich. The run stops before it passes the budget. One active run per silo.
The call also requires strategy:read and generation:write. It can incur provider charges up to the budget.
Poll GET /strategy/keyword-runs/{runId} for status, stage, counts, budget_usd and spent_usd (what the provider reported).
Use the results
GET /strategy/silos/{siloId}/keywordsreads the latest run, groups, targeted summary and opportunities.PUT .../keyword-targetschooses which groups and searches to target, or excludes a group.POST .../keyword-groups/{groupId}/opportunityadds a group to the silo's video opportunities. The body needsidempotency_key.
Those opportunities show up with ideas. Hosted MCP can start the same run when the grant includes strategy:write and generation:write. See MCP tools.