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 '{"sid": "12"}'

{
  "status": "queued",
  "sid": "12",
  "source": "TWITTER",
  "account": {
    "username": "jack",
    "name": "Jack Dorsey"
  }
}
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

​
sid
string
required
The external ID of the account to backfill (e.g., a Twitter User ID).

​
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.
​
sid
string
The requested external ID.
​
source
string
The resolved source platform (e.g. TWITTER).
​
account
object
Basic information about the account matched.
  • username — The platform username.
  • name — The display name.
​
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 '{"sid": "12"}'

{
  "status": "queued",
  "sid": "12",
  "source": "TWITTER",
  "account": {
    "username": "jack",
    "name": "Jack Dorsey"
  }
}