XFlux
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. 1

    Get a free API key

    Dashboard → API Keys. Details: /free-x-api.

  2. 2

    GET /api/v1/users/:username

    Example: /api/v1/users/x

  3. 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/x

FAQ

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).

Twitter User Lookup API — Profile by @username | XFlux