← API Store
Social
X (Twitter)
X (Twitter)
X user tweets
GET /twitter/v1/user/tweetsEvery 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
| Name | Type | Description |
|---|---|---|
usernamerequired | string | Example: nasa |
count | integer | Tweets per page, 1-100 (default 20). |
cursor | string | Value 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 |
$.cached | boolean |
$.count | integer |
$.credits_used | integer |
$.entry_ids | array |
$.entry_ids[] | string |
$.instruction_types | array |
$.instruction_types[] | string |
$.next_cursor | string |
$.previous_cursor | string |
$.tweets | array |
$.tweets[] | object | string |
$.tweets[].author | object |
$.tweets[].author.id | string |
$.tweets[].author.name | string |
$.tweets[].author.username | string |
$.tweets[].author.verified | boolean |
$.tweets[].author_details | object |
$.tweets[].author_details.avatar | string |
$.tweets[].author_details.bio | string |
$.tweets[].author_details.created_at | string |
$.tweets[].author_details.followers | integer |
$.tweets[].author_details.following | integer |
$.tweets[].author_details.location | string |
$.tweets[].author_details.protected | boolean |
$.tweets[].author_details.verified_type | string |
$.tweets[].birdwatch_note | null |
$.tweets[].bookmarks | integer |
$.tweets[].card | null | object |
$.tweets[].card.name | string |
$.tweets[].card.url | string |
$.tweets[].card.values | object |
$.tweets[].card.values.broadcast_height | string |
$.tweets[].card.values.broadcast_id | string |
$.tweets[].card.values.broadcast_is_high_latency | boolean |
$.tweets[].card.values.broadcast_media_id | string |
$.tweets[].card.values.broadcast_media_key | string |
$.tweets[].card.values.broadcast_orientation | string |
$.tweets[].card.values.broadcast_source | string |
$.tweets[].card.values.broadcast_state | string |
$.tweets[].card.values.broadcast_thumbnail | string |
$.tweets[].card.values.broadcast_thumbnail_color | object |
$.tweets[].card.values.broadcast_thumbnail_color.… | string |
$.tweets[].card.values.broadcast_thumbnail_large | string |
$.tweets[].card.values.broadcast_thumbnail_original | string |
$.tweets[].card.values.broadcast_thumbnail_small | string |
$.tweets[].card.values.broadcast_thumbnail_x_large | string |
$.tweets[].card.values.broadcast_title | string |
$.tweets[].card.values.broadcast_url | string |
$.tweets[].card.values.broadcast_width | string |
$.tweets[].card.values.broadcaster_display_name | string |
$.tweets[].card.values.broadcaster_twitter_id | string |
$.tweets[].card.values.broadcaster_username | string |
$.tweets[].card.values.card_url | string |
$.tweets[].card.values.site | string |
$.tweets[].community_id | null |
$.tweets[].conversation_id | string |
$.tweets[].created_at | string |
$.tweets[].display_text_range | array |
$.tweets[].display_text_range[] | integer |
$.tweets[].edit | object |
$.tweets[].edit.edit_tweet_ids | array |
$.tweets[].edit.edit_tweet_ids[] | string |
$.tweets[].edit.editable_until | string |
$.tweets[].edit.edits_remaining | integer |
$.tweets[].edit.is_edit_eligible | boolean |
$.tweets[].entities | object |
$.tweets[].entities.hashtags | array |
$.tweets[].entities.mentions | array |
$.tweets[].entities.mentions[] | object |
$.tweets[].entities.mentions[].… | string |
$.tweets[].entities.symbols | array |
$.tweets[].entities.urls | array |
$.tweets[].entities.urls[] | object |
$.tweets[].entities.urls[].… | string |
$.tweets[].hashtags | array |
$.tweets[].id | string |
$.tweets[].is_long | boolean |
$.tweets[].is_quote | boolean |
$.tweets[].is_retweet | boolean |
$.tweets[].is_translatable | boolean |
$.tweets[].lang | string |
$.tweets[].likes | integer |
$.tweets[].links | array |
$.tweets[].links[] | string |
$.tweets[].media | array |
$.tweets[].media[] | object |
$.tweets[].media[].allow_download | null |
$.tweets[].media[].alt_text | string |
$.tweets[].media[].aspect_ratio | null |
$.tweets[].media[].availability | string |
$.tweets[].media[].display_url | string |
$.tweets[].media[].expanded_url | string |
$.tweets[].media[].height | integer |
$.tweets[].media[].hls | null |
$.tweets[].media[].id | string |
$.tweets[].media[].image_original | string |
$.tweets[].media[].media_key | string |
$.tweets[].media[].monetizable | null |
$.tweets[].media[].short_url | string |
$.tweets[].media[].sizes | object |
$.tweets[].media[].sizes.… | string |
$.tweets[].media[].source_user_id | null |
$.tweets[].media[].tagged_users | array |
$.tweets[].media[].type | string |
$.tweets[].media[].url | string |
$.tweets[].media[].variants | array |
$.tweets[].media[].view_count | null |
$.tweets[].media[].width | integer |
$.tweets[].mentions | array |
$.tweets[].mentions[] | string |
$.tweets[].place | null |
$.tweets[].possibly_sensitive | boolean |
$.tweets[].quote_of | null |
$.tweets[].quoted_tweet_id | null |
$.tweets[].quotes | integer |
$.tweets[].replies | integer |
$.tweets[].reply_to | null |
$.tweets[].reply_to_user | null |
$.tweets[].reply_to_user_id | null |
$.tweets[].retweet_of | null |
$.tweets[].retweets | integer |
$.tweets[].source | null |
$.tweets[].text | string |
$.tweets[].url | string |
$.tweets[].user_id | string |
$.tweets[].views | integer |
$.tweets[].views_state | string |
$.tweets[].… | string |
$.user_id | string |
$.username | string |