Instagram

Instagram API

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

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

  • 18 个能力
  • 每千次 $0.56 起
  • 失败和空结果都不收费
  • 24h 健康值 67%

平台运行状态

24h 健康值
67%
少量可用

30 天趋势

Instagram 能力清单

能力做什么单价24 小时运行状态
单条内容post把选定的帖子或 Reel 链接放入 urls,读取对应内容。$0.56 / 千次正常
主页或对象详情profile用 profile 查询账号,区分专业账号、企业账号与认证标记。$0.56 / 千次健康 · 健康值 100%
账号画像persona用 persona 在账号资料之外尝试生成摘要,不能把模型判断当作平台认证事实。$0.56 / 千次正常
用户内容user_posts按 Instagram handle 提交 user_posts 任务,完成后再整理帖子。$0.56 / 千次正常
内容发现discover用 discover 查询 hashtag 相关内容,而不是任意全文搜索。$0.56 / 千次正常
评论comments用 comments 处理一个作品的评论,不沿用 post 的多链接输入形状。$0.56 / 千次基本不可用 · 健康值 1%
Reels 短视频reels按账号 handle 读取 Reels,对照短视频时长、播放数和配乐。$1.19 / 千次暂不可用
话题内容hashtag按 hashtag 获取话题下的内容,比较文案与媒体类型。$0.56 / 千次正常
粉丝数量followers用 followers 取得轻量账号计数,名单需使用 followers_list。$0.56 / 千次正常
粉丝列表followers_list需要账号条目时使用 followers_list,不把数量接口当作名单。$0.56 / 千次正常
关注列表following_list用 following_list 看关注方向,不与 followers_list 的粉丝方向互换。$0.56 / 千次正常
账号搜索user_search用 user_search 按关键词搜 Instagram 账号,按搜索名次拿到每个账号的粉丝数、关注数和简介。$4.81 / 千次正常
Reels 关键词搜索reels_search用 reels_search 按关键词搜 Reels,按播放、点赞、评论数比较热度。$7.19 / 千次正常
相似账号similar_profiles用 similar_profiles 按一个账号拿到 Instagram 推荐的相似账号,按粉丝数从多到少排。$8.81 / 千次正常
被标记的帖子tagged_posts用 tagged_posts 列出别人发的、标记了某个账号的公开帖子。$7.44 / 千次正常
Stories 内容stories用 stories 读一个账号此刻在线的快拍,带媒体链接、类型和发布时间。$1.5 / 千次暂不可用
精选合集highlights用 highlights 列出账号主页上的精选快拍合集,带标题、封面和条数。$1.6 / 千次暂不可用
评论回复comment_replies用 comment_replies 读帖子里某条评论下的回复,带点赞数、时间和回复人。$0.88 / 千次暂不可用

Instagram 每个接口分别做什么

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

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

能力必填参数可选参数单次条数模式单价返回字段
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.56 / 千次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

怎么调用 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 快拍 API 如何读一个账号正在显示的快拍?

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

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

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

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

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

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

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

查看 comment_replies 的 comment_id 参数
  • url 填评论所在的帖子或 Reel 链接,comment_id 填 comments 结果里那条评论的 id。
  • 每页最多 10 条、条数不固定,翻页把 next_page_token 作为 page_token 传回,url 和 comment_id 不变。reply_to_id 是被回复的评论 ID。

核对 Instagram 账号类型和公开资料

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

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

使用 Instagram persona 时区分原始资料与 AI 推断

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

查看 persona 的 username 参数
  • username 与 profile 使用同一账号 handle。账号名称、简介、类别和有限近期帖子作为分析输入;persona 是外层附加结果,不是这些原始字段的新名称,也不是粉丝个人资料或完整发帖分析。
  • AI 摘要可能为空,资料成功不等于摘要生成成功;行业、细分领域或真实性分析属于推断,需要人工核对,不能当作欺诈鉴定、身份验证或个人资格判断。当前目录仅列基础资料字段,没有可调的分析模型或 prompt 参数。

按 Instagram 话题标签异步发现帖子

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

查看 discover 的 results_type 参数
  • keyword 会去掉开头 #,例如 coffee 表示话题标签。results_type 不传时查 posts;reels / reel 表示短视频,其他字符串目前回落 posts。results_type 的值域尚未完整列出,默认是 posts,不能把它当作每个输入都会严格拒绝的枚举。
  • discover 是异步任务,需要按任务状态获取结果;返回 post_id / url 后核实作品,media_type 区分媒体类型。它不是 Instagram Explore 的个性化推荐流,也不保证某标签下全部历史内容、完整评论或固定排序。

Instagram 评论 API 如何读取帖子或 Reel 的评论内容?

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

查看 comments 的 url 参数
  • url 使用单个 /p/ 或 /reel/ 链接,不填账号主页;当前目录没有排序、评论日期或批量目标参数。返回的 post_url 与评论 url 在存在时分别保留,缺少某一地址不应拼造永久链接。
  • reply_count 只是回复数量;当前结果没有父评论 ID 或嵌套回复树,不能保证全部楼中楼。可取得的评论数可能少于目标上限,author_username 与显示名分开记录,is_verified 不是评论内容的真实性认证。

