Mentions

List mentions

Every time a brand or competitor was mentioned in a scrape run, with sentiment and provider attribution. Responses are JSON and require a workspace API key.

GET/v1/brands/{brand_id}/mentions

Requires API key

Parameters

brand_iduuid· pathrequired

Brand to fetch mentions for.

sinceISO-8601· queryoptional

Only mentions created at or after this timestamp.

untilISO-8601· queryoptional

Only mentions created at or before this timestamp.

providerstring· queryoptional

Repeatable. Filter by AI provider.

openaianthropicgeminiperplexitygoogle_ai_overview

entity_typestring· queryoptional

Only your brand or only competitors.

brandcompetitor

prompt_iduuid· queryoptional

Only mentions from scrape runs for this prompt.

limitinteger· queryoptional

Max items to return. Default 50, max 200.

cursorISO-8601· queryoptional

Pass the previous response's next_cursor to paginate.

Request

curl -X GET 'https://api.rankr.so/v1/brands/:brand_id/mentions' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Response200

JSON

{
  "data": [
    {
      "id": "aa11bb22-cc33-4455-66dd-7788eeff9900",
      "scrape_run_id": "b2c3d4e5-f6a7-48b9-0c1d-2e3f4a5b6c7d",
      "brand_id": "9a7e1d92-7c5a-4a2c-8d3b-e5a1f3c7b9a0",
      "entity_type": "brand",
      "entity_name": "Acme",
      "entity_website": "https://acme.com",
      "mentioned": true,
      "sentiment_score": 78,
      "mention_char_position": 412,
      "created_at": "2026-04-19T06:05:14Z",
      "scrape_run": {
        "id": "b2c3d4e5-f6a7-48b9-0c1d-2e3f4a5b6c7d",
        "prompt_id": "f0b6c8e1-2d3a-44a9-b0c7-8e4f1a9c7d01",
        "provider": "openai",
        "sentiment": "positive",
        "created_at": "2026-04-19T06:05:12Z"
      }
    }
  ],
  "next_cursor": "2026-04-19T06:05:14Z"
}

If next_cursor is non-null, pass it as ?cursor= on the next request to continue paging.

PreviousList tracked prompts NextGet an AI answer