Instagram

Instagram API

用一把 EveryInfra API Key 读取 Instagram 的账号、帖子和 Reels、评论与快拍,返回 JSON,每千次 $0.56 起。

  • 失败和空结果不收费
  • 不用登录 Instagram
  • 18 个能力,一把 Key

nasa 的真实样本值

POST /api/v1/social params {"username":"nasa"}

对 nasa 做的真实样本调用,2026年9月26日 – 2026年10月31日(UTC)采集;每个框链接到对应的能力页。

平台运行状态

24h 健康值
86%
可用

30 天趋势

Instagram 能力清单

按 Instagram 账号、作品链接或话题标签读取帖子、Reels、评论及可得账号资料;粉丝数量与关系名单分开查询,账号发帖整理需等待异步结果。

请求发到 POST https://api.everyinfra.com/api/v1/social,platform 填 instagram,action 填下方列表里的能力名,例如 post。

账号

  • 主页或对象详情健康 · 健康值 100%

    用 profile 查询账号,区分专业账号、企业账号与认证标记。

    profile每千次 $0.56

  • 用 persona 在账号资料之外尝试生成摘要,不能把模型判断当作平台认证事实。

    persona每千次 $0.56

  • 用 followers 取得轻量账号计数,名单需使用 followers_list。

    followers每千次 $0.56

  • 需要账号条目时使用 followers_list,不把数量接口当作名单。

    followers_list每千次 $0.56

  • 用 following_list 看关注方向,不与 followers_list 的粉丝方向互换。

    following_list每千次 $0.56

  • 账号搜索基本不可用 · 健康值 4%

    用 user_search 按关键词搜 Instagram 账号,按搜索名次拿到每个账号的粉丝数、关注数和简介。

    user_search每千次 $4.81

  • 用 similar_profiles 按一个账号拿到 Instagram 推荐的相似账号,按粉丝数从多到少排。

    similar_profiles每千次 $8.81

帖子和 Reels

  • 把选定的帖子或 Reel 链接放入 urls,读取对应内容。

    post每千次 $0.56

  • 用户内容可用 · 健康值 88%

    按 Instagram handle 提交 user_posts 任务,完成后再整理帖子。

    user_posts每千次 $0.56

  • Reels 短视频健康 · 健康值 100%

    按账号 handle 读取 Reels,对照短视频时长、播放数和配乐。

    reels每千次 $1.19

  • 用 reels_search 按关键词搜 Reels,按播放、点赞、评论数比较热度。

    reels_search每千次 $7.19

  • 用 tagged_posts 列出别人发的、标记了某个账号的公开帖子。

    tagged_posts每千次 $7.44

  • 话题内容少量可用 · 健康值 52%

    按 hashtag 获取话题下的内容,比较文案与媒体类型。

    hashtag每千次 $0.56

  • 内容发现健康 · 健康值 96%

    用 discover 查询 hashtag 相关内容,而不是任意全文搜索。

    discover每千次 $0.56

评论

  • 评论正常

    用 comments 处理一个作品的评论,不沿用 post 的多链接输入形状。

    comments每千次 $0.79

  • 评论回复暂不可用

    用 comment_replies 读帖子里某条评论下的回复,带点赞数、时间和回复人。

    comment_replies每千次 $0.88

快拍

  • 用 stories 读一个账号此刻在线的快拍,带媒体链接、类型和发布时间。

    stories每千次 $1.5

  • 用 highlights 列出账号主页上的精选快拍合集,带标题、封面和条数。

    highlights每千次 $1.6

用途

Instagram 官方 API 与 EveryInfra 对比

下面从能读哪些账号、消费者应用和访问条件三方面,比较 Instagram 官方 API 和 EveryInfra。

对比项Instagram 官方 APIEveryInfra
能读哪些账号"Get fields and edges on an Instagram Business or Creator Account." Business Discovery:"Data about age-gated Instagram professional accounts will not be returned."请求里写明的账号,比如 nasa;user_search 按关键词找账号。
消费者应用"After December 4th, 2024, there will no longer be a set of Instagram APIs for consumer developer apps."不用登录 Instagram,也不用访问令牌;发送 POST /api/v1/social,带上 platform、action 和 params。
访问条件访问令牌:"Facebook User access token" 或 "Instagram User user access token";权限 instagram_basic 或 instagram_business_basic。一把 EveryInfra API Key 放在 Authorization: Bearer 请求头里。

