Sign in

v1

latestOpenAPI 3.1.02026-07-2295105298.6 KB
Metrics

Cumulative Position

Returns average position/ranking across the specified date range. Shows where your brand and competitors typically appear in AI responses.

post/api/v1/metrics/position/cumulative

Request body

website_idstring uuid required

The ID of the website to query position metrics for

Example request

{
  "website_id": "123e4567-e89b-12d3-a456-426614174000",
  "filters": {
    "start_date": "2024-01-01T00:00:00.000Z",
    "end_date": "2024-01-31T23:59:59.999Z",
    "location_ids": [
      "123e4567-e89b-12d3-a456-426614174111"
    ]
  }
}

Response

Successful response with position data

dataobject required