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.

InfiniteRanks editorial team

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.

Be part of the conversation.

Explore a model response with your own provider key.