Identify an X URL

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.

get/v1/x/resolve-url

Request

  • Base URL: https://api.veezee.io
  • URL: https://api.veezee.io/v1/x/resolve-url
  • Auth: HTTP bearer

Query parameters

urlstring required

An X URL, e.g. https://x.com/nasa/status/2054497961162478079 or https://twitter.com/nasa.

Headers

Idempotency-Keystring

Required on paid-key calls; free-tier trial-key calls do not need it. Unique key per logical call (UUID recommended). Reuse the SAME key when retrying the same call; a replay returns the stored result without charging again. Reusing a key with different arguments returns IDEMPOTENCY_KEY_REUSED.

Response

url_resolution envelope (schema_version 2)

entity'url_resolution' required
platform'linkedin' | 'reddit' | 'x' nullable required
canonical_urlstring nullable required
data_as_ofstring nullable required
schema_version'2' required
platform_fieldsobject required

Changes

No recorded changes to this operation across all 1 revision of this API.