Skip to main content
POST
/
api
/
v1
/
metrics
/
mention-rate
/
time-series
Mention Rate Over Time
curl --request POST \
  --url https://api.athenahq.ai/api/v1/metrics/mention-rate/time-series \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "website_id": "123e4567-e89b-12d3-a456-426614174000",
  "filters": {
    "start_date": "2024-01-01T00:00:00.000Z",
    "end_date": "2024-12-31T23:59:59.999Z",
    "models": [
      "chatgpt",
      "perplexity"
    ],
    "prompt_ids": [
      "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    ],
    "competitor_ids": [
      "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    ],
    "prompt_status": "active",
    "prompt_type": "branded"
  }
}
'
{
  "data": [
    {
      "date": "2024-06-15",
      "metrics": {
        "Acme Corp": {
          "mention_rate": 45.5,
          "is_self": true
        },
        "Competitor Inc": {
          "mention_rate": 32.1,
          "is_self": false
        }
      }
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

API key for authentication. You can create one here.

Body

application/json

Request body for mention rate endpoints

​
website_id
string<uuid>
required

The ID of the website to query mention rates for

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
filters
object
required

Filters for querying responses

Response

Successful response with time series data

​
data
object[]
required