History API
History API documentation for replaying TweetStream events on supported plans, including auth, request shape, response shape, and replay use cases.
Direct answer
The History API is an Elite and Enterprise replay surface for authenticated review and recovery of stored TweetStream events.
Example request
Call GET https://api.tweetstream.io/api/history?handle=example with Authorization: Bearer <API_KEY>. Filter by handles your plan tracks and keep client replay idempotent.
Response behavior
Responses return stored social events with author, text, timestamps, and available enrichment fields. Treat replay as recovery and review, not as a guaranteed replacement for live streaming.
Replay use cases
Use history for missed-connection recovery, incident review, strategy backtests, and Discord or bot reconciliation after downstream downtime.
- Replay after a reconnect window
- Audit what a bot received during an incident
- Review alerts that matched a handle or keyword
Questions
Start real-time Twitter WebSocket alerts today
WebSocket delivery, OCR, and token detection - no infrastructure to build.
Start 3-Day TrialFrom $199/mo · Basic/Elite 3-day trial · OCR + token detection included