Identify an X URL
x_resolve_urlIdentify whether an X (Twitter) URL points to a profile or tweet, returning the handle or numeric ID for use with other X tools. Works offline without fetching the page.
Instructions
Identify what an X (formerly Twitter) URL points at before fetching it. Give any x.com or twitter.com URL (mobile links, query params, /i/web/status forms are fine); get back {type: profile|tweet, id, handle, canonical_url}. Tweet URLs yield the numeric id for x_get_tweet; profile URLs yield the handle for x_get_profile or x_get_tweets. Costs 2 credits and parses offline without fetching the page. t.co short links cannot be expanded offline and return INVALID_INPUT telling you so; expand them in your own browser step first. Skip this tool when you already have a handle or tweet id: the other X tools accept those directly.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | An X URL, e.g. https://x.com/nasa/status/2054497961162478079 or https://twitter.com/nasa. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| usage | Yes | ||
| common | Yes | ||
| entity | Yes | ||
| platform | Yes | ||
| freshness | Yes | ||
| data_as_of | Yes | ||
| canonical_url | Yes | ||
| schema_version | Yes | ||
| platform_fields | Yes |