引文出自 Meta 开发者文档和开发者博客,2026-11-09 核对。 官方出处: IG User (更新于 2026-04-22) · Business Discovery (更新于 2026-08-12) · Update on Instagram Basic Display API (更新于 2024-09-04)

Instagram 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social, 切换 action 时,也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象;请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料,用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准,不与平台官方 API 直接等同。

全部 18 个能力的参数表
能力必填参数可选参数单次条数模式单价返回字段
posturls—默认 11 · 最多 11同步$0.56 / 千次post_id · url · text · media_type · like_count · comment_count · view_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
profileusername——同步$0.56 / 千次username · display_name · bio · follower_count · following_count · post_count · is_private · is_verified · is_business · is_professional · category · external_url · avatar_url · user_id · avatar_hd_url · external_urls · has_reels · highlight_count · recent_posts
personausername——同步$0.56 / 千次username · display_name · bio · follower_count · following_count · post_count · is_private · is_verified · is_business · is_professional · category · external_url · avatar_url · user_id · avatar_hd_url · external_urls · has_reels · highlight_count · recent_posts
user_postsusername—默认 30 · 最多 200异步$0.56 / 千次post_id · url · text · media_type · like_count · comment_count · view_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
discoverkeywordresults_type默认 30 · 最多 200异步$0.56 / 千次post_id · url · text · media_type · like_count · comment_count · view_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
commentsurl—默认 50 · 最多 100同步$0.79 / 千次id · text · url · like_count · reply_count · author_username · author_name · is_verified · posted_at · post_url · platform
reelsusername—默认 30 · 最多 100同步$1.19 / 千次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 · hashtags · play_count · duration_sec · duration_seconds · music · platform
hashtaghashtagresults_type, tag默认 30 · 最多 100同步$0.56 / 千次post_id · url · text · media_type · like_count · comment_count · view_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 · platform
followersusername——同步$0.56 / 千次id · username · url · name · avatar_url · follower_count · following_count · platform
followers_listusername—默认 50 · 最多 500同步$0.56 / 千次id · username · url · name · avatar_url · is_private · is_verified · relation · of_user · platform
following_listusername—默认 50 · 最多 500同步$0.56 / 千次id · username · url · name · avatar_url · is_private · is_verified · relation · of_user · platform
user_searchkeyword—默认 20 · 最多 30异步$4.81 / 千次rank · username · user_id · display_name · is_verified · is_private · url · avatar_url · follower_count · following_count · post_count · bio · external_url · platform
reels_searchkeyword—默认 20 · 最多 200同步$7.19 / 千次post_id · id · url · text · play_count · like_count · comment_count · duration_sec · duration_seconds · author_username · author_id · is_verified · posted_at · platform
similar_profilesusername—默认 20 · 最多 30异步$8.81 / 千次rank · username · user_id · display_name · is_verified · is_private · url · avatar_url · follower_count · following_count · post_count · bio · external_url · similar_to · platform
tagged_postsusername—默认 20 · 最多 200同步$7.44 / 千次post_id · url · tagged_username · author_username · author_id · text · like_count · comment_count · is_video · posted_at · image_url · platform
storiesusername—默认 100 · 最多 100同步$1.5 / 千次id · url · media_url · media_type · duration_seconds · duration_sec · posted_at · author_username · author_name · author_avatar_url · author_is_verified · platform
highlightsusername—默认 100 · 最多 100同步$1.6 / 千次id · url · title · media_count · cover_url · created_at · updated_at · is_pinned · author_username · author_id · author_name · platform
comment_repliesurl, comment_idpage_token每页 10 条同步$0.88 / 千次id · text · like_count · posted_at · author_username · author_id · author_url · author_avatar_url · author_is_verified · reply_to_id · post_url · next_page_token · platform
每个能力的参数怎么填(18 个能力)

怎么调用 Instagram 单条内容 API?

post

使用 platform="instagram"、action="post" 调用“单条内容”能力;返回列表,默认 11 条、单次最多 11 条,主要包含 post_id、url、text、media_type、like_count、comment_count 等 21 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Instagram post 的参数分别是什么意思?

urls必填
post 的帖子完整链接数组,例如 /p/<shortcode>/ 或 /reel/<shortcode>/;按目标链接数计费。comments 只处理单个 url,不要把 post 的多链接请求形状直接套过去。

Instagram 说明私密账号内容不可嵌入,公开账号也可以关闭嵌入。可分享或可嵌入不等于获得额外的数据访问权限;本接口的输入和可用范围仍按上方说明。官方来源:Instagram:公开帖子与嵌入边界来源核查:

