Veezee

Tweet metrics API 4 credits

Get a tweet's complete engagement picture in one call: views, likes, retweets, quotes, replies, and bookmarks, the numbers reporting, creator vetting, and citation checks need. When the tweet quotes another, the quoted tweet arrives inline.

Each tweet costs 4 credits. For an account-level view, follower counts and tweet totals, use the profile API instead.

Try it now#

No account, no card: mint a free key in one call, then call the endpoint.

Terminal
curl -s -X POST https://api.veezee.io/v1/keys/mint
Request
curl "https://api.veezee.io/v1/x/tweet?tweet_id=2054497961162478079" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

Over MCP#

Point an MCP client at https://mcp.veezee.io/x (streamable-http; https://mcp.veezee.io/all serves every platform over one connection) and call x_get_tweet:

tools/call
{
  "method": "tools/call",
  "params": {
    "name": "x_get_tweet",
    "arguments": {
      "tweet_id": "2054497961162478079"
    }
  }
}

Parameters#

ParamRequiredTypeDescription
tweet_idyesstringNumeric tweet id, e.g. '2054497961162478079', or a full tweet URL.
freshnessnostringrecent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it.
max_creditsnointegerSpend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling.

Returns a x_tweet envelope. Full field list: /docs/fields#x_tweet.

Pricing#

x_get_tweet costs 4 credits base per call (surcharges for optional sections, cursor pages, and batches are in the full reference). Every key starts with a free budget of 200 credits per IP per day, no account, no card; past that, credits are $2.00 per 1,000 with no subscription required.

FAQ#

Can I get metrics over time?

The call returns the numbers as of now; poll on a schedule and store snapshots to build a curve.

Metrics for every tweet in a timeline?

User tweets pages carry summary engagement counts; fetch individual tweets when you need the full set including views and bookmarks.

Which metrics are included?

Views, likes, retweets, quotes, replies, bookmarks, and language, per tweet.

Read next#