API 接口与密钥

通过 hiCreator API，将达人发现、数据查询和分析报告接入你的应用。

获取 API Key

身份验证

使用 API Key 调用接口，在请求中添加以下 HTTP 请求头。

Authorization: Bearer <YOUR_KEY>

API 接入需要付费 Workspace；接口按实际使用计费。

POST/api/openapi/v1/creators/recent-posts

达人最近帖子

接口价格0.1 积分 / 次成功查询

空列表仍计费；失败退款。重复请求单独计费。

支持平台Instagram / YouTube / TikTok / Twitter / X

快速调用示例 (cURL)

curl -X POST 'https://app.hicreator.ai/api/openapi/v1/creators/recent-posts' \
  -H 'Authorization: Bearer <YOUR_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
  "profile_url": "https://www.instagram.com/example_creator/"
}'

请求参数

参数名类型必填说明
profile_urlstring是达人主页链接。
支持平台

响应字段

含图片、视频和轮播，可能包含置顶或共创帖子。 仅返回近期帖子；缺失字段省略。

参数名类型始终返回说明
requestIdstring是请求 ID，用于排查问题。
billingRequestIdstring是计费记录 ID。
dataobject是查询结果。
data.platform'instagram'是所属平台。
data.canonicalUrlstring (URL)是主页或内容链接。
data.retrievedAtstring (ISO 8601)是获取时间。
data.itemsobject[]是近期帖子列表，可能为空。
data.items[].idstring是平台内帖子 ID。
data.items[].urlstring (URL)是原平台帖子链接。
data.items[].textstring否帖子正文或描述。
data.items[].contentTypestring否内容类型。
查看可选值

photo / carousel / video / reel

data.items[].durationSecondsnumber否视频时长（秒）；多视频帖省略。
data.items[].thumbnailUrlstring (URL)否封面链接。
data.items[].publishedAtstring否发布日期或时间（YYYY-MM-DD / ISO 8601）。
data.items[].metricsobject是互动数据。
data.items[].metrics.viewCountinteger否播放或观看次数。
data.items[].metrics.likeCountinteger否点赞数。
data.items[].metrics.commentCountinteger否评论数。
data.items[].metrics.shareCountinteger否分享次数。
data.items[].metrics.saveCountinteger否收藏次数。
data.items[].metrics.repostCountinteger否转帖或转发数。
data.items[].platformDetailsobject否平台专属资料。
data.items[].platformDetails.pinnedboolean否是否置顶。
data.items[].platformDetails.paidPartnershipboolean否是否标记为付费合作。

响应示例 (JSON)

{
  "requestId": "<request-id>",
  "billingRequestId": "<billing-request-id>",
  "data": {
    "platform": "instagram",
    "canonicalUrl": "https://www.instagram.com/example_creator/",
    "retrievedAt": "2026-11-09T00:00:00.000Z",
    "items": [
      {
        "id": "123456789",
        "url": "https://www.instagram.com/p/EXAMPLE123/",
        "contentType": "reel",
        "durationSeconds": 30,
        "text": "达人最近发布的一条动态。",
        "publishedAt": "2026-11-08T00:00:00.000Z",
        "thumbnailUrl": "https://assets.example.com/cover.jpg",
        "metrics": {
          "viewCount": 1200,
          "likeCount": 100,
          "commentCount": 5,
          "repostCount": 8
        },
        "platformDetails": {
          "pinned": false,
          "paidPartnership": false
        }
      }
    ]
  }
}

错误与重试

查看 error.message；排查时提供 requestId。结果不确定时请勿自动重试。

查看错误码

请求：400 参数无效（10001）或数量低于最低值（70004）；401 Key 无效（20001）；403 API 仅向付费 Workspace 开放（60006）；413 请求过大（10005）；415 格式不支持（10006）；429 请求过于频繁（10007）。

执行：404 Twitter 账号不存在或无法公开访问（60008）；422 搜索意图无效（60001）或目标账号无效（60002）；422 邮箱查找未完成（60009）：达到查找上限，全额退款，不代表无邮箱，请勿自动重试；502 邮箱查询失败（60003）或执行失败（60004）；504 请求超时（60005）。网关错误页转换为 API_UPSTREAM_ERROR JSON；不要自动重试付费请求。

积分：402 余额不足（70001）或超过每日限额（70006）；409 当前功能不可用（70002）或积分记录冲突（70003）。API 错误包含 error.code、error.message 和 error.requestId；业务错误在扣费开始后包含 error.billingRequestId，网关兜底可能缺少此字段，也不能据此确认退款状态。

API 接口与密钥 | hiCreator