Instagram 返回字段与含义(4)
post_id
帖子 ID。
media_type
媒体类型(图/视频/轮播)。
top_comments
帖子下展示的几条评论,每项含正文(text)和评论人(author_username);没有时不出现这个字段。
is_comments_disabled
帖子是否关闭评论。

怎么调用 Instagram 主页或对象详情 API?

profile

使用 platform="instagram"、action="profile" 调用“主页或对象详情”能力;返回单个对象,主要包含 username、display_name、bio、follower_count、following_count、post_count 等 19 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Instagram profile 的参数分别是什么意思?

username必填
Instagram 账号 handle,建议不带 @ 或完整主页 URL。profile/persona/user_posts/reels 查询账号数据;followers 只查粉丝数量,followers_list/following_list 才查粉丝/关注账号列表。

Meta 的 Business Discovery 可按 username 读取符合条件的专业账号资料、粉丝数和媒体数;该能力受账号类型、授权和权限限制,不能证明任意个人账号均可访问,也不为 EveryInfra 的全部 profile 字段和覆盖范围背书。官方来源:Instagram Platform:专业账号资料与 Business Discovery来源核查:

Instagram 返回字段与含义(8)
is_private
是否私密账号。
is_business
是否为商家账号。
is_professional
是否为专业账号(商家或创作者)。
external_url
主页外链。
avatar_hd_url
高清头像链接(avatar_url 是小图)。
external_urls
简介里的全部外链:url、title(external_url 只是第一个)。
has_reels
是否发过 Reels。
highlight_count
精选快拍(Highlights)个数。

怎么调用 Instagram 账号画像 API?

persona

使用 platform="instagram"、action="persona" 调用“账号画像”能力;返回单个对象,主要包含 username、display_name、bio、follower_count、following_count、post_count 等 19 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Instagram persona 的参数分别是什么意思?

username必填
Instagram 账号 handle,建议不带 @ 或完整主页 URL。profile/persona/user_posts/reels 查询账号数据;followers 只查粉丝数量,followers_list/following_list 才查粉丝/关注账号列表。

Meta 的 IG User 资源定义了用户名、账号资料、粉丝数、媒体数和媒体等事实字段,这些字段可以作为后续分析输入;官方没有定义 persona 推断,兴趣、受众画像和风格标签均是 EveryInfra 的衍生结果,不是 Meta 官方数据。官方来源:Instagram Platform:可读取的专业账号事实字段来源核查:

Instagram 返回字段与含义(8)
is_private
是否私密账号。
is_business
是否为商家账号。
is_professional
是否为专业账号(商家或创作者)。
external_url
主页外链。
avatar_hd_url
高清头像链接(avatar_url 是小图)。
external_urls
简介里的全部外链:url、title(external_url 只是第一个)。
has_reels
是否发过 Reels。
highlight_count
精选快拍(Highlights)个数。

怎么调用 Instagram 用户内容 API?

user_posts

使用 platform="instagram"、action="user_posts" 调用“用户内容”能力;返回列表,默认 30 条、单次最多 200 条,主要包含 post_id、url、text、media_type、like_count、comment_count 等 21 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Instagram user_posts 的参数分别是什么意思?

username必填
Instagram 账号 handle,建议不带 @ 或完整主页 URL。profile/persona/user_posts/reels 查询账号数据;followers 只查粉丝数量,followers_list/following_list 才查粉丝/关注账号列表。

Business Discovery 可返回目标专业账号的媒体内容;该来源不能证明任意 username、个人账号、完整历史记录或 EveryInfra 的结果上限,实际访问仍受账号类型和权限限制。官方来源:Instagram Platform:专业账号媒体发现范围来源核查:

Instagram 返回字段与含义(4)
post_id
帖子 ID。
media_type
媒体类型(图/视频/轮播)。
top_comments
帖子下展示的几条评论,每项含正文(text)和评论人(author_username);没有时不出现这个字段。
is_comments_disabled
帖子是否关闭评论。

怎么调用 Instagram 内容发现 API?

discover

使用 platform="instagram"、action="discover" 调用“内容发现”能力;返回列表,默认 30 条、单次最多 200 条,主要包含 post_id、url、text、media_type、like_count、comment_count 等 21 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Instagram discover 的参数分别是什么意思?

keyword必填
discover 的话题标签词,会去掉开头 # 后查询 hashtag;不是任意全文关键词搜索。与 hashtag action 的输入名不同。

