Instagram API

Instagram API 允许您查找用户资料、列出帖子、Reels 和标记的媒体、阅读故事、获取帖子详情、阅读评论和回复、搜索用户和话题标签，以及遍历社交图谱（关注者/关注）。共 12 个接口，每个请求消耗 2 个积分。

接口列表

身份验证

每个成功响应都包含积分跟踪字段： credits_used、credits_remaining 和 response_time（毫秒）。

标识用户

用户接口接受 任一 username 或数字型 user_id。传递 username 是最简单的选项；它会自动解析为 user_id。 对于重复调用，从个人资料响应中读取 data.user.id 并将其作为 user_id 传递，以跳过查找。

用户资料

POST https://api.scavio.dev/api/v1/instagram/profile

获取 Instagram 用户个人资料。传递 任一 username 或 user_id。

请求体

示例

curl -X POST 'https://api.scavio.dev/api/v1/instagram/profile' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"username": "instagram"}'

响应字段（data.user）

示例响应

{
  "data": {
    "user": {
      "id": "25025320",
      "username": "instagram",
      "full_name": "Instagram",
      "biography": "Discover what's next on Instagram",
      "is_verified": true,
      "is_private": false,
      "edge_followed_by": { "count": 672000000 },
      "edge_follow": { "count": 250 },
      "edge_owner_to_timeline_media": { "count": 7600 }
    }
  },
  "response_time": 845,
  "credits_used": 2,
  "credits_remaining": 11750
}

用户帖子

POST https://api.scavio.dev/api/v1/instagram/user/posts

列出用户的帖子（时间线媒体）。传递 username 或 user_id。

请求体

分页

使用 data.page_info.end_cursor 作为下一个请求的 cursor。当 data.page_info.has_next_page 为 false 时停止。

用户 Reels（/api/v1/instagram/user/reels） 和 标记的帖子（/api/v1/instagram/user/tagged）使用与用户帖子相同的参数和分页方式，分别返回 Reels 和标记的媒体。

用户故事

POST https://api.scavio.dev/api/v1/instagram/user/stories

获取用户当前活跃的故事。传递 username 或 user_id。返回每个故事的媒体 URL、类型（图片/视频）和时间戳。

帖子详情

POST https://api.scavio.dev/api/v1/instagram/post

获取单个帖子或 Reel 的完整详情。传递 其中一个 url、media_id 或 shortcode。

请求体

示例

curl -X POST 'https://api.scavio.dev/api/v1/instagram/post' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"shortcode": "DUajw4YkorV"}'

帖子评论

POST https://api.scavio.dev/api/v1/instagram/post/comments

获取帖子评论。传递 任一 shortcode 或帖子 url。

请求体

分页

使用 data.next_min_id 作为下一个 cursor。当它不存在时停止。每条评论都会暴露一个 pk 字段；将其用作回复接口的 comment_id。

评论回复

POST https://api.scavio.dev/api/v1/instagram/post/comments/replies

获取特定评论的回复。

请求体

搜索用户

POST https://api.scavio.dev/api/v1/instagram/search/users

通过关键词搜索 Instagram 用户。

请求体

搜索话题标签（/api/v1/instagram/search/hashtags）接受相同的参数，并返回匹配的话题标签及其媒体计数。

用户关注者

POST https://api.scavio.dev/api/v1/instagram/user/followers

获取用户的关注者列表。传递 username 或 user_id。

请求体

用户关注

POST https://api.scavio.dev/api/v1/instagram/user/followings

获取用户关注的账户。请求格式和参数与关注者相同。

分页参考

注意事项

• 每个接口每次请求消耗 2 个积分。
• 用户接口接受 username 或数字型 user_id；帖子接口接受 url、 media_id 或 shortcode。
• 关注者和关注列表仅对 Instagram 允许的账户进行分页。大型或经过验证的账户返回 should_limit_list_of_followers: true、 has_more: false 且没有 next_max_id —— 这是 Instagram 的限制，而非错误。请使用较小的、未验证的账户测试分页。
• 有关 401、429 和 502 的处理，请参阅 错误处理。