The Twitter Media Retrieval API allows you to easily extract and download multimedia content (videos, images, or GIFs) from public tweets. By providing a link to a tweet, this API returns a detailed set of metadata along with direct URLs to access the multimedia content, making it easy to view or download without any additional complications.
The API can also identify whether the content belongs to a single type (all videos or images) and whether it has associated community notes or polls. It is ideal for content curation tools, social media analysis, media archiving, and Twitter trend monitoring dashboards.
Thanks to its structured and consistent JSON format, it is compatible with any modern programming language and can be quickly integrated into mobile applications, websites, or backends.
In short, this API simplifies access to Twitter multimedia content, delivering relevant data quickly, reliably, and accurately.
To use this endpoint, you must specify the URL of a tweet in the parameter.
Download - Endpoint Features
| Object | Description |
|---|---|
url |
[Required] Enter a URL |
{
"code": 200,
"msg": "success",
"data": {
"allSameType": true,
"article": null,
"combinedMediaUrl": null,
"communityNote": null,
"conversationID": "1948404736253624527",
"date": "Thu Jul 24 15:27:43 +0000 2025",
"date_epoch": 1753370863,
"fetched_on": 1753881861,
"hasMedia": true,
"hashtags": [],
"lang": "es",
"likes": 1528,
"mediaURLs": [
"https:\/\/video.twimg.com\/ext_tw_video\/1948404311597150209\/pu\/vid\/avc1\/720x900\/ndnIx9CI0yUdLk_t.mp4"
],
"media_extended": [
{
"altText": null,
"duration_millis": 35037,
"size": {
"height": 900,
"width": 720
},
"thumbnail_url": "https:\/\/pbs.twimg.com\/ext_tw_video_thumb\/1948404311597150209\/pu\/img\/hAQc1DaEGxmoLlnA.jpg",
"type": "video",
"url": "https:\/\/video.twimg.com\/ext_tw_video\/1948404311597150209\/pu\/vid\/avc1\/720x900\/ndnIx9CI0yUdLk_t.mp4"
}
],
"pollData": null,
"possibly_sensitive": false,
"qrt": null,
"qrtURL": null,
"replies": 74,
"replyingTo": null,
"replyingToID": null,
"retweet": null,
"retweetURL": null,
"retweets": 97,
"text": "Quién se llevará la corona mundial 1v1 de @MasbyMessi? ⚽👑⚽\nEstamos buscando a los mejores jugadores para competir en un nuevo torneo global, con la gran final en Miami.\n¿Creés tener lo que hace falta? Inscribite desde el link https:\/\/t.co\/3WxuviWxQK.\n\nWho will claim the @MasbyMessi 1v1 World Crown? ⚽👑⚽\nWe’re looking for the best ballers to compete in a new global tournament, with the grand final in Miami.\nGot what it takes? Enter via link https:\/\/t.co\/3WxuviWxQK.\n\n#MasbyMessi1v1 #1v1WorldCrown\n\n*T&Cs at the 🔗 in bio on @masbymessi",
"tweetID": "1948404736253624527",
"tweetURL": "https:\/\/twitter.com\/leomessisite\/status\/1948404736253624527",
"user_name": "Leo Messi",
"user_profile_image_url": "https:\/\/pbs.twimg.com\/profile_images\/1859337072814727168\/uqtdn4id_normal.jpg",
"user_screen_name": "leomessisite"
}
}
curl --location --request GET 'https://zylalabs.com/api/9151/twitter+media+retrieval+api/16548/download?url=https://x.com/leomessisite/status/1948404736253624527/video/1' --header 'Authorization: Bearer YOUR_API_KEY'
| Header | Description |
|---|---|
Authorization
|
[Required] Should be Bearer access_key. See "Your API Access Key" above when you are subscribed. |
No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.
The API returns metadata for multimedia content from public tweets, including direct download links for images, videos, or GIFs, along with user details and tweet information.
Key fields in the response include media URLs, media type (image, video, GIF), tweet ID, user ID, and any associated community notes or polls.
The response is structured in a JSON format, with nested objects for user details and media content, making it easy to parse and access specific information.
The API provides information on multimedia content types, user details, tweet metadata, and any associated community notes or polls related to the tweet.
Users can customize requests by specifying the tweet URL in the GET Download endpoint, allowing for targeted retrieval of specific tweet media.
Typical use cases include content curation, social media analysis, media archiving, and monitoring Twitter trends for research or marketing purposes.
Data accuracy is maintained by sourcing information directly from Twitter's public API, ensuring that the metadata reflects the most current and relevant tweet details.
Users can utilize the returned data by integrating it into applications for displaying multimedia content, analyzing user engagement, or creating dashboards for social media insights.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund
To obtain your API key, you first need to sign in to your account and subscribe to the API you want to use. Once subscribed, go to your Profile, open the Subscription section, and select the specific API. Your API key will be available there and can be used to authenticate your requests.
You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.
If you don’t cancel before the 7th day, your free trial will end automatically and your subscription will switch to a paid plan under the same plan you originally subscribed to, meaning you will be charged and gain access to the API calls included in that plan.
The free trial ends when you reach 50 API requests or after 7 days, whichever comes first.
No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.
Yes, we offer a 7-day free trial that allows you to make up to 50 API calls at no cost, so you can test our APIs without any commitment.
Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.
Service Level:
100%
Response Time:
2,009ms
Service Level:
100%
Response Time:
21ms
Service Level:
100%
Response Time:
2,795ms
Service Level:
100%
Response Time:
1,348ms
Service Level:
100%
Response Time:
774ms
Service Level:
100%
Response Time:
400ms
Service Level:
100%
Response Time:
636ms
Service Level:
100%
Response Time:
4,787ms
Service Level:
100%
Response Time:
19ms
Service Level:
100%
Response Time:
1,709ms
Service Level:
100%
Response Time:
92ms
Service Level:
100%
Response Time:
568ms
Service Level:
100%
Response Time:
3,929ms
Service Level:
100%
Response Time:
306ms
Service Level:
100%
Response Time:
584ms
Service Level:
100%
Response Time:
926ms
Service Level:
100%
Response Time:
918ms
Service Level:
100%
Response Time:
128ms
Service Level:
100%
Response Time:
570ms
Service Level:
100%
Response Time:
1,386ms