Skip to main content
GET
/
mentions
curl -X GET "https://scrape.st/mentions?ticker=\$SOL" \
  -H "x-api-key: YOUR_API_KEY"
{
  "data": [
    {
      "id": "cm9abc123def456",
      "source": "TWITTER",
      "messageId": "1886493083207827456",
      "sourceId": "12",
      "content": "I am so bullish on $SOL right now!",
      "rawPayload": {
        "id": "1886493083207827456",
        "text": "I am so bullish on $SOL right now!",
        "created_at": "2026-04-20T15:30:00.000Z",
        "favorite_count": 15000,
        "author": {
          "id": "12",
          "name": "Jack",
          "screen_name": "jack"
        }
      },
      "createdAt": "2026-04-20T15:30:00.000Z"
    }
  ],
  "nextCursor": "cm9xyz789ghi012",
  "limit": 50
}
Search through the backfilled history of all tracked sources (e.g. KOLs) for mentions of a specific token ticker or contract address.
This endpoint is rate-limited to 30 requests per 60 seconds.

Query Parameters

You must provide at least one of ticker or contractAddress. If both are provided, results will match mentions that contain either the ticker OR the contract address.
ticker
string
Filter by token ticker (e.g. $SOL, BTC).
contractAddress
string
Filter by token contract address.
source
string
Filter by a specific source platform. Valid values: TWITTER, DISCORD, TELEGRAM
order
string
default:"desc"
Sort order by creation date. Valid values: asc, desc
limit
number
default:"50"
Number of records to return per page (1–100)
cursor
string
Pagination cursor — the id of the last record from the previous page. Pass the nextCursor value from the previous response to fetch the next page.

Response

data
array
Array of matched backfill data objects. Each object contains:
  • id — Unique record ID
  • source — Source type (TWITTER, DISCORD, TELEGRAM)
  • messageId — External message ID (e.g. tweet ID)
  • sourceId — External source ID (e.g. Twitter user ID)
  • content — Extracted text content
  • rawPayload — Full raw JSON payload from the source
  • createdAt — Timestamp of the original message
nextCursor
string | null
Cursor for fetching the next page. null when there are no more results.
limit
number
The limit that was applied.
curl -X GET "https://scrape.st/mentions?ticker=\$SOL" \
  -H "x-api-key: YOUR_API_KEY"
{
  "data": [
    {
      "id": "cm9abc123def456",
      "source": "TWITTER",
      "messageId": "1886493083207827456",
      "sourceId": "12",
      "content": "I am so bullish on $SOL right now!",
      "rawPayload": {
        "id": "1886493083207827456",
        "text": "I am so bullish on $SOL right now!",
        "created_at": "2026-04-20T15:30:00.000Z",
        "favorite_count": 15000,
        "author": {
          "id": "12",
          "name": "Jack",
          "screen_name": "jack"
        }
      },
      "createdAt": "2026-04-20T15:30:00.000Z"
    }
  ],
  "nextCursor": "cm9xyz789ghi012",
  "limit": 50
}