Search APIs
Loading…
← API Store
Social

X (Twitter)

X (Twitter)

X user tweets

GET /twitter/v1/user/tweets
Test this endpoint

Every response includes credits_used: the credits this call cost.

X serves about 100 recent tweets to logged-out clients.

Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.

Parameters

NameTypeDescription
usernamerequiredstring Example: nasa
countintegerTweets per page, 1-100 (default 20).
cursorstringValue of `next_cursor` from the previous page.

Every endpoint also takes: raw、fields、fresh、output、records

{
  "cached": false,
  "count": 20,
  "credits_used": 1,
  "entry_ids": [
    "tweet-2113693409772761305",
    "tweet-2113655288687431819",
    "… 19 more"
  ],
  "instruction_types": [
    "TimelineClearCache",
    "TimelineAddEntries",
    "… 1 more"
  ],
  "next_cursor": "DAAHCgABHVVwLPE__-0LAAIAAAATMjExMDcxNzQ3MzM3Mjc0OTk4OQgAAwAAAAIAAA",
  "previous_cursor": "DAAHCgABHVVwLPFAJxELAAIAAAATMjExMzY5MzQwOTc3Mjc2MTMwNQgAAwAAAAEAAA",
  "tweets": [
    {
      "author": {
        "id": "11348282",
        "name": "NASA",
        "username": "NASA",
        "verified": true
      },
      "author_details": {
        "avatar": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_400x400.jpg",
        "bio": "Making the seemingly impossible, possible. ✨",
        "created_at": "Wed Dec 19 20:20:32 +0000 2007",
        "followers": 92310975,
        "following": 115,
        "location": "Pale Blue Dot",
        "protected": false,
        "verified_type": "Government"
      },
      "birdwatch_note": null,
      "bookmarks": 47,
      "card": {
        "name": "745291183405076480:broadcast",
        "url": "https://t.co/G1ya48yeun",
        "values": {
          "broadcast_height": "2160",
          "broadcast_id": "1RJZzBdZYQgJB",
          "broadcast_is_high_latency": true,
          "broadcast_media_id": "2113687037517975552",
          "broadcast_media_key": "28_2113687037517975552",
          "broadcast_orientation": "0",
          "broadcast_source": "LiveCms",
          "broadcast_state": "RUNNING",
          "broadcast_thumbnail": "https://pbs.twimg.com/card_img/2113718464175124480/f5wUkIqY?format=jpg&name=600x314",
          "broadcast_thumbnail_color": {
            "…": "1 fields"
          },
          "broadcast_thumbnail_large": "https://pbs.twimg.com/card_img/2113718464175124480/f5wUkIqY?format=jpg&name=800x419",
          "broadcast_thumbnail_original": "https://pbs.twimg.com/card_img/2113718464175124480/f5wUkIqY?format=jpg&name=orig",
          "broadcast_thumbnail_small": "https://pbs.twimg.com/card_img/2113718464175124480/f5wUkIqY?format=jpg&name=386x202",
          "broadcast_thumbnail_x_large": "https://pbs.twimg.com/card_img/2113718464175124480/f5wUkIqY?format=png&name=2048x2048_2_exp",
          "broadcast_title": "Artemis Acceleration",
          "broadcast_url": "https://x.com/i/broadcasts/1RJZzBdZYQgJB",
          "broadcast_width": "3840",
          "broadcaster_display_name": "NASA",
          "broadcaster_twitter_id": "11348282",
          "broadcaster_username": "NASA",
          "card_url": "https://t.co/G1ya48yeun",
          "site": "11348282"
        }
      },
      "community_id": null,
      "conversation_id": "2113693409772761305",
      "created_at": "Fri Oct 23 18:05:54 +0000 2026",
      "display_text_range": [
        0,
        196
      ],
      "edit": {
        "edit_tweet_ids": [
          "2113693409772761305"
        ],
        "editable_until": "2026-10-23T19:05:54.000Z",
        "edits_remaining": 5,
        "is_edit_eligible": true
      },
      "entities": {
        "hashtags": [],
        "mentions": [
          {
            "…": "4 fields"
          }
        ],
        "symbols": [],
        "urls": [
          {
            "…": "4 fields"
          }
        ]
      },
      "hashtags": [],
      "id": "2113693409772761305",
      "is_long": false,
      "is_quote": false,
      "is_retweet": false,
      "is_translatable": false,
      "lang": "en",
      "likes": 833,
      "links": [
        "https://x.com/i/broadcasts/1RJZzBdZYQgJB"
      ],
      "media": [],
      "mentions": [
        "NASAAdmin"
      ],
      "place": null,
      "possibly_sensitive": false,
      "quote_of": null,
      "quoted_tweet_id": null,
      "quotes": 24,
      "replies": 77,
      "reply_to": null,
      "reply_to_user": null,
      "reply_to_user_id": null,
      "retweet_of": null,
      "retweets": 194,
      "source": null,
      "text": "LIVE: @NASAAdmin and agency leaders are sharing the latest updates on next year's Artemis III mission and our plans to return astronauts to …",
      "url": "https://x.com/NASA/status/2113693409772761305",
      "user_id": "11348282",
      "views": 235708,
      "views_state": "EnabledWithCount",
      "…": "1 more fields"
    },
    {
      "author": {
        "id": "11348282",
        "name": "NASA",
        "username": "NASA",
        "verified": true
      },
      "author_details": {
        "avatar": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_400x400.jpg",
        "bio": "Making the seemingly impossible, possible. ✨",
        "created_at": "Wed Dec 19 20:20:32 +0000 2007",
        "followers": 92310975,
        "following": 115,
        "location": "Pale Blue Dot",
        "protected": false,
        "verified_type": "Government"
      },
      "birdwatch_note": null,
      "bookmarks": 159,
      "card": null,
      "community_id": null,
      "conversation_id": "2113655288687431819",
      "created_at": "Fri Oct 23 15:34:25 +0000 2026",
      "display_text_range": [
        0,
        238
      ],
      "edit": {
        "edit_tweet_ids": [
          "2113655288687431819"
        ],
        "editable_until": "2026-10-23T16:34:25.000Z",
        "edits_remaining": 5,
        "is_edit_eligible": true
      },
      "entities": {
        "hashtags": [],
        "mentions": [
          {
            "…": "4 fields"
          }
        ],
        "symbols": [],
        "urls": []
      },
      "hashtags": [],
      "id": "2113655288687431819",
      "is_long": false,
      "is_quote": false,
      "is_retweet": false,
      "is_translatable": false,
      "lang": "en",
      "likes": 2762,
      "links": [],
      "media": [
        {
          "allow_download": null,
          "alt_text": "Dynamic, textured clouds swoop across the scene. Their color ranges from deep, steely blue to bright silver. Pink and white stars of varying…",
          "aspect_ratio": null,
          "availability": "Available",
          "display_url": "pic.x.com/lhTssGyI5i",
          "expanded_url": "https://x.com/NASA/status/2113655288687431819/photo/1",
          "height": 941,
          "hls": null,
          "id": "2113655285982089216",
          "image_original": "https://pbs.twimg.com/media/HVU2SLKW0AA7q0a?format=jpg&name=orig",
          "media_key": "3_2113655285982089216",
          "monetizable": null,
          "short_url": "https://t.co/lhTssGyI5i",
          "sizes": {
            "…": "4 fields"
          },
          "source_user_id": null,
          "tagged_users": [],
          "type": "photo",
          "url": "https://pbs.twimg.com/media/HVU2SLKW0AA7q0a.jpg",
          "variants": [],
          "view_count": null,
          "width": 1041
        }
      ],
      "mentions": [
        "chandraxray"
      ],
      "place": null,
      "possibly_sensitive": false,
      "quote_of": null,
      "quoted_tweet_id": null,
      "quotes": 41,
      "replies": 125,
      "reply_to": null,
      "reply_to_user": null,
      "reply_to_user_id": null,
      "retweet_of": null,
      "retweets": 486,
      "source": null,
      "text": "Ahh… blue lagoon 🏖️\n\nThis deep-blue sea of gas and dust—called Messier 8 or the Lagoon Nebula—is a hotbed of star formation. The young stars…",
      "url": "https://x.com/NASA/status/2113655288687431819",
      "user_id": "11348282",
      "views": 302084,
      "views_state": "EnabledWithCount",
      "…": "1 more fields"
    },
    "… 18 more"
  ],
  "user_id": "11348282",
  "username": "nasa"
}
Response fields (131)

