Media types & size restrictions
Size restrictions for uploading via API- Image:
5 MB
- GIF:
15 MB
- Video:
512 MB
(when usingmedia_category=amplify_video
)
Creation
Objects such as Posts, Direct Messages, user profile pictures, hosted Ads cards, etc. can contain one or more media objects. These top-level objects are collectively known as entities. The relevant entity creation API (e.g.POST /2/tweets
) can be passed one or more media objects using a unique media_id
.
An entity which contains media object(s) can be created by following these steps:
- Upload the media file(s) using either the recommended chunked upload (images/GIF/video), or the older simple upload (images only).
- Receive a
media_id
from step 1. This step may be repeated multiple times with different media if the entity allows multiplemedia_id
parameters to be passed in. - Create the entity by calling the appropriate endpoint, including the
media_id
and other required parameters. For example, attach amedia_id
to a Post using thePOST /2/tweets
endpoint.