Get average position rank

Average target-brand rank among responses where it appears; lower is better and one is first. Empty data returns null. Requires analytics:read.

GET /v1/organizations/{organizationId}/projects/{projectId}/analytics/position-rank

Bearer token

curl 'https://api.ansehn.com/v1/organizations/organization_01JXY9AZK4KV/projects/project_01JXY9AZK4KV/analytics/position-rank?startDate=2026-01-01&endDate=2026-01-01&monitorId=monitor_01JXY9AZK4KV&tagIds=example&promptTypes=example&promptIds=example&country=example&interval=day' \
  --request GET \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "metric": "visibility_score",
  "data": {
    "value": 1,
    "unit": "percentage",
    "interval": "day",
    "series": [
      {
        "date": "2026-01-01",
        "value": 1
      }
    ]
  },
  "filters": {
    "startDate": "2026-01-01",
    "endDate": "2026-01-01",
    "monitorId": "monitor_01JXY9AZK4KV",
    "tagIds": [
      "tag_01JXY9AZK4KV"
    ],
    "promptTypes": [
      "example"
    ],
    "promptIds": [
      "prompt_01JXY9AZK4KV"
    ],
    "country": "example",
    "interval": "day"
  }
}

Aggregate and time series rounded to two decimals.

Path parameters

· 2

organizationId string required

projectId string required

Query parameters

· 8

startDate string · date

Inclusive UTC date (YYYY-MM-DD). Defaults to 29 days before endDate.

endDate string · date

Inclusive UTC date (YYYY-MM-DD). Defaults to today. Maximum range is 366 days.

monitorId string

Optional monitor belonging to the authorized project.

tagIds string

Comma-separated prompt-tag IDs belonging to the authorized project and optional monitor.

promptTypes string

Comma-separated prompt types. Values use OR semantics within this filter and combine with other filters using AND semantics. For example, Generic,Branded includes either prompt type.

promptIds string

Comma-separated prompt IDs belonging to the authorized project and optional monitor. Values use OR semantics within this filter and combine with other filters using AND semantics.

country string · pattern

Two-letter uppercase execution market configured on prompts.

interval string · default: day· enum

UTC time-series bucket.

values

day
week
month

Path parameters

Query parameters

Responses