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}/keywords reads the latest run, groups, targeted summary and opportunities.
  • PUT .../keyword-targets chooses which groups and searches to target, or excludes a group.
  • POST .../keyword-groups/{groupId}/opportunity adds a group to the silo's video opportunities. The body needs idempotency_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.

On this page