Twitter API Documentation
Single Tweet Usercontext
GET https://api.twitter.com/2/tweets/:id
This endpoint returns details about the Tweet specified by the requested ID. For full details, see the API reference for this endpoint.
Body
PARAM
| Key | Datatype | Required | Description |
tweet.fields
|
null | Comma-separated list of fields for the Tweet object. Allowed values: attachments,author_id,context_annotations,conversation_id,created_at,entities,geo,id,in_reply_to_user_id,lang,non_public_metrics,organic_metrics,possibly_sensitive,promoted_metrics,public_metrics,referenced_tweets,reply_settings,source,text,withheld Default values: id,text OAuth1.0a User Context authorization required if any of the following fields are included in the request: non_public_metrics,organic_metrics,promoted_metrics | |
expansions
|
null | Comma-separated list of fields to expand. Expansions enable requests to expand an ID into a full object in the includes response object. Allowed values: attachments.poll_ids,attachments.media_keys,author_id,geo.place_id,in_reply_to_user_id,referenced_tweets.id,entities.mentions.username,referenced_tweets.id.author_id Default values: none | |
media.fields
|
null | Comma-separated list of fields for the media object. Expansion required. Allowed values: duration_ms,height,media_key,non_public_metrics,organic_metrics,preview_image_url,promoted_metrics,public_metrics,type,url,width Default values: media_key,type OAuth1.0a User Context authorization required if any of the following fields are included in the request: non_public_metrics,organic_metrics,promoted_metrics | |
place.fields
|
null | Comma-separated list of fields for the place object. Expansion required. Allowed values: contained_within,country,country_code,full_name,geo,id,name,place_type Default values: id,full_name | |
poll.fields
|
null | Comma-separated list of fields for the poll object. Expansion required. Allowed values: duration_minutes,end_datetime,id,options,voting_status Default values: id, options | |
user.fields
|
null | Comma-separated list of fields for the user object. Expansion required. Allowed values: created_at,description,entities,id,location,name,pinned_tweet_id,profile_image_url,protected,public_metrics,url,username,verified,withheld Default values: id,name,username |
HEADERS
| Key | Datatype | Required | Description |
RESPONSES
status OK
| {
"data": {
"attachments": {
"media_keys": [
"13_1263145212760805376"
]
},
"author_id": "783214",
"created_at": "2020-05-20T16:31:15.000Z",
"entities": {
"urls": [
{
"start": 154,
"end": 177,
"url": "https://t.co/pV53mvjAVT",
"expanded_url": "https://twitter.com/Twitter/status/1263145271946551300/video/1",
"display_url": "pic.twitter.com/pV53mvjAVT"
}
]
},
"id": "1263145271946551300",
"lang": "en",
"possibly_sensitive": false,
"source": "Sprinklr",
"text": "Testing, testing...\n\nA new way to have a convo with exactly who you want. We’re starting with a small % globally, so keep your 👀 out to see it in action. https://t.co/pV53mvjAVT"
},
"includes": {
"media": [
{
"duration_ms": 46947,
"height": 1080,
"media_key": "13_1263145212760805376",
"preview_image_url": "https://pbs.twimg.com/media/EYeX7akWsAIP1_1.jpg",
"public_metrics": {
"view_count": 6891098
},
"type": "video",
"width": 1920
}
]
}
} |
Curl
curl -X GET 'https://api.twitter.com/2/tweets/:id?tweet.fields=&expansions=&media.fields=&place.fields=&poll.fields=&user.fields='