Meta 官方支持以查询文本查找 hashtag ID,再访问相关 hashtag 媒体;本接口 keyword 因而只按话题标签理解,不是 Instagram Explore 的账号、标题或全文搜索,该来源也不支持把 results_type 值视为官方筛选枚举。官方来源:Instagram Platform:Hashtag Search 的查询对象来源核查:

results_type可选
discover/hashtag 省略此参数时返回 posts(普通帖子);显式传参只接受 reel 或 reels,均切换到短视频结果。posts 不是可显式提交的枚举值,其他显式值也会在公开 API 参数校验阶段返回 422;该参数不是 JSON/CSV 输出格式选择。
查看全部 2 个允许值

reelreels

Instagram 返回字段与含义(4)
post_id
帖子 ID。
media_type
媒体类型(图/视频/轮播)。
top_comments
帖子下展示的几条评论,每项含正文(text)和评论人(author_username);没有时不出现这个字段。
is_comments_disabled
帖子是否关闭评论。

怎么调用 Instagram 评论 API?

comments

使用 platform="instagram"、action="comments" 调用“评论”能力;返回列表,默认 50 条、单次最多 100 条,主要包含 id、text、url、like_count、reply_count、author_username 等 11 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Instagram comments 的参数分别是什么意思?

url必填
comments 的单个 Instagram 帖子或 Reel 链接;不是账号主页。

Meta 的媒体资源存在评论列表边,可按符合权限条件的媒体 ID 读取评论;EveryInfra 从帖子或 Reel URL 解析媒体对象属于自身实现,不能由该来源推断任意公开 URL、完整回复树或全部评论均可获得。官方来源:Instagram Platform:媒体评论列表来源核查:

Instagram 返回字段与含义(1)
post_url
帖子链接。

怎么调用 Instagram Reels 短视频 API?

reels

使用 platform="instagram"、action="reels" 调用“Reels 短视频”能力;返回列表,默认 30 条、单次最多 100 条,主要包含 post_id、url、text、media_type、like_count、comment_count 等 22 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Instagram reels 的参数分别是什么意思?

username必填
Instagram 账号 handle,建议不带 @ 或完整主页 URL。profile/persona/user_posts/reels 查询账号数据;followers 只查粉丝数量,followers_list/following_list 才查粉丝/关注账号列表。

Meta 的用户媒体模型区分 REELS、VIDEO 等媒体类型,并允许符合权限条件的账号读取用户媒体;不能据此证明任意 username 的全部 Reels 均可列出,也不能把授权账号媒体接口外推为所有公开账号访问权。官方来源:Instagram Platform:用户媒体与 Reels 类型来源核查:

Instagram 返回字段与含义(5)
post_id
帖子 ID。
media_type
媒体类型(图/视频/轮播)。
play_count
播放量。
duration_sec
时长,秒。
music
Reels 使用的音乐,含歌手(artist)和曲名(title);没有时不出现这个字段。

怎么调用 Instagram 话题内容 API?

hashtag

使用 platform="instagram"、action="hashtag" 调用“话题内容”能力;返回列表,默认 30 条、单次最多 100 条,主要包含 post_id、url、text、media_type、like_count、comment_count 等 22 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Instagram hashtag 的参数分别是什么意思?

hashtag必填
Instagram 话题标签,不带 #,例如 coffee;用于列该标签下的 posts/reels,不是账号 handle。

Meta 官方支持搜索 hashtag,并访问相应标签的近期或热门媒体;EveryInfra 的 hashtag 与兼容字段 tag 由 EveryInfra 自己定义,该来源不证明别名完全等价、results_type 枚举、任意历史深度或结果完整性。官方来源:Instagram Platform:Hashtag Search 与相关媒体来源核查:

results_type可选
discover/hashtag 省略此参数时返回 posts(普通帖子);显式传参只接受 reel 或 reels,均切换到短视频结果。posts 不是可显式提交的枚举值,其他显式值也会在公开 API 参数校验阶段返回 422;该参数不是 JSON/CSV 输出格式选择。
查看全部 2 个允许值

reelreels

tag可选
hashtag 的兼容输入,去掉开头 #;hashtag 同时存在时优先 hashtag,公开请求仍须提供必填 hashtag。
Instagram 返回字段与含义(4)
post_id
帖子 ID。
media_type
媒体类型(图/视频/轮播)。
top_comments
帖子下展示的几条评论,每项含正文(text)和评论人(author_username);没有时不出现这个字段。
is_comments_disabled
帖子是否关闭评论。

