Instagram 账号转发的帖子 API

按 username 列出一个账号转发到自己主页的帖子和 Reels:reposted_by 是这个账号,author_username 是原作者,每千次 $0.56。

  • username 可带 @,也收主页链接
  • 用 page_token 翻页
  • 失败和空结果不收费
免费开始

接口健康状态

24h 健康值
正常
  • 健康 / 正常
  • 可用
  • 少量可用
  • 基本不可用
正常

24 小时趋势

30 天趋势

  1. 1请求

    POST /api/v1/social
    {
      "platform": "instagram",
      "action": "user_reposts",
      "params": {
        "username": "instagram"
      }
    }
  2. 2JSON 响应

    {
      "results": [
        {
          "text": "I gave a 102 year old veteran a free haircut in New Orleans 🥹💈 Coming from a military household, the respect I have for Sam is huge. Wait for his reaction in the end! 👀 @••• #metaglassespartner",
          "post_id": "Dfm-H73tGFW",
          "media_type": "video",
          "like_count": 98658
        },
        …
      ],
      "count": 12
    }
  3. 3表格行

    textpost_idmedia_typelike_count
    I gave a 102 year old veteran a free haircut in New Orleans 🥹💈 Coming from a military household, the respect I have for Sam is huge. Wait for his reaction in the end! 👀 @••• #metaglassespartnerDfm-H73tGFWvideo98658
    Instagram Rings is back for year two, honoring creators who take bold creative risks. This year’s winners were chosen by a panel of global icons, including São Paulo-based twin brothers Gustavo and Otavio Pandolfo, known around the world as @••• Translating to “the twins” in Por…DewkaTjx0cgvideo14721
  4. 4CSV

    instagram-user_reposts-sample.csv post_id,url,text,media_type,like_count,comment_count,view_count,author_username,author_name,posted_at,location,id,image_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,reposted_by

请求带 username,同一个响应里回来这个账号转发的一页帖子,每行有 reposted_by、author_username、text 等字段,再变成表格行和 CSV。

能拿到什么数据

表里是一次真实调用的结果:账号 instagram,2026年11月21日 15:27(UTC)采集,返回 12 条;灰条是隐去的个人信息(CSV 里是 •••)。你自己调用时,按字段表返回这些字段。

post_idurltextmedia_typelike_countcomment_countview_countauthor_usernameauthor_nameposted_atlocationidimage_urlauthor_idwidthheightis_comments_disabledauthor_follower_counthashtagstop_commentsproduct_typeplay_countfb_play_countfb_like_countfb_comment_countshare_countrepost_countduration_secduration_secondsduration_estimatedimage_countvideo_countvideo_url_expires_atvideo_hd_urlvideo_hd_heightaudio_urlvideo_hd_expires_atis_paid_partnershipis_pinnedlikes_hiddencaption_is_editedaccessibility_captionauthor_is_verifiedauthor_is_privateauthor_avatar_urlposted_at_estimatedmentionstagged_userscoauthorssponsorsmediamusicplatformlocation_detailreposted_by
Dfm-H73tGFWhttps://www.instagram.com/reel/Dfm-H73tGFW/I gave a 102 year old veteran a free haircut in New Orleans 🥹💈 Coming from a military household, the respect I have for Sam is huge. Wait for his reaction in the end! 👀 @••• #metaglassespartnervideo986581842nullv•••sV•••s2026-11-11T17:01:54+00:00nullhttps://scontent-lax3-1.cdninstagram.com/v/t51.82787-15/902369030_1899035388199307_5962336793192342884_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=1&ig_cache_key=NDAyODE4MDE0MDkzNDg0ODg1NDE4OTkwMzUzODE1MzI2NDE%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjEyM…10801920falsenull["metaglassespartner"]nullclipsnullnullnullnullnullnullnullnullnullnullnullnullnullnullnullnullnullnullnullnullnulltruefalsetrue["•••"]null["•••"]nullnullnullinstagramnullinstagram
DewkaTjx0cghttps://www.instagram.com/reel/DewkaTjx0cg/Instagram Rings is back for year two, honoring creators who take bold creative risks. This year’s winners were chosen by a panel of global icons, including São Paulo-based twin brothers Gustavo and Otavio Pandolfo, known around the world as @••• Translating to “the twins” in Por…video14721594nulld•••nI•••n2026-10-21T13:58:14+00:00nullhttps://scontent-lax3-1.cdninstagram.com/v/t51.82787-15/859115162_18379272730210574_3098799849320063870_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=106&_nc_map=urlgen_bucketless&ig_cache_key=NDAxMjg2NzQwNTM2OTI2MzkwNDE4Mzc5MjcyNzI3MjEwNTc0.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3…10801920falsenullnullnullclipsnullnullnullnullnullnullnullnullnullnullnullnullnullnullnullnullnulltruenullnullnulltruefalsetrue["•••"]null["•••"]nullnullnullinstagramnullinstagram

