Skip to main content
PUT
/
backfill
curl -X PUT "https://scrape.st/backfill" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id": "clxyz123abc"}'

{
  "status": "queued",
  "id": "clxyz123abc",
  "externalId": "12",
  "source": "x"
}
Manually trigger a background job to backfill historical data for a specific account. This endpoint enqueues a job on the BullMQ backfill queue.
This endpoint is rate-limited to 5 requests per 60 seconds.

​
Body Parameters

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

​
Response

Returns 202 Accepted if the backfill has been queued successfully, or 409 Conflict if a backfill is already in progress for this account.
​
status
string
The status of the operation, usually queued or conflict.
​
id
string
The requested internal ID.
​
externalId
string
The resolved external ID from the source account.
​
source
string
The resolved source platform (e.g. x).
​
progress
object
Returned only when a 409 Conflict happens. Details about the current progress of the ongoing backfill.
curl -X PUT "https://scrape.st/backfill" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id": "clxyz123abc"}'

{
  "status": "queued",
  "id": "clxyz123abc",
  "externalId": "12",
  "source": "x"
}