Instagram 推荐 Reels API
不用必填参数,取一页推荐的 Reels:每行有 text、like_count、comment_count、author_username 和带签名的 video_url,每千次 $1.18。
- 没有必填参数
- 每次结果不同
- 失败和空结果不收费
接口健康状态
- 24h 健康值
- 正常
- 健康 / 正常
- 可用
- 少量可用
- 基本不可用
24 小时趋势
30 天趋势
1请求
POST /api/v1/social { "platform": "instagram", "action": "recommended_reels", "params": {} }2JSON 响应
{ "results": [ { "author_username": "y•••7", "post_id": "Df004fGz-Ig", "text": "🇰🇷弘大|Odarijip 오다리집|韓星都黎打卡嘅醬蟹老店🦀\n\n弘大必試生醃醬蟹,好多藝人都到訪嘅老牌專門店。\n\n店鋪位於大廈2‑3樓,空間闊落,座位疏落唔擠迫。牆上滿滿明星簽名同打卡相,充滿老店氛圍,燈光柔和,朋友聚餐、約會都合適,整體環境乾淨舒服。\n\n蟹肉滑溜似果凍,肉質飽滿扎實,入口釋放海鮮原生鮮甜,蟹殼內蟹膏滿溢,綿密油潤,鮮味濃郁。醬汁調配得啱啱好,唔會過重掩蓋蟹本身嘅風味。\n將蟹膏、蟹肉撈埋白飯,粒粒飯吸盡鮮香,真正體驗「偷飯賊」嘅威力。\n\n人氣👌高,飯市經常需要輪候,建議早啲到。弘大逛街行程可以bookmark!\n📍Odarijip 弘大…", "media_type": "video" }, … ], "count": 10 }3表格行
author_username post_id text media_type y•••7 Df004fGz-Ig 🇰🇷弘大|Odarijip 오다리집|韓星都黎打卡嘅醬蟹老店🦀 弘大必試生醃醬蟹,好多藝人都到訪嘅老牌專門店。 店鋪位於大廈2‑3樓,空間闊落,座位疏落唔擠迫。牆上滿滿明星簽名同打卡相,充滿老店氛圍,燈光柔和,朋友聚餐、約會都合適,整體環境乾淨舒服。 蟹肉滑溜似果凍,肉質飽滿扎實,入口釋放海鮮原生鮮甜,蟹殼內蟹膏滿溢,綿密油潤,鮮味濃郁。醬汁調配得啱啱好,唔會過重掩蓋蟹本身嘅風味。 將蟹膏、蟹肉撈埋白飯,粒粒飯吸盡鮮香,真正體驗「偷飯賊」嘅威力。 人氣👌高,飯市經常需要輪候,建議早啲到。弘大逛街行程可以bookmark! 📍Odarijip 弘大… video u•••n DeQLC8vB-XV Running Into the Last Light 🐎🌅✨ DJi drone makes it possible A herd of horses runs freely across the glowing green grassland as the horizon burns orange beneath a deep blue sky. With foals keeping pace beside them and endless open land ahead, this is what freedom looks like in mo… video 4CSV
instagram-recommended_reels-sample.csv post_id,url,text,media_type,like_count,comment_count,author_username,author_name,posted_at,location,id,image_url,video_url,author_id,width,height,is_comments_disabled,author_follower_count,hashtags,top_comments,product_type,play_count,fb_play_count,fb_like_count,fb_comment_count,share_count,repost_count,duration_sec,duration_seconds,duration_estimated,image_count,video_count,video_url_expires_at,video_hd_url,video_hd_height,audio_url,video_hd_expires_at,is_paid_partnership,is_pinned,likes_hidden,caption_is_edited,accessibility_caption,author_is_verified,author_is_private,author_avatar_url,posted_at_estimated,mentions,tagged_users,coauthors,sponsors,media,music,platform,location_detail
text、like_count、video_url 等字段,再变成表格行和 CSV。能拿到什么数据
表里是一次真实调用的结果,2026年11月21日 15:18(UTC)采集,返回 10 条;灰条是隐去的个人信息(CSV 里是 •••)。每次调用的内容不同,你自己调用时,按字段表返回这些字段。
| post_id | url | text | media_type | like_count | comment_count | author_username | author_name | posted_at | location | id | image_url | video_url | author_id | width | height | is_comments_disabled | author_follower_count | hashtags | top_comments | product_type | play_count | fb_play_count | fb_like_count | fb_comment_count | share_count | repost_count | duration_sec | duration_seconds | duration_estimated | image_count | video_count | video_url_expires_at | video_hd_url | video_hd_height | audio_url | video_hd_expires_at | is_paid_partnership | is_pinned | likes_hidden | caption_is_edited | accessibility_caption | author_is_verified | author_is_private | author_avatar_url | posted_at_estimated | mentions | tagged_users | coauthors | sponsors | media | music | platform | location_detail |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Df004fGz-Ig | https://www.instagram.com/reel/Df004fGz-Ig/ | 🇰🇷弘大|Odarijip 오다리집|韓星都黎打卡嘅醬蟹老店🦀 弘大必試生醃醬蟹,好多藝人都到訪嘅老牌專門店。 店鋪位於大廈2‑3樓,空間闊落,座位疏落唔擠迫。牆上滿滿明星簽名同打卡相,充滿老店氛圍,燈光柔和,朋友聚餐、約會都合適,整體環境乾淨舒服。 蟹肉滑溜似果凍,肉質飽滿扎實,入口釋放海鮮原生鮮甜,蟹殼內蟹膏滿溢,綿密油潤,鮮味濃郁。醬汁調配得啱啱好,唔會過重掩蓋蟹本身嘅風味。 將蟹膏、蟹肉撈埋白飯,粒粒飯吸盡鮮香,真正體驗「偷飯賊」嘅威力。 人氣👌高,飯市經常需要輪候,建議早啲到。弘大逛街行程可以bookmark! 📍Odarijip 弘大… | video | 1336 | 29 | y•••7 | i•••y | 2026-11-17T02:15:30+00:00 | 香港 | https://scontent-lax3-1.cdninstagram.com/v/t51.82787-15/905867834_1120715444164288_8231478405717265133_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=108&_nc_map=urlgen_bucketless&ig_cache_key=NDAzMjA4MDE0NjUxMjk5NDg0ODExMjA3MTU0Mzc0OTc2MjI%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX… | https://scontent-lax7-1.cdninstagram.com/o1/v/t2/f2/m86/AQOheRgHDZfLQyMWaSxdUyIfPMIkdGjWOxmBEWiGq1sPvcCfhiM2JzNNqor35cI_6Cd7akhRLuC0SR_nE2_jJ_feHKaTcTm5FI5Zjzo.mp4?_nc_cat=110&_nc_sid=5e9851&_nc_ht=scontent-lax7-1.cdninstagram.com&_nc_ohc=ICPFAqdR2-cQ7kNvwF8VIPn&efg=eyJ2ZW5jb2RlX… | 1080 | 1920 | false | null | ["弘大美食","Odarijip","오다리집"] | null | clips | null | null | null | null | 2638 | 112 | 41 | 41 | true | null | null | 2026-11-22T17:26:31+00:00 | https://scontent-lax3-1.cdninstagram.com/o1/v/t2/f2/m367/AQMl_kNdQFW0sBrWxfCE0jgqZLDf0ANbBC-dBhKzbopXTuIx9QXzGk_HhiYguCsoxXwgUqV1LHUlBduGjeCQVQoiKbkhbUkVu09asjtl5lZvOQ.mp4?_nc_cat=110&_nc_sid=9ca052&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_ohc=gLMVDeP-3aIQ7kNvwHLJFhE&efg=eyJ2Z… | 1920 | https://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m78/AQNarz1QtNu3JmbGzJrpMQToCXzibhqIsaPuedSxVb1T-IwU4L8A9jkwFby54hwGbJS79qopnmwk-0T1BaGDwADX5R02AWZLleoO61Q.mp4?_nc_cat=105&_nc_sid=9ca052&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=gUNRu21NicEQ7kNvwHWjx-X&efg=eyJ2ZW5jb2RlX… | 2026-11-25T15:21:26+00:00 | false | null | null | null | null | true | false | null | null | null | null | null | null | {"artist":"yuny1117","title":"Original audio","audio_id":"29040011078996048","is_original":true,"is_trending":false,"url":"https://www.instagram.com/reels/audio/29040011078996048/"} | {"id":"•••","name":"香港","url":"https://www.instagram.com/explore/locations/314055843/"} | ||||
| DeQLC8vB-XV | https://www.instagram.com/reel/DeQLC8vB-XV/ | Running Into the Last Light 🐎🌅✨ DJi drone makes it possible A herd of horses runs freely across the glowing green grassland as the horizon burns orange beneath a deep blue sky. With foals keeping pace beside them and endless open land ahead, this is what freedom looks like in mo… | video | 511179 | 1086 | u•••n | U•••n | 2026-10-09T00:00:05+00:00 | null | https://scontent-lax3-2.cdninstagram.com/v/t51.82787-15/842492090_18635881834006763_6532142919362048035_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=102&_nc_map=urlgen_bucketless&ig_cache_key=NDAwMzc0ODY0OTg5NjUwMjc0MTI3MTQ0Nzg5MjIyOTg1MTc%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2Rl… | https://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m86/AQM2_t64OHeUMHkiRrk_oXg1Fx13dHC8EsQn7qj4IoemJfIvUpgbG3jJW2XmbBs8bY50LXtPWvDOXmiZSLWZDp2wzEkz4BnWJxCfgVw.mp4?_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=wZRSYNl-XEkQ7kNvwHmXjUk&efg=eyJ2ZW5jb2RlX… | 1080 | 1920 | false | null | ["HorseHerd","GrasslandLife","skypixel"] | null | clips | null | null | null | null | 60416 | 18769 | 8 | 8 | true | null | null | 2026-11-22T16:50:32+00:00 | https://scontent-lax3-1.cdninstagram.com/o1/v/t2/f2/m367/AQPN-g2dLkgxeaSoGKlyRAv2pWmGWM1UkRFftBDUO0jdVuUhnHdK8QcM3DCbtKs8ZnhTj1cCRrKGDsWmGRa8V4tXDKhL55Yxk0zd4Dg.mp4?_nc_cat=110&_nc_sid=9ca052&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_ohc=C84pV4KywUEQ7kNvwGt_uFU&efg=eyJ2ZW5jb2Rl… | 1920 | https://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m78/AQPDbrFss6LkseyEhe_bmqad9lEJ2BRsKkerSbbg58Yi-ojglE1qQF6hgNhDgLSOxrXDlWa3jQ9pVZZO7ri70bIitcJNpJAwkdyFhwg.mp4?_nc_cat=108&_nc_sid=9ca052&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=A1ZyzcC_ICQQ7kNvwEm4pbF&efg=eyJ2ZW5jb2RlX… | 2026-11-25T18:23:31+00:00 | false | null | null | null | null | true | false | null | null | null | null | null | null | {"artist":"usmanaryan","title":"Original audio","audio_id":"38684869254489915","is_original":true,"is_trending":false,"url":"https://www.instagram.com/reels/audio/38684869254489915/"} | null |
用途
看推荐 Reels 长什么样
读
text、hashtags和music,看被推荐的 Reels 在讲什么、配什么音乐。找高互动的 Reel
对着
like_count和comment_count挑出互动高的。找被推荐的创作者
读
author_username,列出出现在推荐里的账号。取视频做离线分析
video_url是带声音的 mp4,会过期,要尽快下载。
Instagram Graph API 与 EveryInfra 对比
下面从账号条件、接入审核两方面,比 Instagram 官方 Graph API 和 EveryInfra recommended_reels。
| 对比项 | Instagram Graph API | EveryInfra |
|---|---|---|
| 账号条件 | "To use the APIs, your app users must have an Instagram professional account" | 请求不带必填参数,只用一把 EveryInfra API Key,不要求你或你的用户有 Instagram 专业账号。 |
| 接入审核 | Advanced Access:"Advanced Access is the access level required if your app serves Instagram professional accounts that you don’t own or manage" 以及 "This access level requires App Review and Business Verification." | 一把 EveryInfra API Key 放在 Authorization: Bearer 请求头里,不用提交 Meta 应用审核,也不用登录 Instagram。 |
引文出自 Meta 开发者文档,2026-11-22 核对;这里只比接入条件。 官方出处: Instagram Platform overview (更新于 2026-10-29)
限制和注意事项
- 没有必填参数;第一页不传
page_token。 - 一次返回一页。响应有
next_page_token就原样作page_token传回,其他参数和第一页一样;令牌 24 小时有效,每页算一次调用;没有next_page_token就翻不下去了。 - 每次结果不一样,不是榜单。
- 字段同帖子行,但没有
view_count;要播放数,把某行的url交给post。 - Instagram 答不上时返回 503,不扣费。
video_url带签名,会过期,有video_url_expires_at时以它为准。
价格
每次调用 $0.001181,按次计费,不按行数算。每翻一页算一次调用。失败和空结果不收费。
| 调用次数 | 费用 |
|---|---|
| 10,000 | $11.81 |
| 100,000 | $118.06 |
| 1,000,000 | $1,180.56 |
合计按每次调用的标价算。
代码示例
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "instagram",
"action": "recommended_reels",
"params": {}
}'OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key,复制出去的代码不含你的 Key。
API 参考
下面是 recommended_reels 的参数、响应字段、错误和计费,可以复制整页,或用 Markdown 打开后交给 AI 助手。
AI 提示词
#请帮我用 EveryInfra 的「Instagram 推荐 Reels」接口(instagram/recommended_reels)写一个数据采集脚本。
接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 instagram,action 填 recommended_reels,参数放在 params 里。
- 没有必填参数。
- 可选参数:
- page_token:翻页令牌:把上一次响应里的 next_page_token 原样传回,拿下一页;不传是第一页。翻页时其他参数要和第一页一样。令牌 24 小时有效,每页算一次调用。没有 next_page_token 就是翻不下去了。
- 返回一组记录,每条记录的主要字段:post_id(帖子短码)、url、text、media_type(取值只有两个:video(视频)、like_count、comment_count、author_username、author_name、posted_at、location、id、image_url;一共 53 个字段,完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=instagram。
- 示例请求体:
{
"platform": "instagram",
"action": "recommended_reels",
"params": {}
}
- 计费:$1.18 / 千次;失败和空结果不扣费。
- 一次要采几十上百个时,在请求体加 "mode": "async":先拿到 job_id,再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时,按错误信息里的候选参数和允许值修正;返回 429 或 503 时,按 Retry-After 等待后重试。
写代码前,先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式,再把方案和大概花费讲给我确认。请求参数
#| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
Authorization | header | string | 是 | - | Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。 |
platform | body | string | 是 | instagram | 平台标识,固定值。 |
action | body | string | 是 | recommended_reels | 能力标识,固定值。 |
page_token | body.params | string | 否 | - | 翻页令牌:把上一次响应里的 next_page_token 原样传回,拿下一页;不传是第一页。翻页时其他参数要和第一页一样。令牌 24 小时有效,每页算一次调用。没有 next_page_token 就是翻不下去了。 |
响应示例
#{ "id": "req_…", "platform": "instagram", "action": "recommended_reels", "results": [ { "post_id": "Df004fGz-Ig", "url": "https://www.instagram.com/reel/Df004fGz-Ig/", "text": "🇰🇷弘大|Odarijip 오다리집|韓星都黎打卡嘅醬蟹老店🦀\n\n弘大必試生醃醬蟹,好多藝人都到訪嘅老牌專門店。\n\n店鋪位於大廈2‑3樓,空間闊落,座位疏落唔擠迫。牆上滿滿明星簽名同打卡相,充滿老店氛圍,燈光柔和,朋友聚餐、約會都合適,整體環境乾淨舒服。\n\n蟹肉滑溜似果凍,肉質飽滿扎實,入口釋放海鮮原生鮮甜,蟹殼內蟹膏滿溢,綿密油潤,鮮味濃郁。醬汁調配得啱啱好,唔會過重掩蓋蟹本身嘅風味。\n將蟹膏、蟹肉撈埋白飯,粒粒飯吸盡鮮香,真正體驗「偷飯賊」嘅威力。\n\n人氣👌高,飯市經常需要輪候,建議早啲到。弘大逛街行程可以bookmark!\n📍Odarijip 弘大…", "media_type": "video", "like_count": 1336, "comment_count": 29, "author_username": "y•••7", "author_name": "i•••y", "posted_at": "2026-11-17T02:15:30+00:00", "location": "香港", "id": "•••", "image_url": "https://scontent-lax3-1.cdninstagram.com/v/t51.82787-15/905867834_1120715444164288_8231478405717265133_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=108&_nc_map=urlgen_bucketless&ig_cache_key=NDAzMjA4MDE0NjUxMjk5NDg0ODExMjA3MTU0Mzc0OTc2MjI%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX…", "video_url": "https://scontent-lax7-1.cdninstagram.com/o1/v/t2/f2/m86/AQOheRgHDZfLQyMWaSxdUyIfPMIkdGjWOxmBEWiGq1sPvcCfhiM2JzNNqor35cI_6Cd7akhRLuC0SR_nE2_jJ_feHKaTcTm5FI5Zjzo.mp4?_nc_cat=110&_nc_sid=5e9851&_nc_ht=scontent-lax7-1.cdninstagram.com&_nc_ohc=ICPFAqdR2-cQ7kNvwF8VIPn&efg=eyJ2ZW5jb2RlX…", "author_id": "•••", "width": 1080, "height": 1920, "is_comments_disabled": false, "hashtags": [ "弘大美食", "Odarijip", "오다리집" ], "product_type": "clips", "share_count": 2638, "repost_count": 112, "duration_sec": 41, "duration_estimated": true, "video_url_expires_at": "2026-11-22T17:26:31+00:00", "video_hd_url": "https://scontent-lax3-1.cdninstagram.com/o1/v/t2/f2/m367/AQMl_kNdQFW0sBrWxfCE0jgqZLDf0ANbBC-dBhKzbopXTuIx9QXzGk_HhiYguCsoxXwgUqV1LHUlBduGjeCQVQoiKbkhbUkVu09asjtl5lZvOQ.mp4?_nc_cat=110&_nc_sid=9ca052&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_ohc=gLMVDeP-3aIQ7kNvwHLJFhE&efg=eyJ2Z…", "video_hd_height": 1920, "audio_url": "https://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m78/AQNarz1QtNu3JmbGzJrpMQToCXzibhqIsaPuedSxVb1T-IwU4L8A9jkwFby54hwGbJS79qopnmwk-0T1BaGDwADX5R02AWZLleoO61Q.mp4?_nc_cat=105&_nc_sid=9ca052&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=gUNRu21NicEQ7kNvwHWjx-X&efg=eyJ2ZW5jb2RlX…", "video_hd_expires_at": "2026-11-25T15:21:26+00:00", "is_paid_partnership": false, "author_is_verified": true, "author_is_private": false, "author_avatar_url": "https://scontent-lax3-1.cdninstagram.com/•••", "music": { "artist": "yuny1117", "title": "Original audio", "audio_id": "29040011078996048", "is_original": true, "is_trending": false, "url": "https://www.instagram.com/reels/audio/29040011078996048/" }, "platform": "instagram", "location_detail": { "id": "•••", "name": "香港", "url": "https://www.instagram.com/explore/locations/314055843/" }, "duration_seconds": 41 }, { "post_id": "DeQLC8vB-XV", "url": "https://www.instagram.com/reel/DeQLC8vB-XV/", "text": "Running Into the Last Light 🐎🌅✨\nDJi drone makes it possible \nA herd of horses runs freely across the glowing green grassland as the horizon burns orange beneath a deep blue sky. With foals keeping pace beside them and endless open land ahead, this is what freedom looks like in mo…", "media_type": "video", "like_count": 511179, "comment_count": 1086, "author_username": "u•••n", "author_name": "U•••n", "posted_at": "2026-10-09T00:00:05+00:00", "id": "•••", "image_url": "https://scontent-lax3-2.cdninstagram.com/v/t51.82787-15/842492090_18635881834006763_6532142919362048035_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=102&_nc_map=urlgen_bucketless&ig_cache_key=NDAwMzc0ODY0OTg5NjUwMjc0MTI3MTQ0Nzg5MjIyOTg1MTc%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2Rl…", "video_url": "https://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m86/AQM2_t64OHeUMHkiRrk_oXg1Fx13dHC8EsQn7qj4IoemJfIvUpgbG3jJW2XmbBs8bY50LXtPWvDOXmiZSLWZDp2wzEkz4BnWJxCfgVw.mp4?_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=wZRSYNl-XEkQ7kNvwHmXjUk&efg=eyJ2ZW5jb2RlX…", "author_id": "•••", "width": 1080, "height": 1920, "is_comments_disabled": false, "hashtags": [ "HorseHerd", "GrasslandLife", "skypixel" ], "product_type": "clips", "share_count": 60416, "repost_count": 18769, "duration_sec": 8, "duration_estimated": true, "video_url_expires_at": "2026-11-22T16:50:32+00:00", "video_hd_url": "https://scontent-lax3-1.cdninstagram.com/o1/v/t2/f2/m367/AQPN-g2dLkgxeaSoGKlyRAv2pWmGWM1UkRFftBDUO0jdVuUhnHdK8QcM3DCbtKs8ZnhTj1cCRrKGDsWmGRa8V4tXDKhL55Yxk0zd4Dg.mp4?_nc_cat=110&_nc_sid=9ca052&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_ohc=C84pV4KywUEQ7kNvwGt_uFU&efg=eyJ2ZW5jb2Rl…", "video_hd_height": 1920, "audio_url": "https://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m78/AQPDbrFss6LkseyEhe_bmqad9lEJ2BRsKkerSbbg58Yi-ojglE1qQF6hgNhDgLSOxrXDlWa3jQ9pVZZO7ri70bIitcJNpJAwkdyFhwg.mp4?_nc_cat=108&_nc_sid=9ca052&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=A1ZyzcC_ICQQ7kNvwEm4pbF&efg=eyJ2ZW5jb2RlX…", "video_hd_expires_at": "2026-11-25T18:23:31+00:00", "is_paid_partnership": false, "author_is_verified": true, "author_is_private": false, "author_avatar_url": "https://scontent-lax3-2.cdninstagram.com/•••", "music": { "artist": "usmanaryan", "title": "Original audio", "audio_id": "38684869254489915", "is_original": true, "is_trending": false, "url": "https://www.instagram.com/reels/audio/38684869254489915/" }, "platform": "instagram", "duration_seconds": 8 } ], "next_page_token": …, "pagination": { … }, "count": 10, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
返回字段
#业务数据在 results 里;下表是每条记录可能包含的字段,平台没有提供的值不会被编造。
| 字段 | 含义 |
|---|---|
post_id | 帖子短码,就是链接里 /p/ 或 /reel/ 后面那段(不是数字编号)。 |
url | 该记录在原平台上的可访问链接。 |
text | 正文内容,已去除 HTML 标签,全文返回、不截断(个别平台的列表结果本身只有摘要,以该平台的字段说明为准)。 |
media_type | 取值只有两个:video(视频,Reels 也是 video)、image(图片;轮播帖也记作 image,有 product_type 时,product_type 为 carousel_container 的就是轮播)。 |
like_count | 点赞数。null 表示该平台或该接口不公开此数据,不等于 0。 |
comment_count | 评论数。null 表示不公开,不等于 0。 |
author_username | 作者用户名(@handle),通常可用于拼 URL。 |
author_name | 作者昵称(显示名)。 |
posted_at | 发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。 |
location | 地理位置描述,原文透传,格式随平台而异。 |
id | 该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。 |
image_url | 图片链接。多图能力可能返回 image_urls 数组。 |
video_url | 视频文件链接:带声音的完整 mp4,能直接播放。轮播帖里有视频时是第一个视频;不是视频时不出现。链接带签名,会过期;有 video_url_expires_at 时以它为准。 |
author_id | 作者在原平台的唯一 ID。 |
width | 原图或原视频的宽,像素。 |
height | 原图或原视频的高,像素。 |
is_comments_disabled | 帖子是否关闭评论。 |
author_follower_count | 作者粉丝数。null 表示不公开。 |
hashtags | 正文里的话题标签数组,按出现顺序;没有时不出现这个字段。 |
top_comments | 帖子下展示的几条评论,每项含正文(text)和评论人(author_username);没有时不出现这个字段。 |
product_type | Instagram 自己分的内容形态:feed 普通帖、clips Reels、carousel_container 轮播、longform 长视频。 |
play_count | 播放量。 |
fb_play_count | 作者把这条同时发到 Facebook 时,Facebook 那边的播放数;只有这样的帖子才出现。 |
fb_like_count | 作者把这条同时发到 Facebook 时,Facebook 那边的点赞数;只有这样的帖子才出现。 |
fb_comment_count | 作者把这条同时发到 Facebook 时,Facebook 那边的评论数;只有这样的帖子才出现。 |
share_count | 分享/转发数。null 表示不公开,不等于 0。 |
repost_count | 转发数(区别于引用转发)。null 表示不公开。 |
duration_sec | 时长,秒。 |
duration_seconds | 时长,单位秒。非视频/音频内容为 null。 |
duration_estimated | 为 true 表示 duration_sec 是从视频链接里读出的整秒数,和精确时长最多差 1 秒。只在这样读出时出现。 |
image_count | 图片张数:单图帖为 1;轮播帖是里面图片的张数,不算视频。 |
video_count | 轮播帖里视频的个数;只有轮播帖有。 |
video_url_expires_at | video_url 的过期时间,ISO 8601,UTC。 |
video_hd_url | 清晰度最高的视频画面轨:只有画面、没有声音。会过期,过期时间见 video_hd_expires_at。要带声音的视频,把它和 audio_url 合成(比如用 ffmpeg 合并两条轨),或者直接用 video_url。 |
video_hd_height | video_hd_url 的画面高度,像素。 |
audio_url | 视频的音轨,只有声音;和 video_hd_url 差不多同时过期(见 video_hd_expires_at)。视频没有单独的音轨时(比如无声视频)不出现。 |
video_hd_expires_at | video_hd_url 的过期时间,ISO 8601,UTC;audio_url 差不多同时过期。 |
is_paid_partnership | 帖子是否标了「付费合作」(Paid partnership)。页面给了这项信息才出现,可能为 false。 |
is_pinned | 是否置顶。帖子(user_posts、tagged_posts、recent_posts,以及 location_posts、audio_posts、explore 等返回帖子的接口):被作者置顶在主页网格或 Reels 标签页,只在置顶时出现,值为 true。评论(comments):被帖子作者置顶,只在置顶时出现,值为 true。精选(highlights):是否被置顶在主页精选栏最前。 |
likes_hidden | 作者隐藏了点赞数。只在隐藏时出现,值为 true;这时一般没有 like_count。 |
caption_is_edited | 正文编辑过。只在编辑过时出现,值为 true。 |
accessibility_caption | Instagram 自动生成的图片描述(替代文字,英文)。 |
author_is_verified | 作者账号是否有认证标。出现在 user_posts、tagged_posts、location_posts、audio_posts、explore、stories、comment_replies,以及 post、discover、reels、hashtag、reels_search 的行里(有值才出现)。 |
author_is_private | 作者是不是私密账号。 |
author_avatar_url | 作者头像图片链接(多数平台带签名、会过期)。 |
posted_at_estimated | 为 true 表示页面没给发布时间,posted_at 是按帖子的数字编号(id)推算出的上传时间;一般和发布时间相同,定时发布的帖子会早一些。只在推算时出现(tagged_posts 常见)。 |
mentions | 正文里 @ 到的用户名,数组。 |
tagged_users | 图片、视频里被标记的人的用户名,数组;轮播帖里每一张的都算。 |
coauthors | 合著者:和作者一起署名发这条帖子的账号的用户名,数组。 |
sponsors | 付费合作里标注的品牌方账号的用户名,数组。 |
media | 轮播帖里的每一张,一张一项:type(image 或 video)、image_url(图片地址,视频是封面图;带签名,会过期)、video_url(只有视频有,带声音的 mp4)、width、height(像素)。只有轮播帖有。 |
music | 帖子或 Reels 用的音乐,对象:歌手(artist)、曲名(title);有的还带 audio_id(音乐编号)、is_original(true 是作者自己录的原声,false 是曲库里的歌)、is_explicit(曲库歌曲是否标了含露骨内容)、is_trending(原声是否正在流行,只有原声有)、url(Instagram 上这段音乐的页面)。原声的 title 一般是 Original audio,artist 是原声作者的用户名。没有时不出现这个字段。 |
platform | 数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。 |
location_detail | 帖子挂的地点的详细信息,对象:id(地点编号)、name(地点名,和 location 相同)、short_name(短名)、city、address、lat、lng、url(Instagram 上这个地点的页面),有的才带。没挂地点时不出现。 |
错误与计费
#- 401
- 缺少 Key 或 Key 无效。
- 402
- 余额不足,先充值。
- 422
- 参数名或取值不对,按错误信息给的候选改;不扣费。
- 429
- 超过每分钟请求上限,按 Retry-After 等待后再试。
- 503
- 暂时无法完成,预扣的费用退回;结果未知时先核对,不要直接重发。
- 200 空结果
- 没有数据,不扣费。
官方资料参照
#只用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。
- Instagram 帮助中心:推荐 Reels 如何选出 ↗
Instagram 帮助中心说明,Reels 标签、Explore 和信息流里会出现关注账号的 Reel 和推荐账号的 Reel,推荐的 Reel 按你关注的账号、最近看过、点赞或互动过的 Reel 等因素选出。可证明推荐 Reels 是 Instagram 的官方入口,结果因人而异;不证明本接口每页 10 条、每次不同的取法,也不证明字段内容和顺序。
核对于 2026-11-21
常见问题
Instagram 推荐 Reels 接口返回什么?
每行一条推荐的 Reel:post_id、url、text、media_type、like_count、comment_count、author_username、posted_at、video_url。
每次结果一样吗?
不一样。每次调用的内容不同,不是榜单,不要拿两次结果当同一份名单对比。
怎么拿到某条 Reel 的播放数?
这一项的行里没有 view_count。把某行的 url 交给 post,读它的完整数据。
读一页要多少钱?
每次 $0.001181,每千次 $1.18,每页算一次调用,不按行数算。失败和空结果不收费。
要登录 Instagram 吗?
不用。请求头里放一把 EveryInfra API Key(Authorization: Bearer),不需要 Instagram 登录或访问令牌。
相关的 Instagram 能力
同一把 Key 还能调用 Instagram 的其他能力,比如用 post 读某条推荐 Reel 的完整数据。
- 单条内容
post每千次 $0.56单条内容:返回列表,默认 11 条、单次最多 11 条;主要字段 post_id、url、text、media_type、like_count、comment_count。 - 主页或对象详情
profile每千次 $0.56主页或对象详情:返回单个对象;主要字段 username、display_name、bio、follower_count、following_count、post_count。 - 账号画像
persona每千次 $0.56账号画像:返回单个对象;主要字段 username、display_name、bio、follower_count、following_count、post_count。 - 用户内容
user_posts每千次 $0.56用户内容:返回列表,默认 30 条、单次最多 200 条;主要字段 post_id、url、text、media_type、like_count、comment_count。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 内容发现
discover每千次 $0.56内容发现:返回列表,默认 30 条、单次最多 200 条;主要字段 post_id、url、text、media_type、like_count、comment_count。 - 评论
comments每千次 $0.79评论:返回列表,默认 50 条、单次最多 100 条;主要字段 id、text、url、like_count、reply_count、author_username。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - Reels 短视频
reels每千次 $1.19Reels 短视频:返回列表,默认 30 条、单次最多 100 条;主要字段 post_id、url、text、media_type、like_count、comment_count。 - 话题内容
hashtag每千次 $0.56话题内容:返回列表,默认 30 条、单次最多 30 条(传更大的数按 30 条返回);主要字段 post_id、url、text、media_type、like_count、comment_count。 - 粉丝数量
followers每千次 $0.56粉丝数量:返回单个对象;主要字段 id、username、url、name、avatar_url、follower_count。 - 粉丝列表
followers_list每千次 $0.56粉丝列表:返回列表,默认 50 条、单次最多 500 条;主要字段 id、username、url、name、avatar_url、is_private。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 关注列表
following_list每千次 $0.56关注列表:返回列表,默认 50 条、单次最多 500 条;主要字段 id、username、url、name、avatar_url、is_private。 - 账号搜索
user_search每千次 $4.81账号搜索:返回列表,默认 20 条、单次最多 30 条;主要字段 rank、username、user_id、display_name、is_verified、is_private。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - Reels 关键词搜索
reels_search每千次 $7.19Reels 关键词搜索:返回列表,默认 20 条、单次最多 200 条;主要字段 post_id、id、url、text、play_count、like_count。 - 相似账号
similar_profiles每千次 $8.81相似账号:返回列表,默认 20 条、单次最多 30 条;主要字段 rank、username、user_id、display_name、is_verified、is_private。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 被标记的帖子
tagged_posts每千次 $7.44被标记的帖子:返回列表,默认 20 条、单次最多 200 条;主要字段 post_id、url、tagged_username、author_username、author_id、text。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - Stories 内容
stories每千次 $1.5Stories 内容:返回列表,默认 100 条、单次最多 100 条(传更大的数按 100 条返回);主要字段 id、url、media_url、media_type、duration_seconds、duration_sec。 - 精选合集
highlights每千次 $1.6精选合集:返回列表,默认 100 条、单次最多 100 条(传更大的数按 100 条返回);主要字段 id、url、title、media_count、cover_url、created_at。 - 评论回复
comment_replies每千次 $0.88评论回复:返回列表,每次一页、每页最多 10 条,条数不固定(短页不代表到底),要更多就把响应顶层的 next_page_token 作为 page_token 再调,没有 next_page_token 才是到底;limit 照收但不起作用;主要字段 id、text、like_count、posted_at、author_username、author_id。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 点赞用户列表
likers每千次 $1.32点赞用户列表:返回列表,每次一页、每页最多 100 条,条数不固定(短页不代表到底),要更多就把响应顶层的 next_page_token 作为 page_token 再调,没有 next_page_token 才是到底;limit 照收但不起作用;主要字段 id、username、url、name、avatar_url、is_private。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 地点下的帖子
location_posts每千次 $0.56地点下的帖子:返回列表,每次一页、固定 12 条(最后一页可能更少),要更多就把响应顶层的 next_page_token 作为 page_token 再调;limit 照收但不起作用;主要字段 post_id、url、text、media_type、like_count、comment_count。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 同一段音乐的 Reels
audio_posts每千次 $0.56同一段音乐的 Reels:返回列表,每次一页、固定 12 条(最后一页可能更少),要更多就把响应顶层的 next_page_token 作为 page_token 再调;limit 照收但不起作用;主要字段 post_id、url、text、media_type、like_count、comment_count。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 发现页推荐
explore每千次 $0.56发现页推荐:返回列表,每次一页、固定 12 条(最后一页可能更少),要更多就把响应顶层的 next_page_token 作为 page_token 再调;limit 照收但不起作用;主要字段 post_id、url、text、media_type、like_count、comment_count。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 互动率统计
engagement每千次 $0.56互动率统计:返回单个对象;主要字段 username、display_name、url、follower_count、is_verified、sample_size。 - 按编号查账号
profile_by_id每千次 $0.56按编号查账号:返回单个对象;主要字段 username、display_name、bio、follower_count、following_count、post_count。 - 账号所在地与改名记录
user_about每千次 $0.56账号所在地与改名记录:返回单个对象;主要字段 username、user_id、joined_at、joined_text、country、former_usernames_count。 - 地点资料
location_info每千次 $0.56地点资料:返回单个对象;主要字段 location_id、name、category、lat、lng、address。 - 链接识别
resolve_links每千次 $0.56链接识别:返回单个对象;主要字段 shortcode、media_id、url、platform。 - 帖子嵌入代码
oembed每千次 $0.56帖子嵌入代码:返回单个对象;主要字段 version、type、title、author_name、author_url、author_id。 - 帖子正文翻译
post_translation每千次 $6.39帖子正文翻译:返回单个对象;主要字段 media_id、shortcode、url、author_username、text、translation。 - 附近的地点
location_nearby每千次 $0.56附近的地点:返回列表,每个目标一页、每页最多 20 条,没有 next_page_token(要往后读,用单目标能力逐个翻页);limit 照收但不起作用;主要字段 rank、location_id、name、category、lat、lng。 - 话题搜索
hashtag_search每千次 $0.56话题搜索:返回列表,每个目标一页、每页最多 15 条,没有 next_page_token(要往后读,用单目标能力逐个翻页);limit 照收但不起作用;主要字段 rank、name、id、post_count、post_count_label、url。 - 精选合集里的快拍
highlight_stories每千次 $0.56精选合集里的快拍:返回列表,每个目标一页、每页最多 100 条,没有 next_page_token(要往后读,用单目标能力逐个翻页);limit 照收但不起作用;主要字段 id、url、media_url、media_type、duration_seconds、duration_sec。 - 评论翻译
comment_translations每千次 $6.39评论翻译:返回列表,每个目标一页、每页最多 10 条,没有 next_page_token(要往后读,用单目标能力逐个翻页);limit 照收但不起作用;主要字段 comment_id、text、translation、source_language、target_language、author_username。 - 账号转发的帖子
user_reposts每千次 $0.56账号转发的帖子:返回列表,每次一页、固定 12 条(最后一页可能更少),要更多就把响应顶层的 next_page_token 作为 page_token 再调;limit 照收但不起作用;主要字段 post_id、url、text、media_type、like_count、comment_count。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 国家下的城市
location_cities每千次 $0.56国家下的城市:返回列表,每次一页、固定 96 条(最后一页可能更少),要更多就把响应顶层的 next_page_token 作为 page_token 再调;limit 照收但不起作用;主要字段 rank、city_id、name、slug、url、country_code。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 城市下的地点
city_locations每千次 $0.56城市下的地点:返回列表,每次一页、固定 96 条(最后一页可能更少),要更多就把响应顶层的 next_page_token 作为 page_token 再调;limit 照收但不起作用;主要字段 rank、location_id、name、slug、url、city_id。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 批量查账号
profiles_batch每千次 $0.56批量查账号:返回列表;主要字段 username、display_name、bio、follower_count、following_count、post_count。