用途

  • 看一个账号转发什么内容

    读 text 和 media_type,了解它愿意放到自己主页上的内容。

  • 找被转发的原作者

    读 author_username,列出这个账号转发过谁的内容。

  • 梳理品牌账号的转发

    给品牌账号的 username,看它转发了哪些别人发的帖子。

  • 对比转发的互动

    对着 like_count 和 comment_count,看哪些转发的原帖互动高。

Instagram Graph API 与 EveryInfra 对比

下面从能读谁的数据,比 Instagram 官方 Graph API 和 EveryInfra user_reposts。

对比项Instagram Graph APIEveryInfra
能读谁的数据权限范围:"Note that a permission only allows access to data created by the app user who granted the permission."username 指定的账号转发的帖子,是公开可见的内容,不限于你自己的账号。

引文出自 Meta 开发者文档,2026-11-22 核对;这里只比接入条件。 官方出处: Instagram Platform overview (更新于 2026-10-29)

限制和注意事项

  • username 必填,如 natgeo,可带 @,也收主页链接。
  • 一次返回一页。响应有 next_page_token 就原样作 page_token 传回,其他参数和第一页一样;令牌 24 小时有效,每页算一次调用;没有 next_page_token 就翻不下去了。
  • reposted_by 是你查的账号,author_username 是原作者。
  • posted_at 是推算的(posted_at_estimated 为 true),也没有 video_url;要这两项,把某行的 url 交给 post。
  • 账号不存在或没有转发时返回空结果,不扣费。

价格

每次调用 $0.000556,按次计费,不按行数算。每翻一页算一次调用。失败和空结果不收费。

调用次数费用
10,000$5.56
100,000$55.56
1,000,000$555.56

合计按每次调用的标价算。

代码示例

#
bash
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": "user_reposts",
  "params": {
    "username": "instagram"
  }
}'

OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key,复制出去的代码不含你的 Key。

API 参考

下面是 user_reposts 的参数、响应字段、错误和计费,可以复制整页,或用 Markdown 打开后交给 AI 助手。

POST

AI 提示词

#
请帮我用 EveryInfra 的「Instagram 账号转发的帖子」接口(instagram/user_reposts)写一个数据采集脚本。

接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 instagram,action 填 user_reposts,参数放在 params 里。
- 必填参数:
  - username:要查的 Instagram 账号用户名,如 natgeo(可带 @,也收主页链接)。返回这个账号转发到自己主页的帖子和 Reels,一页 12 条。
- 可选参数:
  - page_token:翻页令牌:把上一次响应里的 next_page_token 原样传回,拿下一页;不传是第一页。翻页时其他参数要和第一页一样。令牌 24 小时有效,每页算一次调用。没有 next_page_token 就是翻不下去了。
