Start a research run for a project.
Runs asynchronously through the SERP, AI-answer, keyword-metrics, domain-authority and analysis phases, then upserts scored opportunities. Poll the runs endpoint for status. Only one run per project can be active at a time - triggering while one is in flight returns that run with started=false rather than starting a second.
Charges a flat credit cost up front, which is not refunded if the run later fails.
Authorizations
Company API key - scoped to a specific company. Generate from the Integrations page in your dashboard.
Path Parameters
Body
Company scope for the run
Request body for starting a research run
Company ID that owns the project
Response
The queued run, or the already-active run
Result of a run trigger. Returns 202 when a new run started, or 200 with started=false when a run was already in progress for this project.

