API Reference

Base URL

https://api.scrapetwitter.com

No authentication required for self-hosted instances.

Pagination

All list endpoints support cursor-based pagination:

• Omit cursor for the first page
• Pass next_cursor from the response for subsequent pages
• Each page returns ~20 items
• Keep paginating until has_more is false

Rate Limits

Per account, per 15-minute window:

With N accounts in the pool, effective limits are N × the above.

Error Responses

400 - Bad Request

{
  "error": "Missing required query param: q"
}

429 - Rate Limited

{
  "error": "All accounts exhausted for SearchTimeline. Retry after 120s",
  "retry_after": 120
}

500 - Server Error

{
  "error": "HTTP 503: Service Unavailable"
}