| action | 必填参数 | 可选参数 | 单次条数 | 模式 | 单价 | 返回字段 |
|---|---|---|---|---|---|---|
| post | urls | — | 默认 11 · 最多 11 | 同步 | $0.56 / 千次 | post_id · url · text · media_type · like_count · comment_count · view_count · author_username · author_name · posted_at · location · author_follower_count · hashtags · top_comments |
| profile | username | — | — | 同步 | $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 · recent_posts |
| persona | username | — | — | 同步 | $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 · recent_posts |
| user_posts | username | — | 默认 30 · 最多 200 | 异步 | $0.56 / 千次 | post_id · url · text · media_type · like_count · comment_count · view_count · author_username · author_name · posted_at · location · author_follower_count · hashtags · top_comments |
| discover | keyword | results_type | 默认 30 · 最多 200 | 异步 | $0.56 / 千次 | post_id · url · text · media_type · like_count · comment_count · view_count · author_username · author_name · posted_at · location · author_follower_count · hashtags · top_comments |
| comments | url | — | 默认 50 · 最多 100 | 同步 | $0.56 / 千次 | id · text · url · like_count · reply_count · author_username · author_name · is_verified · posted_at · post_url · platform |
| reels | username | — | 默认 30 · 最多 100 | 同步 | $0.56 / 千次 | post_id · url · text · media_type · like_count · comment_count · view_count · author_username · author_name · posted_at · location · author_follower_count · hashtags · top_comments · play_count · duration_sec · transcript · music · platform |
| hashtag | hashtag | results_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 · author_follower_count · hashtags · top_comments · platform |
| followers | username | — | — | 同步 | $0.56 / 千次 | id · username · url · name · avatar_url · follower_count · following_count · platform |
| followers_list | username | — | 默认 50 · 最多 500 | 同步 | $0.56 / 千次 | id · username · url · name · avatar_url · is_private · is_verified · relation · of_user · platform |
| following_list | username | — | 默认 50 · 最多 500 | 同步 | $0.56 / 千次 | id · username · url · name · avatar_url · is_private · is_verified · relation · of_user · platform |
下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 切换 action 时，也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。
下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。
post使用 platform="instagram"、action="post" 调用“单条内容”能力；返回列表，默认 11 条、单次最多 11 条，主要包含 post_id、url、text、media_type、like_count、comment_count 等 14 个字段。
urls必填Instagram 说明私密账号内容不可嵌入，公开账号也可以关闭嵌入。可分享或可嵌入不等于获得额外的数据访问权限；本接口的输入和可用范围仍按上方说明。官方来源：Instagram：公开帖子与嵌入边界来源核查：
profile使用 platform="instagram"、action="profile" 调用“主页或对象详情”能力；返回单个对象，主要包含 username、display_name、bio、follower_count、following_count、post_count 等 14 个字段。
username必填Meta 的 Business Discovery 可按 username 读取符合条件的专业账号资料、粉丝数和媒体数；该能力受账号类型、授权和权限限制，不能证明任意个人账号均可访问，也不为 EveryInfra 的全部 profile 字段和覆盖范围背书。官方来源：Instagram Platform：专业账号资料与 Business Discovery来源核查：
persona使用 platform="instagram"、action="persona" 调用“账号画像”能力；返回单个对象，主要包含 username、display_name、bio、follower_count、following_count、post_count 等 14 个字段。
username必填Meta 的 IG User 资源定义了用户名、账号资料、粉丝数、媒体数和媒体等事实字段，这些字段可以作为后续分析输入；官方没有定义 persona 推断，兴趣、受众画像和风格标签均是 EveryInfra 的衍生结果，不是 Meta 官方数据。官方来源：Instagram Platform：可读取的专业账号事实字段来源核查：
user_posts使用 platform="instagram"、action="user_posts" 调用“用户内容”能力；返回列表，默认 30 条、单次最多 200 条，主要包含 post_id、url、text、media_type、like_count、comment_count 等 14 个字段。
username必填Business Discovery 可返回目标专业账号的媒体内容；该来源不能证明任意 username、个人账号、完整历史记录或 EveryInfra 的结果上限，实际访问仍受账号类型和权限限制。官方来源：Instagram Platform：专业账号媒体发现范围来源核查：
discover使用 platform="instagram"、action="discover" 调用“内容发现”能力；返回列表，默认 30 条、单次最多 200 条，主要包含 post_id、url、text、media_type、like_count、comment_count 等 14 个字段。
keyword必填Meta 官方支持以查询文本查找 hashtag ID，再访问相关 hashtag 媒体；本接口 keyword 因而只按话题标签理解，不是 Instagram Explore 的账号、标题或全文搜索，该来源也不支持把 results_type 值视为官方筛选枚举。官方来源：Instagram Platform：Hashtag Search 的查询对象来源核查：
results_type可选reelreels
comments使用 platform="instagram"、action="comments" 调用“评论”能力；返回列表，默认 50 条、单次最多 100 条，主要包含 id、text、url、like_count、reply_count、author_username 等 11 个字段。
url必填Meta 的媒体资源存在评论列表边，可按符合权限条件的媒体 ID 读取评论；EveryInfra 从帖子或 Reel URL 解析媒体对象属于自身实现，不能由该来源推断任意公开 URL、完整回复树或全部评论均可获得。官方来源：Instagram Platform：媒体评论列表来源核查：
reels使用 platform="instagram"、action="reels" 调用“Reels 短视频”能力；返回列表，默认 30 条、单次最多 100 条，主要包含 post_id、url、text、media_type、like_count、comment_count 等 19 个字段。
username必填Meta 的用户媒体模型区分 REELS、VIDEO 等媒体类型，并允许符合权限条件的账号读取用户媒体；不能据此证明任意 username 的全部 Reels 均可列出，也不能把授权账号媒体接口外推为所有公开账号访问权。官方来源：Instagram Platform：用户媒体与 Reels 类型来源核查：
hashtag使用 platform="instagram"、action="hashtag" 调用“话题内容”能力；返回列表，默认 30 条、单次最多 100 条，主要包含 post_id、url、text、media_type、like_count、comment_count 等 15 个字段。
hashtag必填Meta 官方支持搜索 hashtag，并访问相应标签的近期或热门媒体；EveryInfra 的 hashtag 与兼容字段 tag 属于自身输入契约，该来源不证明别名完全等价、results_type 枚举、任意历史深度或结果完整性。官方来源：Instagram Platform：Hashtag Search 与相关媒体来源核查：
results_type可选reelreels
tag可选followers使用 platform="instagram"、action="followers" 调用“粉丝数量”能力；返回单个对象，主要包含 id、username、url、name、avatar_url、follower_count 等 8 个字段。
username必填Business Discovery 可按 username 返回符合条件的专业账号 followers_count；这只支撑粉丝数量字段，不证明任意账号类型、批量 usernames 的 EveryInfra 语义、长期精确性或具体粉丝名单。官方来源：Instagram Platform：专业账号 followers_count来源核查：
followers_list使用 platform="instagram"、action="followers_list" 调用“粉丝列表”能力；返回列表，默认 50 条、单次最多 500 条，主要包含 id、username、url、name、avatar_url、is_private 等 10 个字段。
username必填following_list使用 platform="instagram"、action="following_list" 调用“关注列表”能力；返回列表，默认 50 条、单次最多 500 条，主要包含 id、username、url、name、avatar_url、is_private 等 10 个字段。
username必填Instagram 原始字段名
EveryInfra 统一字段名
左边是 Instagram 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名，减少重复适配； 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。
全站 89 个平台的当前目录中，这 6 个字段名只在 Instagram 出现。 这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。
通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版：/api/v1/social/fields
当前目录另列出 hashtags · top_comments · recent_posts · music，这些字段尚无逐项释义；请先核对 Instagram 对应接口的用例与实际响应，不按字段名猜测类型或含义。
urls 必须是帖子链接数组；替换短码为真实公开帖子，多目标费用不能按一条估算。
以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer omg_你的KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"instagram","action":"post","params":{"urls":["https://www.instagram.com/p/<POST_SHORTCODE>/"]}}'
仅展示 post 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。
{ "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, "author_follower_count": null, "hashtags": null, "top_comments": null }
以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。
用 profile 查询账号，区分专业账号、企业账号与认证标记。
查看 profile 的 username 参数 →用 persona 在账号资料之外尝试生成摘要，不能把模型判断当作平台认证事实。
查看 persona 的 username 参数 →用 discover 查询 hashtag 相关内容，而不是任意全文搜索。
查看 discover 的 results_type 参数 →用 comments 处理一个作品的评论，不沿用 post 的多链接输入形状。
查看 comments 的 url 参数 →用 followers 取得轻量账号计数，名单需使用 followers_list。
查看 followers 的 username 参数 →用 following_list 看关注方向，不与 followers_list 的粉丝方向互换。
查看 following_list 的 username 参数 →把选定的帖子或 Reel 链接放入 urls，读取对应内容。
查看 post 的 urls 参数 →按 Instagram handle 提交 user_posts 任务，完成后再整理帖子。
查看 user_posts 的 username 参数 →按账号 handle 读取 Reels，对照短视频时长、播放数和可用文稿。
查看 reels 的 username 参数 →按 hashtag 获取话题下的内容，比较文案与媒体类型。
查看 hashtag 的 hashtag 参数 →需要账号条目时使用 followers_list，不把数量接口当作名单。
查看 followers_list 的 username 参数 →调用 POST /api/v1/social，请求体传 platform="instagram"、action 和 params。以 post 为例，必填 urls，没有可选参数。urls 必须是帖子链接数组；替换短码为真实公开帖子，多目标费用不能按一条估算。 Instagram 共 11 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。
$0.56 / 千次，Instagram 全部 11 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 1,798 次 Instagram 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。
Instagram 有 8 个列表接口，包括 post、user_posts、discover、comments、reels、hashtag、followers_list、following_list。其余 3 个接口返回单个对象；对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。
当前目录为 post 列出 post_id、url、text、media_type、like_count、comment_count 等 14 个字段名。按全站当前目录统计，6 个字段名只在 Instagram 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。
user_posts、discover 是异步能力：提交后立即返回 job_id，用 GET /api/v1/jobs/{job_id} 轮询取结果。只在提交时计费一次，轮询免费。
用 profile 查询账号，区分专业账号、企业账号与认证标记。 username 填不带 @ 的 handle，不填完整主页 URL 或显示姓名。display_name、bio 和 category 分别是名称、简介和账号类别；is_business、is_professional、is_verified 含义不同，不能互相替代作为商业资质证明。 follower_count / following_count / post_count 分别是粉丝、关注和发帖数量，不是列表本身。is_private 不提供访问私密内容的权限；近期帖子是可选数据，当前目录存在嵌套字段缺失，不保证获取完整的账号信息。
用 persona 在账号资料之外尝试生成摘要，不能把模型判断当作平台认证事实。 username 与 profile 使用同一账号 handle。账号名称、简介、类别和有限近期帖子作为分析输入；persona 是外层附加结果，不是这些原始字段的新名称，也不是粉丝个人资料或完整发帖分析。 AI 摘要可能为空，资料成功不等于摘要生成成功；行业、细分领域或真实性分析属于推断，需要人工核对，不能当作欺诈鉴定、身份验证或个人资格判断。当前目录仅列基础资料字段，没有可调的分析模型或 prompt 参数。
用 discover 查询 hashtag 相关内容，而不是任意全文搜索。 keyword 会去掉开头 #，例如 coffee 表示话题标签。results_type 不传时查 posts；reels / reel 表示短视频，其他字符串目前回落 posts。results_type 的值域尚未完整列出，默认是 posts，不能把它当作每个输入都会严格拒绝的枚举。 discover 是异步任务，需要按任务状态获取结果；返回 post_id / url 后核实作品，media_type 区分媒体类型。它不是 Instagram Explore 的个性化推荐流，也不保证某标签下全部历史内容、完整评论或固定排序。
用 comments 处理一个作品的评论，不沿用 post 的多链接输入形状。 url 使用单个 /p/ 或 /reel/ 链接，不填账号主页；当前目录没有排序、评论日期或批量目标参数。返回的 post_url 与评论 url 在存在时分别保留，缺少某一地址不应拼造永久链接。 reply_count 只是回复数量；当前结果没有父评论 ID 或嵌套回复树，不能保证全部楼中楼。可取得的评论数可能少于目标上限，author_username 与显示名分开记录，is_verified 不是评论内容的真实性认证。
可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 Instagram 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 11 个能力。无需信用卡。