Twitter Engagement

Look up a tweet

Resolve a single tweet by ID or URL into its text, author and public metrics.

Use this to render a post you are referencing, e.g. the tweet quoted by a quote-style post. Unlike /v1/twitter/search this is not limited to the last 7 days and works for any tweet visible to the connected account.

Billed as an X posts read ($0.005). Repeat lookups of the same tweet within the same UTC day are charged once.

get/v1/twitter/tweet

Query parameters

accountIdstring required

The account ID whose X token is used for the lookup

tweetIdstring required

Numeric tweet ID or a tweet URL (e.g. https://x.com/user/status/123...). The same name the other /v1/twitter operations use (retweet, bookmark).

idstring

Alias of tweetId, kept for existing callers

Response

The resolved tweet

statusstring

Example response

{
  "status": "success",
  "tweet": {
    "platform": "twitter"
  }
}

Changes

Changed in 3 of the 56 revisions of this API.25

  • dd3865482f9f22See the full diff
    • ▲

      added the new required query request parameter tweetId

      new-required-request-parameter

    • ▲

      removed the media type application/json for the response with the status

      response-media-type-removed

    • ○

      the query request parameter id became optional

      request-parameter-became-optional

    • ○

      query request parameter id was deprecated

      request-parameter-deprecated

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added