怎么调用 Instagram 粉丝数量 API?

followers

使用 platform="instagram"、action="followers" 调用“粉丝数量”能力;返回单个对象,主要包含 id、username、url、name、avatar_url、follower_count 等 8 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Instagram followers 的参数分别是什么意思?

username必填
Instagram 账号 handle,建议不带 @ 或完整主页 URL。profile/persona/user_posts/reels 查询账号数据;followers 只查粉丝数量,followers_list/following_list 才查粉丝/关注账号列表。

Business Discovery 可按 username 返回符合条件的专业账号 followers_count;这只支撑粉丝数量字段,不证明任意账号类型、批量 usernames 的 EveryInfra 语义、长期精确性或具体粉丝名单。官方来源:Instagram Platform:专业账号 followers_count来源核查:

怎么调用 Instagram 粉丝列表 API?

followers_list

使用 platform="instagram"、action="followers_list" 调用“粉丝列表”能力;返回列表,默认 50 条、单次最多 500 条,主要包含 id、username、url、name、avatar_url、is_private 等 10 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Instagram followers_list 的参数分别是什么意思?

username必填
Instagram 账号 handle,建议不带 @ 或完整主页 URL。profile/persona/user_posts/reels 查询账号数据;followers 只查粉丝数量,followers_list/following_list 才查粉丝/关注账号列表。
Instagram 返回字段与含义(3)
is_private
是否私密账号。
of_user
所属用户。
relation
关系类型。

怎么调用 Instagram 关注列表 API?

following_list

使用 platform="instagram"、action="following_list" 调用“关注列表”能力;返回列表,默认 50 条、单次最多 500 条,主要包含 id、username、url、name、avatar_url、is_private 等 10 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Instagram following_list 的参数分别是什么意思?

username必填
Instagram 账号 handle,建议不带 @ 或完整主页 URL。profile/persona/user_posts/reels 查询账号数据;followers 只查粉丝数量,followers_list/following_list 才查粉丝/关注账号列表。
Instagram 返回字段与含义(3)
is_private
是否私密账号。
of_user
所属用户。
relation
关系类型。

怎么调用 Instagram 相似账号 API?

similar_profiles

使用 platform="instagram"、action="similar_profiles" 调用“相似账号”能力;返回列表,默认 20 条、单次最多 30 条,主要包含 rank、username、user_id、display_name、is_verified、is_private 等 15 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Instagram similar_profiles 的参数分别是什么意思?

username必填
要找相似账号的 Instagram 用户名,例如 nasa,可带 @;一次一个账号。
Instagram 返回字段与含义(4)
is_private
是否私密账号。
external_url
主页外链。
rank
名次,从 1 开始:user_search 是 Instagram 给这个关键词排的账号位置;similar_profiles 是相似账号的名次,按粉丝数从多到少。
similar_to
查的那个账号的用户名(similar_profiles),每行相同。

怎么调用 Instagram 被标记的帖子 API?

tagged_posts

使用 platform="instagram"、action="tagged_posts" 调用“被标记的帖子”能力;返回列表,默认 20 条、单次最多 200 条,主要包含 post_id、url、tagged_username、author_username、author_id、text 等 12 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Instagram tagged_posts 的参数分别是什么意思?

username必填
被标记的 Instagram 账号:用户名(如 nasa,可带 @)、主页链接或数字用户 ID 都可以;一次一个账号。
Instagram 返回字段与含义(2)
post_id
帖子 ID。
tagged_username
帖子里被标记的账号,即查询的那个账号(tagged_posts),每行相同;发帖人是 author_username。

怎么调用 Instagram Stories 内容 API?

stories

使用 platform="instagram"、action="stories" 调用“Stories 内容”能力;返回列表,默认 100 条、单次最多 100 条,主要包含 id、url、media_url、media_type、duration_seconds、duration_sec 等 12 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Instagram stories 的参数分别是什么意思?

username必填
要看快拍的 Instagram 账号用户名,如 nasa(可带 @,也收主页链接)。只返回现在还在线的快拍(发出 24 小时内),账号此刻没有快拍时返回空。

Meta 的 IG User Stories 边列出一个账号的快拍媒体,并说明快拍只保留 24 小时、不含直播快拍。可证明快拍按账号读取、24 小时后消失;官方接口需授权,不证明任意公开账号都能读到。官方来源:Instagram Platform:用户快拍(Stories)来源核查:

