Get one tweet with full metrics

Fetch one tweet by id with full engagement metrics: views, likes, retweets, quotes, replies, bookmarks, language, and the quoted tweet inline when there is one. tweet_id is the numeric id from a tweet URL (the digits after /status/) or from any other X tool's results; full tweet URLs are accepted too. Costs 4 credits. Use this to verify engagement before citing a tweet or to read a quoted thread hop by hop. It returns a single tweet, not the conversation around it: for the author's other tweets use x_get_tweets, and to find tweets by topic use x_search.

get/v1/x/tweet

Request

  • Base URL: https://api.veezee.io
  • URL: https://api.veezee.io/v1/x/tweet
  • Auth: HTTP bearer

Query parameters

tweet_idstring required

Numeric tweet id, e.g. '2054497961162478079', or a full tweet URL.

freshness'recent' | 'realtime'

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_creditsinteger

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.

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

x_tweet envelope (schema_version 2)

entity'x_tweet' 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.