Field paths and types observed in the sample response; the live response is authoritative.

$object
$.cachedboolean
$.countinteger
$.credits_usedinteger
$.entry_idsarray
$.entry_ids[]string
$.instruction_typesarray
$.instruction_types[]string
$.next_cursorstring
$.previous_cursorstring
$.tweetsarray
$.tweets[]object | string
$.tweets[].authorobject
$.tweets[].author.idstring
$.tweets[].author.namestring
$.tweets[].author.usernamestring
$.tweets[].author.verifiedboolean
$.tweets[].author_detailsobject
$.tweets[].author_details.avatarstring
$.tweets[].author_details.biostring
$.tweets[].author_details.created_atstring
$.tweets[].author_details.followersinteger
$.tweets[].author_details.followinginteger
$.tweets[].author_details.locationstring
$.tweets[].author_details.protectedboolean
$.tweets[].author_details.verified_typestring
$.tweets[].birdwatch_notenull
$.tweets[].bookmarksinteger
$.tweets[].cardnull | object
$.tweets[].card.namestring
$.tweets[].card.urlstring
$.tweets[].card.valuesobject
$.tweets[].card.values.broadcast_heightstring
$.tweets[].card.values.broadcast_idstring
$.tweets[].card.values.broadcast_is_high_latencyboolean
$.tweets[].card.values.broadcast_media_idstring
$.tweets[].card.values.broadcast_media_keystring
$.tweets[].card.values.broadcast_orientationstring
$.tweets[].card.values.broadcast_sourcestring
$.tweets[].card.values.broadcast_statestring
$.tweets[].card.values.broadcast_thumbnailstring
$.tweets[].card.values.broadcast_thumbnail_colorobject
$.tweets[].card.values.broadcast_thumbnail_color.…string
$.tweets[].card.values.broadcast_thumbnail_largestring
$.tweets[].card.values.broadcast_thumbnail_originalstring
$.tweets[].card.values.broadcast_thumbnail_smallstring
$.tweets[].card.values.broadcast_thumbnail_x_largestring
$.tweets[].card.values.broadcast_titlestring
$.tweets[].card.values.broadcast_urlstring
$.tweets[].card.values.broadcast_widthstring
$.tweets[].card.values.broadcaster_display_namestring
$.tweets[].card.values.broadcaster_twitter_idstring
$.tweets[].card.values.broadcaster_usernamestring
$.tweets[].card.values.card_urlstring
$.tweets[].card.values.sitestring
$.tweets[].community_idnull
$.tweets[].conversation_idstring
$.tweets[].created_atstring
$.tweets[].display_text_rangearray
$.tweets[].display_text_range[]integer
$.tweets[].editobject
$.tweets[].edit.edit_tweet_idsarray
$.tweets[].edit.edit_tweet_ids[]string
$.tweets[].edit.editable_untilstring
$.tweets[].edit.edits_remaininginteger
$.tweets[].edit.is_edit_eligibleboolean
$.tweets[].entitiesobject
$.tweets[].entities.hashtagsarray
$.tweets[].entities.mentionsarray
$.tweets[].entities.mentions[]object
$.tweets[].entities.mentions[].…string
$.tweets[].entities.symbolsarray
$.tweets[].entities.urlsarray
$.tweets[].entities.urls[]object
$.tweets[].entities.urls[].…string
$.tweets[].hashtagsarray
$.tweets[].idstring
$.tweets[].is_longboolean
$.tweets[].is_quoteboolean
$.tweets[].is_retweetboolean
$.tweets[].is_translatableboolean
$.tweets[].langstring
$.tweets[].likesinteger
$.tweets[].linksarray
$.tweets[].links[]string
$.tweets[].mediaarray
$.tweets[].media[]object
$.tweets[].media[].allow_downloadnull
$.tweets[].media[].alt_textstring
$.tweets[].media[].aspect_rationull
$.tweets[].media[].availabilitystring
$.tweets[].media[].display_urlstring
$.tweets[].media[].expanded_urlstring
$.tweets[].media[].heightinteger
$.tweets[].media[].hlsnull
$.tweets[].media[].idstring
$.tweets[].media[].image_originalstring
$.tweets[].media[].media_keystring
$.tweets[].media[].monetizablenull
$.tweets[].media[].short_urlstring
$.tweets[].media[].sizesobject
$.tweets[].media[].sizes.…string
$.tweets[].media[].source_user_idnull
$.tweets[].media[].tagged_usersarray
$.tweets[].media[].typestring
$.tweets[].media[].urlstring
$.tweets[].media[].variantsarray
$.tweets[].media[].view_countnull
$.tweets[].media[].widthinteger
$.tweets[].mentionsarray
$.tweets[].mentions[]string
$.tweets[].placenull
$.tweets[].possibly_sensitiveboolean
$.tweets[].quote_ofnull
$.tweets[].quoted_tweet_idnull
$.tweets[].quotesinteger
$.tweets[].repliesinteger
$.tweets[].reply_tonull
$.tweets[].reply_to_usernull
$.tweets[].reply_to_user_idnull
$.tweets[].retweet_ofnull
$.tweets[].retweetsinteger
$.tweets[].sourcenull
$.tweets[].textstring
$.tweets[].urlstring
$.tweets[].user_idstring
$.tweets[].viewsinteger
$.tweets[].views_statestring
$.tweets[].…string
$.user_idstring
$.usernamestring