# Tweet lookup API - Veezee

Fetch a single tweet by id or URL: the text, full engagement metrics (views, likes, retweets, quotes, replies, bookmarks), language, and the quoted tweet inline when there is one. The id is the digits after /status/ in any tweet URL.

It costs 4 credits. The typical use is verification: confirm a tweet exists and check its engagement before citing it, or follow a quote chain hop by hop.

## Try it now

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

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

```
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`:

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

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `tweet_id` | yes | `string` | Numeric tweet id, e.g. '2054497961162478079', or a full tweet URL. |
| `freshness` | no | `string` | recent (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_credits` | no | `integer` | Spend 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: https://veezee.io/docs/fields#x_tweet

## Pricing

`x_get_tweet` costs 4 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/x_get_tweet). 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

**Does it return the replies underneath?**

No: one tweet per call. Search the conversation with [x_search](https://veezee.io/docs/tools/x_search) or read the author's timeline.

**Can I pass a full URL?**

Yes, tweet URLs are accepted; the [URL resolver](https://veezee.io/x-url-resolver) handles messier forms offline.

**Batch lookups?**

One tweet per call; loop client-side.

## Read next

- [x_get_tweet: the full reference](https://veezee.io/docs/tools/x_get_tweet)
- [X (formerly Twitter) API for AI agents](https://veezee.io/x-api-for-ai-agents)
- [Pricing](https://veezee.io/pricing)