Backfill
Get Account History
Query historical data for tracked sources
GET
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
string
required
The internal ID of the tracked source (e.g., a cuid).
Query Parameters
string
Filter by a specific message ID (e.g. a tweet ID)
string
ISO-8601 date string. Only return records created on or after this date.
Example:
2026-01-01string
ISO-8601 date string. Only return records created on or before this date.
Example:
2026-04-21string
default:"desc"
Sort order by creation date. Valid values:
asc, descnumber
default:"50"
Number of records to return per page (1–100)
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.boolean
default:"false"
If
true and no data exists, automatically triggers a background backfill job
for the specified account.Response
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 messagestring | null
Cursor for fetching the next page.
null when there are no more results.number
The limit that was applied
boolean
true if an automatic background backfill was triggered because no data
existed.