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"
},
"audience_policy": {
"creator_subscriptions": [
"Any"
],
"x_subscriptions": [
"Any"
]
},
"content_expiration": {
"timestamp_sec": 1740787200
},
"domain_restrictions": {
"whitelist": [
"<string>"
]
},
"found_media_origin": {
"id": "u5BzatR15TZ04",
"provider": "giphy"
},
"geo_restrictions": {
"blacklisted_country_codes": [
"us"
],
"whitelisted_country_codes": [
"us"
]
},
"management_info": {
"managed": false
},
"preview_image": {
"media_key": {
"media": "1344889453626359968",
"media_category": "PreviewImage"
}
},
"sensitive_media_warning": {
"adult_content": true,
"graphic_violence": true,
"other": false
},
"shared_info": {
"shared": false
},
"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"
},
"audience_policy": {
"creator_subscriptions": [
"Any"
],
"x_subscriptions": [
"Any"
]
},
"content_expiration": {
"timestamp_sec": 1740787200
},
"domain_restrictions": {
"whitelist": [
"<string>"
]
},
"found_media_origin": {
"id": "u5BzatR15TZ04",
"provider": "giphy"
},
"geo_restrictions": {
"blacklisted_country_codes": [
"us"
],
"whitelisted_country_codes": [
"us"
]
},
"management_info": {
"managed": false
},
"preview_image": {
"media_key": {
"media": "1344889453626359968",
"media_category": "PreviewImage"
}
},
"sensitive_media_warning": {
"adult_content": true,
"graphic_violence": true,
"other": false
},
"shared_info": {
"shared": false
},
"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"
Expiration time for content as a Unix timestamp in seconds
1740787200
List of whitelisted domains
Indicates if the media is managed by Media Studio
false
Indicates if the content contains adult material
true
Indicates if the content depicts graphic violence
true
Indicates if the content has other sensitive characteristics
false
Indicates if the media is shared in direct messages
false
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"
Expiration time for content as a Unix timestamp in seconds
1740787200
List of whitelisted domains
List of blacklisted country codes
Country code in ISO 3166-1 alpha-2 format
List of whitelisted country codes
Country code in ISO 3166-1 alpha-2 format
Indicates if the media is managed by Media Studio
false
Indicates if the content contains adult material
true
Indicates if the content depicts graphic violence
true
Indicates if the content has other sensitive characteristics
false
Indicates if the media is shared in direct messages
false
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"
},
"audience_policy": {
"creator_subscriptions": [
"Any"
],
"x_subscriptions": [
"Any"
]
},
"content_expiration": {
"timestamp_sec": 1740787200
},
"domain_restrictions": {
"whitelist": [
"<string>"
]
},
"found_media_origin": {
"id": "u5BzatR15TZ04",
"provider": "giphy"
},
"geo_restrictions": {
"blacklisted_country_codes": [
"us"
],
"whitelisted_country_codes": [
"us"
]
},
"management_info": {
"managed": false
},
"preview_image": {
"media_key": {
"media": "1344889453626359968",
"media_category": "PreviewImage"
}
},
"sensitive_media_warning": {
"adult_content": true,
"graphic_violence": true,
"other": false
},
"shared_info": {
"shared": false
},
"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"
},
"audience_policy": {
"creator_subscriptions": [
"Any"
],
"x_subscriptions": [
"Any"
]
},
"content_expiration": {
"timestamp_sec": 1740787200
},
"domain_restrictions": {
"whitelist": [
"<string>"
]
},
"found_media_origin": {
"id": "u5BzatR15TZ04",
"provider": "giphy"
},
"geo_restrictions": {
"blacklisted_country_codes": [
"us"
],
"whitelisted_country_codes": [
"us"
]
},
"management_info": {
"managed": false
},
"preview_image": {
"media_key": {
"media": "1344889453626359968",
"media_category": "PreviewImage"
}
},
"sensitive_media_warning": {
"adult_content": true,
"graphic_violence": true,
"other": false
},
"shared_info": {
"shared": false
},
"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>"
}
]
}