Twitter timeline API for one public account
Pull recent public tweets for an @handle without the official X user-timeline product. One GET on XFlux, or the MCP tool xflux_get_user_tweets. Free tier: 1,000 calls/month. Always-on watches belong on monitors, not a polling loop.
One handle, one call
GET /api/v1/users/:username/tweets?limit=10 returns compact public tweets for that account.
Same key as search and profiles
Timelines, lookup, and search share the monthly quota. Monitor polling does not.
Agents use the MCP tool
Claude and Cursor call xflux_get_user_tweets. Install: /mcp.
Fetch a timeline
- 1
Create a free key
Register → Dashboard → API Keys. No credit card on Free.
- 2
GET the username path
Example: /api/v1/users/FederalReserve/tweets?limit=10
- 3
Switch to a monitor for alerts
If you need every new post pushed to Slack or HTTPS, use /monitor-twitter-account instead of cron + timeline.
curl
Public accounts only. limit caps how many tweets come back.
curl -H "Authorization: Bearer xflux_YOUR_KEY" \
"https://www.xfluxapi.com/api/v1/users/FederalReserve/tweets?limit=10"FAQ
- Is this the official X user timeline endpoint?
- No. XFlux is an independent read API. The path is /api/v1/users/:username/tweets on www.xfluxapi.com.
- Private or protected accounts?
- Public posts only. Protected accounts are not available.
- Timeline vs search?
- Timeline is one account’s recent posts. Search is a query (from:, lang:, phrases) across public tweets — see /twitter-search-api.
Related guides
Try account monitors free
Free includes 1 monitor and Dashboard hit history. Live webhook delivery starts on Starter ($19/mo).