Skip to main content
GET
/
v1
/
twitter
/
tweets
/
tweet
/
{tweet_id}
Get tweet details
curl --request GET \
  --url https://scrapebadger.com/v1/twitter/tweets/tweet/{tweet_id} \
  --header 'x-api-key: <api-key>'
{
  "id": "1234567890123456789",
  "text": "Hello, world! This is a tweet.",
  "created_at": "Wed Oct 10 20:19:24 +0000 2018",
  "full_text": "<string>",
  "lang": "en",
  "user_id": "44196397",
  "username": "elonmusk",
  "user_name": "Elon Musk",
  "favorite_count": 0,
  "retweet_count": 0,
  "reply_count": 0,
  "quote_count": 0,
  "view_count": 123,
  "bookmark_count": 123,
  "favorited": false,
  "retweeted": false,
  "bookmarked": false,
  "possibly_sensitive": false,
  "is_quote_status": false,
  "is_retweet": false,
  "conversation_id": "<string>",
  "in_reply_to_status_id": "<string>",
  "in_reply_to_user_id": "<string>",
  "media": [
    {
      "media_key": "<string>",
      "type": "photo",
      "url": "<string>",
      "preview_image_url": "<string>",
      "width": 123,
      "height": 123,
      "duration_ms": 123,
      "view_count": 123,
      "alt_text": "<string>"
    }
  ],
  "urls": [
    {
      "url": "<string>",
      "expanded_url": "<string>",
      "display_url": "<string>",
      "unwound_url": "<string>"
    }
  ],
  "hashtags": [
    {
      "text": "AI",
      "indices": [
        123
      ]
    }
  ],
  "user_mentions": [
    {
      "id": "<string>",
      "username": "<string>",
      "name": "<string>",
      "indices": [
        123
      ]
    }
  ],
  "poll": {
    "id": "<string>",
    "voting_status": "open",
    "end_datetime": "<string>",
    "duration_minutes": 123,
    "options": [
      {
        "position": 123,
        "label": "<string>",
        "votes": 123
      }
    ]
  },
  "place": {
    "id": "<string>",
    "full_name": "San Francisco, CA",
    "name": "San Francisco",
    "country": "United States",
    "country_code": "US",
    "place_type": "city"
  },
  "quoted_status_id": "<string>",
  "retweeted_status_id": "<string>",
  "edit_tweet_ids": [
    "<string>"
  ],
  "editable_until_msecs": 123,
  "edits_remaining": 123,
  "is_edit_eligible": true,
  "has_card": true,
  "thumbnail_url": "<string>",
  "thumbnail_title": "<string>",
  "has_community_notes": true,
  "source": "Twitter Web App"
}

Authorizations

x-api-key
string
header
required

Your ScrapeBadger API key. You can find this in your dashboard at https://scrapebadger.com/dashboard/api-keys.

Path Parameters

tweet_id
string
required

The unique numeric ID of the tweet.

Example:

"1234567890123456789"

Query Parameters

cursor
string

Pagination cursor from a previous response for fetching additional data.

Response

Successfully retrieved tweet details.

Comprehensive tweet data including text, author info, engagement metrics, media, and metadata.

id
string
required

Unique tweet identifier.

Example:

"1234567890123456789"

text
string
required

The tweet text content.

Example:

"Hello, world! This is a tweet."

created_at
string
required

Timestamp when the tweet was created.

Example:

"Wed Oct 10 20:19:24 +0000 2018"

full_text
string | null

Full text of the tweet, including extended content beyond 280 characters.

lang
string | null

BCP 47 language tag of the tweet content.

Example:

"en"

user_id
string | null

Numeric ID of the tweet author.

Example:

"44196397"

username
string | null

Username (screen name) of the tweet author.

Example:

"elonmusk"

user_name
string | null

Display name of the tweet author.

Example:

"Elon Musk"

favorite_count
integer
default:0

Number of times this tweet has been liked.

retweet_count
integer
default:0

Number of times this tweet has been retweeted.

reply_count
integer
default:0

Number of replies to this tweet.

quote_count
integer
default:0

Number of times this tweet has been quoted.

view_count
integer | null

Number of times this tweet has been viewed.

bookmark_count
integer | null

Number of times this tweet has been bookmarked.

favorited
boolean
default:false

Whether the authenticated user has liked this tweet.

retweeted
boolean
default:false

Whether the authenticated user has retweeted this tweet.

bookmarked
boolean
default:false

Whether the authenticated user has bookmarked this tweet.

possibly_sensitive
boolean
default:false

Whether the tweet is flagged as possibly containing sensitive content.

is_quote_status
boolean
default:false

Whether the tweet is a quote tweet.

is_retweet
boolean
default:false

Whether the tweet is a retweet.

conversation_id
string | null

ID of the conversation thread this tweet belongs to.

in_reply_to_status_id
string | null

ID of the tweet this is a reply to, if applicable.

in_reply_to_user_id
string | null

ID of the user this tweet is replying to.

media
object[]

Media attachments (photos, videos, GIFs).

urls
object[]

URLs mentioned in the tweet.

hashtags
object[]

Hashtags in the tweet.

user_mentions
object[]

Users mentioned in the tweet.

poll
object

Poll data if the tweet contains a poll.

place
object

Geographic place associated with the tweet.

quoted_status_id
string | null

ID of the quoted tweet, if this is a quote tweet.

retweeted_status_id
string | null

ID of the original tweet, if this is a retweet.

edit_tweet_ids
string[] | null

List of tweet IDs in the edit chain.

editable_until_msecs
integer | null

Timestamp (milliseconds) until the tweet can be edited.

edits_remaining
integer | null

Number of remaining edits allowed.

is_edit_eligible
boolean | null

Whether the tweet is eligible for editing.

has_card
boolean | null

Whether the tweet has a link preview card.

thumbnail_url
string | null

URL of the link preview thumbnail.

thumbnail_title
string | null

Title of the link preview card.

has_community_notes
boolean | null

Whether the tweet has community notes attached.

source
string | null

Client application used to post the tweet.

Example:

"Twitter Web App"