媒体下载与代理规则
使用后端代理并携带浏览器 User-Agent 与对应 Threads Referer。源签名和规格可能变化，返回 URL 只适合短期保存。
建议的后端请求头
User-Agent: Mozilla/5.0
Referer: https://www.threads.net/
Range: bytes=0-EasyDown REST API 平台指南
Threads 视频与图片下载 API
EasyDown 会在上游结果中按 shortcode 精确匹配目标帖，而不是默认使用第一条，再通过统一 REST 结构返回完整媒体。
使用 EasyDown Threads 下载 API 解析公开媒体帖，获取目标 shortcode 对应的全部视频规格、轮播图片、正文图片和封面。
Threads 视频解析 API · Threads 图片下载 API
生产环境 REST Endpoint
POST https://api.easydown.org/api/v1/parse支持的公开 URL 格式
threads.com/@user/post/{shortcode}threads.net/@user/post/{shortcode}Optional query string or /media suffix真实请求示例
https://www.threads.com/@eekeai/post/DDhV3LWhrlk
curl -X POST https://api.easydown.org/api/v1/parse \
-H "Authorization: Bearer ed_live_xxx" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.threads.com/@eekeai/post/DDhV3LWhrlk"}'平台专属响应示例
统一响应外层保持稳定；具体平台决定哪些媒体数组和属性会被填充。
媒体返回行为
媒体帖会返回全部有效视频规格和轮播中的每张图片；上游提供的独立重复规格可能会被保留。
{
"status": 200,
"data": {
"platform": "threads",
"title": "Example threads public post",
"thumbnail": "https://cdn.example.com/thumbnail.jpg",
"duration": 24,
"images": [
{
"url": "https://cdn.example.com/content-image.jpg",
"width": 1080,
"height": 1350
}
],
"videos": [
{
"url": "https://cdn.example.com/video.mp4",
"quality": "HD",
"mimeType": "video/mp4",
"width": 1080,
"height": 1920,
"hasAudio": true,
"source": "direct"
}
],
"audios": []
},
"msg": "success"
}不支持或不可用的内容
纯文本帖子、主页、内容流、回复、搜索结果、私密和已删除帖子不会返回可下载媒体。
只处理你有权使用的公开媒体。EasyDown 不绕过隐私设置、DRM、已删除内容或平台访问限制。
平台专属排错
使用带 threads.com 或 threads.net 的标准 shortcode 帖子 URL。
纯文本成功响应应按无媒体结果处理。
保留返回的全部轮播图片，不要只取第一张。
REST 集成流程
- 1
创建私有 API Token，并在权限中允许该平台。
- 2
把一个完整的公开作品 URL POST 到统一 Endpoint。
- 3
从 images、videos、audios 中选择所需媒体并通过后端代理。
下载 API 常见问题
Threads 下载 API 支持哪些 URL？
支持的公开单条作品格式包括 threads.com/@user/post/{shortcode}, threads.net/@user/post/{shortcode}, Optional query string or /media suffix。纯文本帖子、主页、内容流、回复、搜索结果、私密和已删除帖子不会返回可下载媒体。
Threads 下载 API 会返回哪些媒体？
媒体帖会返回全部有效视频规格和轮播中的每张图片；上游提供的独立重复规格可能会被保留。
应用应该如何下载返回的 Threads 媒体 URL？
使用后端代理并携带浏览器 User-Agent 与对应 Threads Referer。源签名和规格可能变化，返回 URL 只适合短期保存。
Threads API 成功请求如何扣费？
成功返回至少一条图片、视频或音频 URL 时扣 1 credit；失败、不支持、鉴权错误和空媒体结果不扣 credits。