Instagram 返回字段与含义(4)
media_type
媒体类型(图/视频/轮播)。
duration_sec
时长,秒。
media_url
快拍的图片或视频直链(stories)。链接带签名,几小时后失效,要尽快下载。
author_is_verified
作者账号是否认证(stories、comment_replies)。

怎么调用 Instagram 精选合集 API?

highlights

使用 platform="instagram"、action="highlights" 调用“精选合集”能力;返回列表,默认 100 条、单次最多 100 条,主要包含 id、url、title、media_count、cover_url、created_at 等 12 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Instagram highlights 的参数分别是什么意思?

username必填
要看精选的 Instagram 账号用户名,如 nasa(可带 @,也收主页链接)。返回主页上的精选合集列表,不含合集里的每条快拍。

Instagram 帮助中心说明快拍可以加入主页上的精选(Highlights)长期展示。这里只核对精选合集挂在账号主页下、由账号定位;不证明合集条数、创建时间等字段一定有。官方来源:Instagram 帮助中心:把快拍加入精选来源核查:

Instagram 返回字段与含义(4)
cover_url
精选封面图(highlights)。
media_count
这个精选合集里的快拍条数(highlights)。
is_pinned
是否被置顶在主页精选栏最前(highlights)。
updated_at
精选最近一次加入快拍的时间(highlights;ISO 8601,UTC)。

怎么调用 Instagram 评论回复 API?

comment_replies

使用 platform="instagram"、action="comment_replies" 调用“评论回复”能力;返回列表,每次一页、固定 10 条,更多用 next_page_token 翻页,主要包含 id、text、like_count、posted_at、author_username、author_id 等 13 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Instagram comment_replies 的参数分别是什么意思?

