InfiniteRanks documentation
Derive brand positions from saved answer evidence
InfiniteRanks exposes answer evidence rather than a standalone public brand-rankings endpoint. Calculate only the metric your selected eligible cohort supports.
Supported request
GET /api/v1/answers?limit=50 on https://app.infiniteranks.com with an Authorization: Bearer <read-only-key> header. Answer records include mentions with brandId and position, plus observation eligibility, state, surface, method and prompt revision. Workspace context supplies brand IDs and names.
A practical client workflow
Read the owned brand ID from /api/v1/workspace, paginate all answer pages and retain the intended time and method cohort. Calculate average position only from eligible records with a detected position. Report mention count separately.
Limits and interpretation
Do not assign zero position to an absent brand or combine API and consumer-web captures as if they were identical. The API does not return a precomputed competitor-ranking report. For list resources, use limit from 1 to 100 and continue with nextCursor. Keep raw record identifiers when presenting derived metrics.
Credential and error handling
Keep the key in trusted client or server configuration. It reads only its assigned workspace. Handle authentication failures without retry loops and respect Retry-After when the workspace request allowance is reached. Reading saved records does not trigger a paid provider call.
Sources and further reading
Sources explain the underlying standards. They do not endorse InfiniteRanks or guarantee a ranking outcome.