- 返回一组记录,每条记录的主要字段:post_id(帖子短码)、url、text、media_type(取值只有两个:video(视频)、like_count、comment_count、view_count、author_username、author_name、posted_at、location、id;一共 54 个字段,完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=instagram。
- 示例请求体:
{
  "platform": "instagram",
  "action": "user_reposts",
  "params": {
    "username": "instagram"
  }
}
- 计费:$0.56 / 千次;失败和空结果不扣费。
- 一次要采几十上百个时,在请求体加 "mode": "async":先拿到 job_id,再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时,按错误信息里的候选参数和允许值修正;返回 429 或 503 时,按 Retry-After 等待后重试。

写代码前,先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式,再把方案和大概花费讲给我确认。

请求参数

#
参数名位置类型必填默认值说明
Authorizationheaderstring是-Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。
platformbodystring是instagram平台标识,固定值。
actionbodystring是user_reposts能力标识,固定值。
usernamebody.paramsstring是-要查的 Instagram 账号用户名,如 natgeo(可带 @,也收主页链接)。返回这个账号转发到自己主页的帖子和 Reels,一页 12 条。
page_tokenbody.paramsstring否-翻页令牌:把上一次响应里的 next_page_token 原样传回,拿下一页;不传是第一页。翻页时其他参数要和第一页一样。令牌 24 小时有效,每页算一次调用。没有 next_page_token 就是翻不下去了。

响应示例

#
2026年11月21日 15:27(北京时间)用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回,已隐去名字、账号、头像、主页链接、联系方式等个人信息,列表只保留前 2 条;id、billing、quota 每次调用都不同,只给结构。
json
{  "id": "req_…",  "platform": "instagram",  "action": "user_reposts",  "results": [    {      "post_id": "Dfm-H73tGFW",      "url": "https://www.instagram.com/reel/Dfm-H73tGFW/",      "text": "I gave a 102 year old veteran a free haircut in New Orleans 🥹💈 Coming from a military household, the respect I have for Sam is huge. Wait for his reaction in the end! 👀 @••• #metaglassespartner",      "media_type": "video",      "like_count": 98658,      "comment_count": 1842,      "author_username": "v•••s",      "author_name": "V•••s",      "posted_at": "2026-11-11T17:01:54+00:00",      "id": "•••",      "image_url": "https://scontent-lax3-1.cdninstagram.com/v/t51.82787-15/902369030_1899035388199307_5962336793192342884_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=1&ig_cache_key=NDAyODE4MDE0MDkzNDg0ODg1NDE4OTkwMzUzODE1MzI2NDE%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjEyM…",      "author_id": "•••",      "width": 1080,      "height": 1920,      "is_comments_disabled": false,      "hashtags": [        "metaglassespartner"      ],      "product_type": "clips",      "author_is_verified": true,      "author_is_private": false,      "author_avatar_url": "https://scontent-lax3-1.cdninstagram.com/•••",      "posted_at_estimated": true,      "mentions": [        "•••"      ],      "coauthors": [        "•••"      ],      "platform": "instagram",      "reposted_by": "instagram"    },    {      "post_id": "DewkaTjx0cg",      "url": "https://www.instagram.com/reel/DewkaTjx0cg/",      "text": "Instagram Rings is back for year two, honoring creators who take bold creative risks. This year’s winners were chosen by a panel of global icons, including São Paulo-based twin brothers Gustavo and Otavio Pandolfo, known around the world as @•••\n\nTranslating to “the twins” in Por…",      "media_type": "video",      "like_count": 14721,      "comment_count": 594,      "author_username": "d•••n",      "author_name": "I•••n",      "posted_at": "2026-10-21T13:58:14+00:00",      "id": "•••",      "image_url": "https://scontent-lax3-1.cdninstagram.com/v/t51.82787-15/859115162_18379272730210574_3098799849320063870_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=106&_nc_map=urlgen_bucketless&ig_cache_key=NDAxMjg2NzQwNTM2OTI2MzkwNDE4Mzc5MjcyNzI3MjEwNTc0.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3…",      "author_id": "•••",      "width": 1080,      "height": 1920,      "is_comments_disabled": false,      "product_type": "clips",      "is_pinned": true,      "author_is_verified": true,      "author_is_private": false,      "author_avatar_url": "https://scontent-lax3-1.cdninstagram.com/•••",      "posted_at_estimated": true,      "mentions": [        "•••"      ],      "coauthors": [        "•••"      ],      "platform": "instagram",      "reposted_by": "instagram"    }  ],  "next_page_token": …,  "pagination": { … },  "count": 12,  "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。
view_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 数组。
author_id作者在原平台的唯一 ID。
width原图或原视频的宽,像素。
height原图或原视频的高,像素。
is_comments_disabled帖子是否关闭评论。
author_follower_count作者粉丝数。null 表示不公开。
hashtags正文里的话题标签数组,按出现顺序;没有时不出现这个字段。
top_comments帖子下展示的几条评论,每项含正文(text)和评论人(author_username);没有时不出现这个字段。
product_typeInstagram 自己分的内容形态: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_atvideo_url 的过期时间,ISO 8601,UTC。
video_hd_url清晰度最高的视频画面轨:只有画面、没有声音。会过期,过期时间见 video_hd_expires_at。要带声音的视频,把它和 audio_url 合成(比如用 ffmpeg 合并两条轨),或者直接用 video_url。
video_hd_heightvideo_hd_url 的画面高度,像素。
audio_url视频的音轨,只有声音;和 video_hd_url 差不多同时过期(见 video_hd_expires_at)。视频没有单独的音轨时(比如无声视频)不出现。
video_hd_expires_atvideo_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_captionInstagram 自动生成的图片描述(替代文字,英文)。
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 上这个地点的页面),有的才带。没挂地点时不出现。
reposted_by(user_reposts)转发这条帖子的账号,就是你查的那个账号;author_username 是原作者。

错误与计费

#
401
缺少 Key 或 Key 无效。
402
余额不足,先充值。
422
参数名或取值不对,按错误信息给的候选改;不扣费。
429
超过每分钟请求上限,按 Retry-After 等待后再试。
503
暂时无法完成,预扣的费用退回;结果未知时先核对,不要直接重发。
200 空结果
没有数据,不扣费。

错误码

官方资料参照

#

只用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。

  • Instagram 帮助中心:转发 Reel 和帖子(Repost) ↗

    Instagram 帮助中心说明,可以转发公开的 Reel 或帖子,转发后会出现在个人主页专门的 Reposts 标签里;只能转发原作者发布的内容,不能转发别人的转发,原作者可以关闭转发。可证明「账号转发的帖子」是 Instagram 的官方对象,列在转发者主页的 Reposts 标签;不证明本接口每页 12 条、posted_at_estimated 的推算和字段内容,也不证明能读任意公开账号的转发。

    核对于 2026-11-21

常见问题

Instagram 账号转发接口返回什么?

每行一条转发的帖子或 Reel:post_id、url、text、media_type、like_count、comment_count、author_username、posted_at,还有 reposted_by。

reposted_by 和 author_username 有什么区别?

reposted_by 是你查的那个账号,author_username 是原帖的作者。

posted_at 准吗?

大多数时候准。posted_at 是按帖子编号推算的上传时间(posted_at_estimated 为 true),一般和发布时间相同,定时发布的帖子会早一些。要准确的发布时间,把某行的 url 交给 post。

读一页要多少钱?

每次 $0.000556,每千次 $0.56,每页算一次调用,不按行数算。失败和空结果不收费。

要登录 Instagram 吗?

不用。请求头里放一把 EveryInfra API Key(Authorization: Bearer),请求只带 username,不需要 Instagram 登录或访问令牌。

同一把 Key 还能调用 Instagram 的其他能力,比如用 user_posts 读这个账号自己发的帖子。

Google Analytics 同意才加载 隐私