Threads
Photo
Download the photo, or every photo of a carousel, from a Threads post.
Endpoint
GET
/s/threads/postSend your API key in the X-API-Key header. threads is the usual service slug; use the one shown on your subscription if it differs.
Query parameters
| Name | Description |
|---|---|
urlrequired | Link to the post. You can pass the numeric ID as id instead.Example: https://www.threads.com/@zuck/post/C8aBcDeFgHj |
Example request
curl '/s/threads/post?url=https%3A%2F%2Fwww.threads.com%2F%40zuck%2Fpost%2FC8aBcDeFgHj' \
-H 'X-API-Key: YOUR_API_KEY'Example response
The result is in data. Fields the platform didn't report are left out. Field reference: response shapes.
{
"data": {
"platform": "threads",
"id": "3401234567890123457",
"code": "C8aBcDeFgHj",
"url": "https://www.threads.com/@zuck/post/C8aBcDeFgHj",
"type": "carousel",
"text": "Weekend",
"author": {
"id": "314216",
"username": "zuck",
"name": "Mark Zuckerberg",
"avatar": "https://cdn.example/avatar.jpg",
"verified": true
},
"media": [
{
"type": "image",
"url": "https://scontent.cdninstagram.example/1.jpg",
"width": 1440,
"height": 1800
},
{
"type": "image",
"url": "https://scontent.cdninstagram.example/2.jpg",
"width": 1440,
"height": 1800
}
],
"stats": {
"likes": 22000,
"comments": 1300,
"reposts": 410
}
}
}Notes
- Carousels come back as type "carousel" with one media item per slide.
- Media URLs are signed by the platform and expire after a few hours. Download the files promptly instead of storing the links.