Twitter API Documentation
Multiple Tweets
GET https://api.twitter.com/2/tweets?ids=
This endpoint returns details about up to 100 Tweets specified by the requested IDs. For full details, see the API reference for this endpoint.
Body
PARAM
| Key | Datatype | Required | Description |
ids
|
null | Required. Enter up to 100 comma-separated Tweet IDs. | |
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": [
{
"id": "20",
"text": "just setting up my twttr"
}
],
"errors": [
{
"detail": "Could not find tweet with ids: [1276230436478386177].",
"title": "Not Found Error",
"resource_type": "tweet",
"parameter": "ids",
"value": "1276230436478386177",
"type": "https://api.twitter.com/2/problems/resource-not-found"
}
]
} |
Curl
curl -X GET 'https://api.twitter.com/2/tweets?ids=?ids=&tweet.fields=&expansions=&media.fields=&place.fields=&poll.fields=&user.fields='