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
Enterprise (Gnip 2.0)
Metadata Create
MetadataCreate
curl --request POST \
--url https://api.twitter.com/2/media/metadata \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"id": "1146654567674912769",
"metadata": {
"allow_download_status": {
"allow_download": true
},
"alt_text": {
"text": "A dancing cat"
},
"found_media_origin": {
"id": "u5BzatR15TZ04",
"provider": "giphy"
},
"sticker_info": {
"stickers": [
{
"aspect_ratio": 1.78,
"group_annotation_id": 987654321098765,
"id": "12345",
"sticker_set_annotation_id": 123456789012345,
"transform_a": 1,
"transform_b": 0,
"transform_c": 0,
"transform_d": 1,
"transform_tx": 10.5,
"transform_ty": -5.2
}
]
},
"upload_source": {
"upload_source": "gallery"
}
}
}'
{
"data": {
"associated_metadata": {
"allow_download_status": {
"allow_download": true
},
"alt_text": {
"text": "A dancing cat"
},
"found_media_origin": {
"id": "u5BzatR15TZ04",
"provider": "giphy"
},
"sticker_info": {
"stickers": [
{
"aspect_ratio": 1.78,
"group_annotation_id": 987654321098765,
"id": "12345",
"sticker_set_annotation_id": 123456789012345,
"transform_a": 1,
"transform_b": 0,
"transform_c": 0,
"transform_d": 1,
"transform_tx": 10.5,
"transform_ty": -5.2
}
]
},
"upload_source": {
"upload_source": "gallery"
}
},
"id": "1146654567674912769"
},
"errors": [
{
"detail": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}
]
}
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Body
The unique identifier of this Media.
"1146654567674912769"
true
Description of media ( <= 1000 characters )
1000
"A dancing cat"
Stickers list must not be empty and should not exceed 25
width-to-height ratio of the media
1.78
A unique identifier for the group of annotations associated with the media
987654321098765
Unique identifier for sticker
"12345"
A unique identifier for the sticker set associated with the media
123456789012345
Scale or rotate the media on the x-axis
1
Skew the media on the x-axis
0
Skew the media on the y-axis
0
Scale or rotate the media on the y-axis
1
Scale or rotate the media on the x-axis
10.5
The vertical translation (shift) value for the media
-5.2
Response
true
Description of media ( <= 1000 characters )
1000
"A dancing cat"
Stickers list must not be empty and should not exceed 25
width-to-height ratio of the media
1.78
A unique identifier for the group of annotations associated with the media
987654321098765
Unique identifier for sticker
"12345"
A unique identifier for the sticker set associated with the media
123456789012345
Scale or rotate the media on the x-axis
1
Skew the media on the x-axis
0
Skew the media on the y-axis
0
Scale or rotate the media on the y-axis
1
Scale or rotate the media on the x-axis
10.5
The vertical translation (shift) value for the media
-5.2
The unique identifier of this Media.
"1146654567674912769"
curl --request POST \
--url https://api.twitter.com/2/media/metadata \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"id": "1146654567674912769",
"metadata": {
"allow_download_status": {
"allow_download": true
},
"alt_text": {
"text": "A dancing cat"
},
"found_media_origin": {
"id": "u5BzatR15TZ04",
"provider": "giphy"
},
"sticker_info": {
"stickers": [
{
"aspect_ratio": 1.78,
"group_annotation_id": 987654321098765,
"id": "12345",
"sticker_set_annotation_id": 123456789012345,
"transform_a": 1,
"transform_b": 0,
"transform_c": 0,
"transform_d": 1,
"transform_tx": 10.5,
"transform_ty": -5.2
}
]
},
"upload_source": {
"upload_source": "gallery"
}
}
}'
{
"data": {
"associated_metadata": {
"allow_download_status": {
"allow_download": true
},
"alt_text": {
"text": "A dancing cat"
},
"found_media_origin": {
"id": "u5BzatR15TZ04",
"provider": "giphy"
},
"sticker_info": {
"stickers": [
{
"aspect_ratio": 1.78,
"group_annotation_id": 987654321098765,
"id": "12345",
"sticker_set_annotation_id": 123456789012345,
"transform_a": 1,
"transform_b": 0,
"transform_c": 0,
"transform_d": 1,
"transform_tx": 10.5,
"transform_ty": -5.2
}
]
},
"upload_source": {
"upload_source": "gallery"
}
},
"id": "1146654567674912769"
},
"errors": [
{
"detail": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}
]
}