url必填
评论所在的帖子或 Reel 链接(https://www.instagram.com/p/<shortcode>/ 或 /reel/<shortcode>/)。
comment_id必填
要看回复的那条评论的数字 ID,取 comments 结果里的 id。

Meta 的 IG Comment Replies 边按评论 ID 读取这条评论下的回复(时间、正文、ID),并说明只能回复顶层评论。可证明回复由所属评论 ID 定位;官方接口需授权,不证明任意公开帖子都能读到。官方来源:Instagram Platform:评论的回复列表来源核查:

page_token可选
翻页令牌:把上一次响应里的 next_page_token 原样传回,拿下一页回复;不传从第一页开始。令牌 24 小时有效,每页算一次调用。
Instagram 返回字段与含义(4)
post_url
帖子链接。
author_is_verified
作者账号是否认证(stories、comment_replies)。
reply_to_id
被回复的那条评论的 ID(comment_replies),就是请求里的 comment_id。
next_page_token
翻页令牌(comment_replies):作为下一次请求的 page_token 原样传回取下一页;同一页每行的值相同,响应顶层也有同一个 next_page_token。没有该字段即到底。
Instagram post 调用流程一次 Instagram post 调用的全过程:向 POST /api/v1/social 发送 platform="instagram"、action="post",以及必填参数 urls;返回结构化 JSON,含 post_id、url、text、media_type、like_count 等字段;返回列表,单次最多 11 条,计费 $0.56 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "instagram"action: "post"urlsEveryInfra$0.56 / 千次2 · 响应 · 列表post_idurltextmedia_typelike_count
一次 Instagram post 调用的全过程:向 POST /api/v1/social 发送 platform="instagram"、action="post",以及必填参数 urls;返回结构化 JSON,含 post_id、url、text、media_type、like_count 等字段;返回列表,单次最多 11 条,计费 $0.56 / 千次,失败与空结果不计费。

Instagram 原始字段名

EveryInfra 统一字段名

左边是 Instagram 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。106 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

Instagram 的独有字段名(当前目录)

全站 106 个平台的当前目录中,这 9 个字段名只在 Instagram 出现。 这是字段命名的分布,不代表其他平台没有同类信息,也不保证每次响应都含这些字段;具体含义和返回条件仍需逐接口核对。

  • top_comments
  • is_business
  • is_professional
  • avatar_hd_url
  • external_urls
  • has_reels
  • recent_posts
  • similar_to
  • tagged_username

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/api/v1/social/fields

post_id
帖子 ID。
url
该记录在原平台上的可访问链接。
text
正文内容,已去除 HTML 标签,全文返回、不截断(个别平台的列表结果本身只有摘要,以该平台的字段说明为准)。
media_type
媒体类型(图/视频/轮播)。
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。
is_comments_disabled
帖子是否关闭评论。
author_follower_count
作者粉丝数。null 表示不公开。
hashtags
正文里的话题标签数组,按出现顺序;没有时不出现这个字段。
top_comments
帖子下展示的几条评论,每项含正文(text)和评论人(author_username);没有时不出现这个字段。
username
用户名(@handle)。
display_name
显示名,可能与 username 不同。
bio
个人简介,账号自己填写的文本。可能含换行和 emoji。
follower_count
粉丝数。null 表示不公开,不等于 0。
following_count
关注数。null 表示不公开,不等于 0。
post_count
发布内容总数。null 表示不公开,不等于 0。
is_private
是否私密账号。
is_verified
是否为平台认证账号(蓝V等)。null 表示无法判定。
is_business
是否为商家账号。
is_professional
是否为专业账号(商家或创作者)。
category
分类名称,取值为原平台的分类体系,未做跨平台归一。
external_url
主页外链。
avatar_url
头像图片链接。部分平台给的是带尺寸参数的 CDN 链接,可能有时效。
user_id
用户在原平台的唯一 ID。
avatar_hd_url
高清头像链接(avatar_url 是小图)。
external_urls
简介里的全部外链:url、title(external_url 只是第一个)。
has_reels
是否发过 Reels。
highlight_count
精选快拍(Highlights)个数。
reply_count
回复数,通常用于评论的子回复。null 表示不公开。
post_url
帖子链接。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
play_count
播放量。
duration_sec
时长,秒。
duration_seconds
时长,单位秒。非视频/音频内容为 null。
music
Reels 使用的音乐,含歌手(artist)和曲名(title);没有时不出现这个字段。
name
名称。用于账号/商品/商家类能力,指该对象本身的名字。
relation
关系类型。
of_user
所属用户。
rank
名次,从 1 开始:user_search 是 Instagram 给这个关键词排的账号位置;similar_profiles 是相似账号的名次,按粉丝数从多到少。
similar_to
查的那个账号的用户名(similar_profiles),每行相同。
tagged_username
帖子里被标记的账号,即查询的那个账号(tagged_posts),每行相同;发帖人是 author_username。
is_video
该条内容是否为视频。
media_url
快拍的图片或视频直链(stories)。链接带签名,几小时后失效,要尽快下载。
author_avatar_url
作者头像图片链接(多数平台带签名、会过期)。
author_is_verified
作者账号是否认证(stories、comment_replies)。
title
标题。平台无标题概念时(如纯文本帖)为 null。
media_count
这个精选合集里的快拍条数(highlights)。
cover_url
精选封面图(highlights)。
created_at
创建时间,格式同 posted_at。
updated_at
精选最近一次加入快拍的时间(highlights;ISO 8601,UTC)。
is_pinned
是否被置顶在主页精选栏最前(highlights)。
author_url
作者在原平台的主页链接。
reply_to_id
被回复的那条评论的 ID(comment_replies),就是请求里的 comment_id。
next_page_token
翻页令牌(comment_replies):作为下一次请求的 page_token 原样传回取下一页;同一页每行的值相同,响应顶层也有同一个 next_page_token。没有该字段即到底。

当前目录另列出 video_url · width · height · recent_posts,这些字段尚无逐项释义;请先核对 Instagram 对应接口的用例与实际响应,不按字段名猜测类型或含义。

请求填写示例

urls 必须是帖子链接数组;替换短码为真实公开帖子,多目标费用不能按一条估算。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

instagram_post.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"instagram","action":"post","params":{"urls":["https://www.instagram.com/p/<POST_SHORTCODE>/"]}}'

记录字段预览(非真实响应)

仅展示 post 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "post_id": null,
  "url": null,
  "text": null,
  "media_type": null,
  "like_count": null,
  "comment_count": null,
  "view_count": null,
  "author_username": null,
  "author_name": null,
  "posted_at": null,
  "location": null,
  "id": null,
  "image_url": null,
  "video_url": null,
  "author_id": null,
  "width": null,
  "height": null,
  "is_comments_disabled": null,
  "author_follower_count": null,
  "hashtags": null,
  "top_comments": null
}

Instagram 教程与实战

先在本页核对 action、参数和字段,再按你的任务看下面的完整步骤或相关做法。文章里的示例和边界说明只作参考,以本页的参数和字段为准。

Blog

创作者数据怎么做成投放前尽调:别用粉丝数代替受众证据

