Overview
- Introduction
- Getting started
- Tools and libraries
- Migration guide
- What to build
- Fundamentals
Posts
- Search
- Post Counts
- Filtered Stream
- Timelines
- Post Lookup
- Bookmarks
- Manage Posts
- Reposts
- Quotes
- Hide replies
- Volume Streams
Users
- User Lookup
- Search
- Follows
- Mutes
- Blocks
Engagement Metrics
Direct Messages
- Manage
- Lookup
- Blocks
Likes
- Introduction
- Guides
- GETReturns Post objects liked by the provided User ID
- GETReturns User objects that have liked the provided Post ID
- POSTCauses the User (in the path) to like the specified Post
- DELCauses the User (in the path) to unlike the specified Post
- GETLikes Firehose stream
- GETLikes Sample 10 stream
Lists
- Lookup Lists
- Lookup List Posts
- Manage Lists
- List Members
- Pinned Lists
Spaces
- Introduction
- Spaces Lookup
- Search Spaces
Communities
- Communities Lookup
- Search Communities
Trends
- Trends
- Personalized Trends
Media
Compliance
- Batch Compliance
- Compliance streams
Account Activity
- Introduction
- Migration guide
- GETCheck if a subscription exists for a given webhook and user
- DELDeactivates a subscription for the specified webhook and user id
- GETGet a count of subscriptions that are currently active on your account
- GETGet a list of the current All Activity type subscriptions for the specified webhook
- POSTRequest Activity Replay
- POSTSubscribes the provided application to all events for the provided user context for all message types
Webhooks
Enterprise (Gnip 2.0)
Upload
Finalize a media upload request.
Finalize a media upload request.
POST
/
2
/
media
/
upload
/
{id}
/
finalize
curl --request POST \
--url https://api.twitter.com/2/media/upload/{id}/finalize \
--header 'Authorization: Bearer <token>'
{
"data": {
"expires_after_secs": 123,
"id": "1146654567674912769",
"media_key": "<string>",
"processing_info": {
"check_after_secs": 123,
"progress_percent": 123,
"state": "succeeded"
},
"size": 123
},
"errors": [
{
"detail": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}
]
}
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Path Parameters
The media id of the targeted media to finalize.
Example:
"1146654567674912769"
Response
200
application/json
The request has succeeded.
A response from getting a media upload request status.
curl --request POST \
--url https://api.twitter.com/2/media/upload/{id}/finalize \
--header 'Authorization: Bearer <token>'
{
"data": {
"expires_after_secs": 123,
"id": "1146654567674912769",
"media_key": "<string>",
"processing_info": {
"check_after_secs": 123,
"progress_percent": 123,
"state": "succeeded"
},
"size": 123
},
"errors": [
{
"detail": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}
]
}
Assistant
Responses are generated using AI and may contain mistakes.