Skip to main content
GET
/
account
/
history
/
:id
curl -X GET "https://scrape.st/account/history/clxyz123abc" \
  -H "x-api-key: YOUR_API_KEY"

{
  "data": [
    {
      "id": "cm9abc123def456",
      "source": "X",
      "messageId": "1886493083207827456",
      "sourceId": "12",
      "content": "Bitcoin hits new all-time high! 🚀",
      "rawPayload": {
        "id": "1886493083207827456",
        "text": "Bitcoin hits new all-time high! 🚀",
        "created_at": "2026-04-20T15:30:00.000Z",
        "favorite_count": 15000,
        "retweet_count": 3000,
        "reply_count": 800,
        "author": {
          "id": "12",
          "name": "Jack",
          "screen_name": "jack"
        }
      },
      "createdAt": "2026-04-20T15:30:00.000Z"
    }
  ],
  "nextCursor": "cm9xyz789ghi012",
  "limit": 50,
  "backfillTriggered": false
}
Retrieve historical data that has been backfilled for tracked sources. Returns the full payload including the raw JSON data. Uses cursor-based pagination for efficient sequential consumption.
The history endpoint is rate-limited to 30 requests per 60 seconds.

​
Path Parameters

​
id
string
required
The internal ID of the tracked source (e.g., a cuid).

​
Query Parameters

​
messageId
string
Filter by a specific message ID (e.g. a tweet ID)
​
startDate
string
ISO-8601 date string. Only return records created on or after this date. Example: 2026-01-01
​
endDate
string
ISO-8601 date string. Only return records created on or before this date. Example: 2026-04-21
​
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.
​
autoBackfill
boolean
default:"false"
If true and no data exists, automatically triggers a background backfill job for the specified account.

​
Response

​
data
array
Array of backfill data objects. Each object contains: - id — Unique record ID - source — Source type (X, DISCORD, TELEGRAM) - messageId — External message ID (e.g. tweet ID) - sourceId — External source ID (e.g. X 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
​
backfillTriggered
boolean
true if an automatic background backfill was triggered because no data existed.
curl -X GET "https://scrape.st/account/history/clxyz123abc" \
  -H "x-api-key: YOUR_API_KEY"

{
  "data": [
    {
      "id": "cm9abc123def456",
      "source": "X",
      "messageId": "1886493083207827456",
      "sourceId": "12",
      "content": "Bitcoin hits new all-time high! 🚀",
      "rawPayload": {
        "id": "1886493083207827456",
        "text": "Bitcoin hits new all-time high! 🚀",
        "created_at": "2026-04-20T15:30:00.000Z",
        "favorite_count": 15000,
        "retweet_count": 3000,
        "reply_count": 800,
        "author": {
          "id": "12",
          "name": "Jack",
          "screen_name": "jack"
        }
      },
      "createdAt": "2026-04-20T15:30:00.000Z"
    }
  ],
  "nextCursor": "cm9xyz789ghi012",
  "limit": 50,
  "backfillTriggered": false
}