Fetch Twitter threads with their replies or search across Twitter for tweets.
Available Tools
| Tool | Endpoint | Credits |
|---|---|---|
| Thread | /api/v1/tools/twitter/thread | 2 |
| Search | /api/v1/tools/twitter/search | 2 |
| User Tweets | /api/v1/tools/twitter/user-tweets | 2 |
| User Info | /api/v1/tools/twitter/user-info | 1 |
Authentication
All tool endpoints use the same Authorization header as the scrape API:
Authorization: Bearer sc_live_your_key_here
Response Format
Every tool returns a consistent envelope with data and meta fields:
{
"data": { ... },
"meta": {
"tool": "twitter-thread",
"creditsUsed": 2,
"requestId": "req_abc123"
}
}
Credit cost and request ID are also returned in response headers: X-Request-Cost, X-Remaining-Credits, X-Request-Id.