Skip to main content
Mentions

Month-by-month AI mention history for a brand

View Markdown

Returns roughly the last 13 months of how often a brand is mentioned in AI answers, with the AI search volume behind those mentions. Use it to chart whether your AI visibility is trending up or down. Costs 35 credits.

POST/v1/mentions/history

Authorization

accessKey
x-access-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/mentions/history" \  -H "Content-Type: application/json" \  -d '{    "brand": "string"  }'
{
  "success": true,
  "credits": {
    "charged": 0,
    "remaining": 0
  },
  "data": {
    "brand": "string",
    "platform": "string",
    "history": [
      {
        "year": 0,
        "month": 0,
        "mentions": 0,
        "ai_search_volume": 0
      }
    ]
  }
}
{
  "success": false,
  "message": "string"
}
{
  "success": false,
  "message": "string"
}
{
  "success": false,
  "message": "string"
}
{
  "success": false,
  "message": "string"
}