只查 Instagram 粉丝数量,不下载粉丝名单

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

查看 followers 的 username 参数
  • username 是正式必填的账号 handle;这里推荐一次查询一个账号。目录另列 usernames 数组,但当前按目标数量计费而结果只保留首个账号,没有逐目标 partial/missed;返回兼容性修复前不要用它批量查数。
  • follower_count 是粉丝数量,following_count 是账号关注数量;这些值不是独立活跃用户,也不是本次新增粉丝。id / username / url 用于核对实际账号,当前没有按日期回看历史数量或粉丝人群特征的参数。

读取 Instagram 账号所关注的账号列表

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

查看 following_list 的 username 参数
  • username 指列表所属账号;返回行的 id / username / name 是被关注对象,of_user 在存在时保留查询归属。relation 保留实际返回的关系标记,不用于证明双方互相关注。
  • 每次至少请求 50 条候选关注关系,较小 limit 不意味着只读取同样少的候选;实际公开返回仍受请求上限与可取得内容约束,不保证全量。is_private / is_verified 只是账号标记,不授予私密访问权限;本接口没有关注操作、关注时间或互动强度。

核对一组 Instagram 帖子

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

查看 post 的 urls 参数
  • post 使用链接数组,结合 post_id、text 与 media_type 核对每个目标;按目标链接数计费。
  • comments 使用单个 url,不能直接照搬这份数组;post 也不是按地点或话题搜索的入口。

账号发帖的异步归档

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

查看 user_posts 的 username 参数
  • username 填账号短名,结合 post_id、posted_at 与 text 建立自己的内容记录。
  • 这是异步接口:提交任务不等于已取回结果;定时抓取、历史保存和完整性检查需自行实现。

Reels 时长与播放观察

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

查看 reels 的 username 参数
  • duration_sec 以秒计,play_count 是播放数量,music 是配乐,可用来比较不同时长和配乐的视频表现。
  • 播放数不等于独立观众;这项能力不返回字幕文本和热门评论,计数为 null 表示没有公开,不等于 0。

Instagram 话题标签内容调研

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

查看 hashtag 的 hashtag 参数
  • hashtag 填不带 # 的标签,例如 coffee;结合 text、media_type 与 posted_at 整理结果。
  • 这是标签入口,不是任意全文搜索;不要把 TikTok 的话题结果或筛选参数直接套过来。

粉丝名单与粉丝数量分开取

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

查看 followers_list 的 username 参数
  • username 指定目标账号,再按返回的 id、username、name 核对粉丝资料。
  • followers 只取数量,following_list 取关注名单;任何列表都不承诺完整关系网或私有内容访问。

Instagram 账号搜索 API 如何按关键词找账号并带粉丝数?

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

查看 user_search 的 keyword 参数
  • keyword 填一个词(如 coffee),搜的是账号,不是帖子正文;rank 是 Instagram 搜索给这个词排的位置,从 1 开始。limit 1–30,默认 20,返回的每个账号都带 follower_count、following_count;这一项是异步调用,提交后按任务结果取。
  • post_count 只在帖子数可信时给出,取不到时不出现,不等于 0。认证、私密标记只是公开信号,不代表身份核实或合作意愿。

Instagram Reels 搜索 API 如何按关键词找爆款短视频?

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

查看 reels_search 的 keyword 参数
  • keyword 填一个词(如 coffee),开头的 # 或 @ 会去掉;limit 1–200,默认 20。每行一条 Reel:play_count 播放数、like_count、comment_count、duration_sec 时长秒数、author_username 和 is_verified(作者认证)。
  • 顺序跟 Instagram 搜索走,是一份样本,不是这个词下的全部 Reels;作者粉丝数不在这里,要用 profile 另查。

Instagram 相似账号 API 如何找一个账号的同类账号?

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

查看 similar_profiles 的 username 参数
  • username 填一个账号(如 nasa,可带 @);limit 1–30,默认 20,每个都带粉丝数,rank 按 follower_count 从多到少;similar_to 是查的那个账号。这一项是异步调用。
  • 被推荐为相似不代表有商业关系或受众重合,找竞品、找达人时要再按内容核对。

Instagram 被标记帖子 API 如何看谁在帖子里标记了一个品牌账号?

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

查看 tagged_posts 的 username 参数
  • username 填被标记的账号:用户名(如 nasa)、主页链接或数字用户 ID 都可以;limit 1–200,默认 20。每行一条帖子:author_username 是发帖人,tagged_username 是查的那个账号,另有 text、like_count、comment_count、is_video、posted_at、image_url。
  • 私密账号的帖子不在其中;被标记不等于合作或授权使用,引用前要核对版权。

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 仅在你点「同意分析」后启用。 隐私政策