public-api

Get Rankings

Get competitive ranking data for your brand.

Views:

  • overall (default): Visibility/ranking scores with per-competitor breakdown. Reads at most 90 days regardless of days; the response carries days_requested, days_effective and a window_note when they differ.
  • by-prompt: Rankings per prompt across markets
  • prompt-trends: Daily average position per prompt, for you and the competitors you meet on it. Answers which prompts you are losing, and since when. Position is average rank in the answer, so lower is better.
get/get-rankings

Request

  • Base URL: https://api.trakkr.ai
  • URL: https://api.trakkr.ai/get-rankings
  • Auth: HTTP bearer

Query parameters

brand_idstring uuid required

Brand UUID

viewstring nullable

View mode: overall (default), by-prompt

daysinteger

Historical period in days, 1-365. view=overall reads at most 90 days and reports the window it actually used in days_effective.

include_volumeboolean

Merge search volume data into rankings

tag_idsstring nullable

Comma-separated prompt tag UUIDs. Recalculates rankings over only the prompts carrying those tags. Applies to view=overall and view=prompt-trends.

limitinteger

view=prompt-trends only: how many prompts to return, most-measured first.

periodstring nullable

A frozen calendar period instead of a rolling window: a month as YYYY-MM (2026-08) or a quarter as YYYY-Qn (2026-Q3). A closed month is read from the archive frozen when it closed; the open month is computed to date. When period is given, days is ignored and the response carries a period block saying exactly what was resolved. Definitions: /get-metrics.

Response

Successful Response

OR
OR

Changes

No recorded changes to this operation across all 1 revision of this API.