创作者数据产品不应输出说不清来由的真假分。本文讨论公开指标、授权分析、内容与品牌匹配、广告披露要求、小额测试和投后反馈如何组成有据可查的达人尽调。

阅读完整文章
指南

多平台口碑监控蓝图:先记录采集范围,再判断负面变化

做多平台口碑监控:从目标清单、评论身份和增量游标开始,设计可追溯的采集流程;用离线样本演示去重和采集缺口怎么发现,关键判断一律保留人工复核。

阅读完整文章
指南

统一数据 API 入门:从能力目录到第一条可用结果

用 platform、action、params 接入多平台数据:读懂能力目录,完成最小请求,处理异步任务、部分结果与计费,并建立可追溯的数据记录。

阅读完整文章

Instagram API 常见问题

Instagram API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="instagram"、action 和 params。以 post 为例,必填 urls,没有可选参数。urls 必须是帖子链接数组;替换短码为真实公开帖子,多目标费用不能按一条估算。 Instagram 共 18 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 106 个平台。

Instagram API 怎么收费?

每千次 $0.56 起,按能力不同(清单里逐条标了)。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 113 次 Instagram 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

Instagram API 一次能返回多少条数据?

Instagram 有 15 个列表接口,包括 post、user_posts、discover、comments、reels、hashtag、followers_list、following_list、user_search、reels_search、similar_profiles、tagged_posts、stories、highlights、comment_replies。其余 3 个接口返回单个对象;对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

Instagram API 返回哪些字段?

当前目录为 post 列出 post_id、url、text、media_type、like_count、comment_count 等 21 个字段名。按全站当前目录统计,9 个字段名只在 Instagram 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

Instagram API 的异步能力怎么用?

user_posts、discover、user_search、similar_profiles 是异步能力:提交后立即返回 job_id,用 GET /api/v1/jobs/{job_id} 轮询取结果。只在提交时计费一次,轮询免费。

Instagram 快拍 API 如何读一个账号正在显示的快拍?

用 stories 读一个账号此刻在线的快拍,带媒体链接、类型和发布时间。 username 填账号用户名,如 nasa(可带 @,也收主页链接)。快拍发出 24 小时内才在线,账号此刻没有快拍时返回空列表。 media_url 是图片或视频链接,media_type 是 image 或 video,duration_seconds 是视频时长,posted_at 是发布时间。

Instagram 精选快拍 API 如何列出主页上的精选合集?

用 highlights 列出账号主页上的精选快拍合集,带标题、封面和条数。 username 填账号用户名,如 nasa(可带 @,也收主页链接)。只返回合集列表,不含合集里的每条快拍。 media_count 是合集里的快拍数,created_at、updated_at 是创建和最近更新时间;这三项有时缺。没有精选的账号返回空列表。

Instagram 评论回复 API 如何读一条评论下的回复?

用 comment_replies 读帖子里某条评论下的回复,带点赞数、时间和回复人。 url 填评论所在的帖子或 Reel 链接,comment_id 填 comments 结果里那条评论的 id。 每页最多 10 条、条数不固定,翻页把 next_page_token 作为 page_token 传回,url 和 comment_id 不变。reply_to_id 是被回复的评论 ID。

「核对 Instagram 账号类型和公开资料」怎样接入 Instagram API?

用 profile 查询账号,区分专业账号、企业账号与认证标记。 username 填不带 @ 的 handle,不填完整主页 URL 或显示姓名。display_name、bio 和 category 分别是名称、简介和账号类别;is_business、is_professional、is_verified 含义不同,不能互相替代作为商业资质证明。 follower_count / following_count / post_count 分别是粉丝、关注和发帖数量,不是列表本身。is_private 不提供访问私密内容的权限;近期帖子是可选数据,当前目录存在嵌套字段缺失,不保证获取完整的账号信息。

可以先免费试用 Instagram API 吗?

可以。注册免费,在 GitHub 给 everyinfra/everyinfra-agent-plugins 和 everyinfra/seo-skills 两个仓库都点星,就能在控制台「余额与充值」领取 $1 额度(≈720 次数据调用),直接进赠送余额,不用输码,24 小⁠时内有效。请先选择 Instagram 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 18 个能力。无需信用卡。

开始调用 Instagram API

在 GitHub 给两个仓库点星领 $1 额度,注册后在控制台领取,24 小⁠时内有效,先选一个 Instagram 接口验证结果。

免费开始

自有访问统计常开;Google Analytics 仅在你点「同意分析」后启用。 隐私政策