latestOpenAPI 3.1.02026-08-19127114508.9 KB

da40606c043a

Tweets

Get tweet with full text, author, metrics and media

Get tweet with full text, author, metrics and media.

get/api/v1/x/tweets/{id}

Path parameters

idstring required

Numeric tweet ID, 15-20 digits

Response

Tweet with author

Example response

{
  "tweet": {
    "id": "1234567890",
    "text": "Just launched our new feature!",
    "type": "tweet",
    "createdAt": "2025-01-15T12:00:00Z",
    "url": "https://x.com/example_user/status/1234567890",
    "lang": "en",
    "inReplyToId": "1234567890",
    "inReplyToUserId": "9876543210",
    "inReplyToUsername": "example_user",
    "conversationId": "1234567890",
    "conversationControl": {
      "policy": "by_invitation"
    },
    "limitedActions": [
      {
        "action": "Reply",
        "prompt": {
          "ctaType": "SeeConversation"
        }
      }
    ],
    "source": "Twitter Web App",
    "displayTextRange": [
      0,
      31
    ],
    "contentDisclosure": {
      "advertising": {
        "isPaidPromotion": true
      },
      "aiGenerated": {
        "detectionSource": "UserDeclared",
        "hasAiGeneratedMedia": true
      }
    },
    "card": {
      "userReferences": [
        {
          "id": "9876543210",
          "username": "elonmusk",
          "name": "Elon Musk",
          "description": "CEO of Tesla, SpaceX, and X",
          "followers": 150000000,
          "following": 500,
          "verified": true,
          "isBlueVerified": true,
          "isVerified": true,
          "profilePicture": "https://pbs.twimg.com/profile_images/example.jpg",
          "coverPicture": "https://pbs.twimg.com/profile_banners/example.jpg",
          "profileBannerUrl": "https://pbs.twimg.com/profile_banners/example.jpg",
          "location": "Austin, TX",
          "createdAt": "2009-06-02T20:12:29Z",
          "statusesCount": 35000,
          "mediaCount": 1200,
          "url": "https://xquik.com",
          "favouritesCount": 18000,
          "hasCustomTimelines": true,
          "withheldInCountries": [
            "DE"
          ],
          "withheldScope": "user",
          "pinnedTweetIds": [
            "1234567890"
          ],
          "automatedBy": "example_user",
          "unavailableReason": "suspended",
          "verifiedType": "Business",
          "communityRole": "Member"
        }
      ]
    },
    "quoted_tweet": {
      "id": "1234567890",
      "text": "Just launched our new feature!",
      "type": "tweet",
      "createdAt": "2025-01-15T12:00:00Z",
      "url": "https://x.com/example_user/status/1234567890",
      "lang": "en",
      "inReplyToId": "1234567890",
      "inReplyToUserId": "9876543210",
      "inReplyToUsername": "example_user",
      "conversationId": "1234567890",
      "conversationControl": {
        "policy": "by_invitation"
      },
      "limitedActions": [
        {
          "action": "Reply",
          "prompt": {
            "ctaType": "SeeConversation"
          }
        }
      ],
      "source": "Twitter Web App",
      "displayTextRange": [
        0,
        31
      ],
      "contentDisclosure": {
        "advertising": {
          "isPaidPromotion": true
        },
        "aiGenerated": {
          "detectionSource": "UserDeclared",
          "hasAiGeneratedMedia": true
        }
      },
      "card": {
        "userReferences": [
          {
            "id": "9876543210",
            "username": "elonmusk",
            "name": "Elon Musk",
            "description": "CEO of Tesla, SpaceX, and X",
            "followers": 150000000,
            "following": 500,
            "verified": true,
            "isBlueVerified": true,
            "isVerified": true,
            "profilePicture": "https://pbs.twimg.com/profile_images/example.jpg",
            "coverPicture": "https://pbs.twimg.com/profile_banners/example.jpg",
            "profileBannerUrl": "https://pbs.twimg.com/profile_banners/example.jpg",
            "location": "Austin, TX",
            "createdAt": "2009-06-02T20:12:29Z",
            "statusesCount": 35000,
            "mediaCount": 1200,
            "url": "https://xquik.com",
            "favouritesCount": 18000,
            "hasCustomTimelines": true,
            "withheldInCountries": [
              "DE"
            ],
            "withheldScope": "user",
            "pinnedTweetIds": [
              "1234567890"
            ],
            "automatedBy": "example_user",
            "unavailableReason": "suspended",
            "verifiedType": "Business",
            "communityRole": "Member"
          }
        ]
      },
      "retweetCount": 5,
      "replyCount": 3,
      "likeCount": 42,
      "quoteCount": 1,
      "viewCount": 1500,
      "bookmarkCount": 2,
      "author": {
        "id": "9876543210",
        "username": "elonmusk",
        "name": "Elon Musk",
        "description": "CEO of Tesla, SpaceX, and X",
        "followers": 150000000,
        "following": 500,
        "verified": true,
        "isBlueVerified": true,
        "isVerified": true,
        "profilePicture": "https://pbs.twimg.com/profile_images/example.jpg",
        "coverPicture": "https://pbs.twimg.com/profile_banners/example.jpg",
        "profileBannerUrl": "https://pbs.twimg.com/profile_banners/example.jpg",
        "location": "Austin, TX",
        "createdAt": "2009-06-02T20:12:29Z",
        "statusesCount": 35000,
        "mediaCount": 1200,
        "url": "https://xquik.com",
        "favouritesCount": 18000,
        "hasCustomTimelines": true,
        "withheldInCountries": [
          "DE"
        ],
        "withheldScope": "user",
        "pinnedTweetIds": [
          "1234567890"
        ],
        "automatedBy": "example_user",
        "unavailableReason": "suspended",
        "verifiedType": "Business",
        "communityRole": "Member"
      }
    },
    "retweeted_tweet": {
      "id": "1234567890",
      "text": "Just launched our new feature!",
      "type": "tweet",
      "createdAt": "2025-01-15T12:00:00Z",
      "url": "https://x.com/example_user/status/1234567890",
      "lang": "en",
      "inReplyToId": "1234567890",
      "inReplyToUserId": "9876543210",
      "inReplyToUsername": "example_user",
      "conversationId": "1234567890",
      "conversationControl": {
        "policy": "by_invitation"
      },
      "limitedActions": [
        {
          "action": "Reply",
          "prompt": {
            "ctaType": "SeeConversation"
          }
        }
      ],
      "source": "Twitter Web App",
      "displayTextRange": [
        0,
        31
      ],
      "contentDisclosure": {
        "advertising": {
          "isPaidPromotion": true
        },
        "aiGenerated": {
          "detectionSource": "UserDeclared",
          "hasAiGeneratedMedia": true
        }
      },
      "card": {
        "userReferences": [
          {
            "id": "9876543210",
            "username": "elonmusk",
            "name": "Elon Musk",
            "description": "CEO of Tesla, SpaceX, and X",
            "followers": 150000000,
            "following": 500,
            "verified": true,
            "isBlueVerified": true,
            "isVerified": true,
            "profilePicture": "https://pbs.twimg.com/profile_images/example.jpg",
            "coverPicture": "https://pbs.twimg.com/profile_banners/example.jpg",
            "profileBannerUrl": "https://pbs.twimg.com/profile_banners/example.jpg",
            "location": "Austin, TX",
            "createdAt": "2009-06-02T20:12:29Z",
            "statusesCount": 35000,
            "mediaCount": 1200,
            "url": "https://xquik.com",
            "favouritesCount": 18000,
            "hasCustomTimelines": true,
            "withheldInCountries": [
              "DE"
            ],
            "withheldScope": "user",
            "pinnedTweetIds": [
              "1234567890"
            ],
            "automatedBy": "example_user",
            "unavailableReason": "suspended",
            "verifiedType": "Business",
            "communityRole": "Member"
          }
        ]
      },
      "retweetCount": 5,
      "replyCount": 3,
      "likeCount": 42,
      "quoteCount": 1,
      "viewCount": 1500,
      "bookmarkCount": 2,
      "author": {
        "id": "9876543210",
        "username": "elonmusk",
        "name": "Elon Musk",
        "description": "CEO of Tesla, SpaceX, and X",
        "followers": 150000000,
        "following": 500,
        "verified": true,
        "isBlueVerified": true,
        "isVerified": true,
        "profilePicture": "https://pbs.twimg.com/profile_images/example.jpg",
        "coverPicture": "https://pbs.twimg.com/profile_banners/example.jpg",
        "profileBannerUrl": "https://pbs.twimg.com/profile_banners/example.jpg",
        "location": "Austin, TX",
        "createdAt": "2009-06-02T20:12:29Z",
        "statusesCount": 35000,
        "mediaCount": 1200,
        "url": "https://xquik.com",
        "favouritesCount": 18000,
        "hasCustomTimelines": true,
        "withheldInCountries": [
          "DE"
        ],
        "withheldScope": "user",
        "pinnedTweetIds": [
          "1234567890"
        ],
        "automatedBy": "example_user",
        "unavailableReason": "suspended",
        "verifiedType": "Business",
        "communityRole": "Member"
      }
    },
    "retweetCount": 5,
    "replyCount": 3,
    "likeCount": 42,
    "quoteCount": 1,
    "viewCount": 1500,
    "bookmarkCount": 2,
    "author": {
      "id": "9876543210",
      "username": "elonmusk",
      "name": "Elon Musk",
      "followers": 150000000,
      "verified": true
    }
  },
  "author": {
    "id": "9876543210",
    "username": "elonmusk",
    "name": "Elon Musk",
    "followers": 150000000,
    "verified": true
  }
}