User lookup
Twitter user lookup API by @username
Resolve a public profile before you pull a timeline or add a monitor. XFlux GET /api/v1/users/:username returns a compact profile. Free: 1,000 calls/month, no credit card. MCP tool: xflux_get_user.
Username, not a numeric id dance
Pass the @handle. You do not need a separate id lookup to read the public profile.
Then timeline or monitor
Same key calls /users/:username/tweets or creates a Dashboard monitor for that handle.
Read-only
Lookup does not follow, post, or DM. Public data only.
Look up a profile
- 1
Get a free API key
Dashboard → API Keys. Details: /free-x-api.
- 2
GET /api/v1/users/:username
Example: /api/v1/users/x
- 3
Use the handle downstream
Timeline: /twitter-timeline-api. Alerts: /monitor-twitter-account.
curl
curl -H "Authorization: Bearer xflux_YOUR_KEY" \
https://www.xfluxapi.com/api/v1/users/xFAQ
- Does this return followers or following lists?
- No. This call is the public profile summary. It is not a followers, following, or list endpoint.
- Official X user lookup?
- No. XFlux is independent. Compare pricing at /docs/compare/pricing.
- Can an agent call this?
- Yes. Tool name xflux_get_user. Setup: /mcp.
Related guides
Try account monitors free
Free includes 1 monitor and Dashboard hit history. Live webhook delivery starts on Starter ($19/mo).