v1

latestOpenAPI 3.1.02026-07-2295105298.6 KB
Metrics

Position Over Time

Returns daily position/ranking breakdown over the specified date range. Each entry contains position metrics for your brand and competitors.

post/api/v1/metrics/position/time-series

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 time series data

dataTimeSeriesPositionEntry[] required