# X URL resolver - Veezee

Classify any x.com or twitter.com URL, mobile links, query params, /i/web/status forms, as a profile or a tweet, and get the handle or numeric id the other X endpoints need. It parses offline without fetching the page.

It costs 2 credits. Skip it when you already hold a handle or tweet id: the fetch tools accept those directly.

## 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/resolve-url?url=https%3A%2F%2Fx.com%2Fnasa%2Fstatus%2F2054497961162478079" \
  -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_resolve_url`:

```json
{
  "method": "tools/call",
  "params": {
    "name": "x_resolve_url",
    "arguments": {
      "url": "https://x.com/nasa/status/2054497961162478079"
    }
  }
}
```

## Parameters

| Param | Required | Type | Description |
| --- | --- | --- | --- |
| `url` | yes | `string` | An X URL, e.g. https://x.com/nasa/status/2054497961162478079 or https://twitter.com/nasa. |

Returns a `url_resolution` envelope. Full field list: https://veezee.io/docs/fields#url_resolution

## Pricing

`x_resolve_url` costs 2 credits base per call (surcharges for optional sections, cursor pages, and batches: https://veezee.io/docs/tools/x_resolve_url). 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 it expand t.co short links?**

No: t.co can't be expanded offline, and the call returns INVALID_INPUT saying so. Expand the link in your own fetch step first.

**Do old twitter.com URLs work?**

Yes, both domains and their mobile forms.

**What next per result type?**

tweet goes to the [tweet lookup API](https://veezee.io/tweet-lookup-api); profile to the [profile API](https://veezee.io/twitter-profile-api) or [timeline](https://veezee.io/user-tweets-api).

## Read next

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