开发者文档 / 达人分析

Instagram 达人近期作品

按 Instagram 用户名获取公开账号信息及近期帖子，用于达人分析与内容对标。

GET/v1/influencer/ins/fetchPosts

鉴权：: 请求头 x-api-key: <YOUR_API_KEY>；密钥仅保存在服务端。
成功判断：: 检查 HTTP 状态与对应的响应结构。

Query 参数

字段	类型	必填	说明
`uniqueId`	`string`	是	Instagram 用户名，不含开头的 @
`count`	`integer`	否	返回的近期帖子数量，默认 40

图片或图集帖子可能没有播放量，列表数据也可能缺少部分互动字段；缺失值不应直接解释为表现差。

HTTP 200 且 code=0 才表示成功；code=-1 表示未获取到公开达人作品数据。

AI 达人报告可将本接口结果整理成证据，再调用 /v1/relay/chat/completions 生成。

成功响应

{
  "code": 0,
  "message": "success",
  "data": {
    "author": {
      "id": "1234567890",
      "username": "creator",
      "fullName": "Creator",
      "biography": "Product reviews and daily finds",
      "followerCount": 45200,
      "followingCount": 318,
      "postCount": 604
    },
    "posts": [
      {
        "postId": "3456789012345678901",
        "shortCode": "ExampleCode",
        "caption": "A quick product demo #productreview",
        "takenAtTimestamp": 1787000000,
        "videoDuration": 18.4,
        "isVideo": true,
        "videoPlayCount": 128400,
        "videoViewCount": 128400,
        "likeCount": 6200,
        "commentCount": 184,
        "displayUrl": "https://cdn.example.com/instagram-cover.jpg",
        "videoUrl": "https://cdn.example.com/instagram-video.mp4"
      }
    ],
    "endCursor": "QVFEexample",
    "hasMore": true
  },
  "timestamp": 1787417005
}

响应与错误

主要响应字段来自接口规范；完整层级、联合类型和校验规则见 JSON Schema。必填指字段所在对象中的约束。

HTTP 400请求参数或请求体无效，请修正后重试。
HTTP 401API 密钥缺失或无效，请检查 x-api-key。
HTTP 403API 密钥没有此接口的调用权限。
HTTP 429请求过于频繁，请采用指数退避重试。
HTTP 500服务端发生错误；对于暂时性故障采用指数退避重试。

参数、权限或授权错误需先修正。创建发布或生成任务超时后先查询已有任务，避免重复创建；不要因轮询中断而重复提交。

最后更新 · 2026-09-29