Skip to main content

Saved rankings & output formats

Maps to: GET /v1/rankings, GET /v1/rankings/{uuid}, GET /v1/rankings/execute/{uuid}

List and retrieve saved rankings​

GET /v1/rankings
GET /v1/rankings/{uuid}
  • List returns the rankings available to your account; pass is_listed (true/false) to filter. Archived rankings are excluded.
  • Get returns a single ranking with its full definition.

Execute a saved ranking​

GET /v1/rankings/execute/{uuid}

Runs a saved ranking by UUID — no request body needed. The result is identical in shape to the definition-based execute.

Output formats​

Both execute forms accept a .csv suffix for a flat CSV response instead of JSON:

POST /v1/rankings/execute.csv
GET  /v1/rankings/execute/{uuid}.csv

The CSV has one row per ranked entity, with its rank, score and volume (and the comparison-period equivalents when a comparison period was used). For a named file download, use the export endpoint.