Skip to main content
Paths are relative to /api/v1. All routes use a project-scoped API key - Authorization: Bearer <api_key> - that must belong to the project in the path. See Authentication for scopes. Competitor metrics are derived from rank-check results. Adding a competitor does not trigger a provider request by itself. Reports compare one market at a time. A market is a location and language pair, plus the selected device for the report. Language-qualified locations remain separate: results for ES (Spanish) are not combined with ES@en (English). Share of voice needs search-volume data, so a tracked market whose language is not supported by Research remains available for position checks but is disabled in the competitor market selector. See Markets and languages. The generated OpenAPI JSON remains the machine-readable source of truth for request and response schemas.