Analytics

Brand mention trends

post

Returns a time series of how often your brand and tracked competitors appear in AI search engine answers

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

intervalstring · enumRequiredPossible values:

Responses

200Success

application/json

intervalstring · enumRequiredPossible values:

post/v1/analytics/brands/mentions

HTTPcURLJavaScriptPython

POST /v1/analytics/brands/mentions HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 220

{
  "interval": "daily",
  "filters": {
    "timeRange": {
      "from": "2026-07-14T13:45:17.876Z",
      "to": "2026-07-14T13:45:17.876Z"
    },
    "providers": [
      "GEMINI"
    ],
    "topics": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000"
      }
    ],
    "regions": [
      {
        "code": "text"
      }
    ]
  }
}

200Success

{
  "interval": "daily",
  "timeRange": {
    "from": "2026-07-14T13:45:17.876Z",
    "to": "2026-07-14T13:45:17.876Z"
  },
  "series": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "data": [
        {
          "timestamp": "2026-07-14T13:45:17.876Z",
          "value": 1
        }
      ]
    }
  ]
}

Top cited sources

post

Returns the domains or URLs most frequently cited in AI search answers for your account, ranked by citation volume

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

limitinteger · max: 100Required

offsetinteger · max: 9007199254740991Required

groupBystring · enumRequiredPossible values:

Responses

200Success

application/json

groupBystring · enumRequiredPossible values:

post/v1/analytics/sources

HTTPcURLJavaScriptPython

POST /v1/analytics/sources HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 241

{
  "limit": 1,
  "offset": 1,
  "groupBy": "domain",
  "filters": {
    "timeRange": {
      "from": "2026-07-14T13:45:17.876Z",
      "to": "2026-07-14T13:45:17.876Z"
    },
    "providers": [
      "GEMINI"
    ],
    "topics": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000"
      }
    ],
    "regions": [
      {
        "code": "text"
      }
    ]
  }
}

200Success

{
  "groupBy": "domain",
  "sources": [
    {
      "source": "text",
      "share": 1,
      "citations": 1
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 1,
    "offset": 1,
    "hasMore": true
  }
}