X (formerly Twitter)

Volume and recency: a deep chronological sweep across the whole platform, not just one community.

Tools#

x_search 6 credits: Search X (formerly Twitter).
x_get_profile 4 credits: Get an X profile.
x_get_tweets 4 credits: Get an account's tweets.
x_get_tweet 4 credits: Get one tweet with full metrics.
x_resolve_url 2 credits: Identify an X URL.

get_usage checks balance and works the same way across every platform: free, 0 credits. /docs/tools/get_usage.

Quickstart#

1. Get a free key#

Terminal

curl -s -X POST https://api.veezee.io/v1/keys/mint

One call returns a key (shown once) plus ready-made setup snippets. No account, no card. The CLI does this for you (npx @veezee/sdk init) and stores the key in ~/.veezee/config.

2. Call the API#

Terminal

curl "https://api.veezee.io/v1/x/profiles?identifier=nasa" \
  -H "Authorization: Bearer $VEEZEE_API_KEY"

The free key includes 200 credits per IP per day, recent data only. If you call without a key, the error response tells you exactly how to get one, so an agent recovers on its own in one round-trip.

3. Or connect over MCP#

MCP endpoint

https://mcp.veezee.io/x

transport: streamable-http, same free budget as REST. Claude Code, claude.ai, and other clients that support the MCP authorization spec open a browser sign-in automatically (email code, no password, no card, no key to copy). Other clients: put the key from step 1 in your MCP client's connection headers.

4. Need more than the free budget? Buy credits#

Pick a pack at /upgrade and pay: checkout credits the same key, so nothing needs reconfiguring.

Send the key as Authorization: Bearer <api_key> on every REST call, or in your MCP client's connection headers. Paid calls also send an Idempotency-Key header (any unique string per call) so a retried call is never billed twice.

What comes back#

x_search, x_profile, x_tweets, x_tweet, url_resolution. Full field lists: /docs/fields.

Limits#

No batch tweet lookup: x_get_tweet fetches one tweet at a time.
t.co links cannot be resolved offline: x_resolve_url returns INVALID_INPUT for them; expand them in a browser step first.
People search returns a single page: x_search type=people has no cursor.

Other platforms: LinkedIn, Reddit.

X (formerly Twitter) API for AI agents: /x-api-for-ai-agents.

Full tool reference: /docs.