InfluencerPact API

快速开始

在右侧创建密钥，然后用它调用任何端点。所有回应都是 JSON。

curl https://api.influencerpact.com/v1/creators/lookup?platform=youtube\&handle=mkbhd \
  -H "Authorization: Bearer ip_live_…"

验证

在 Authorization 标头以 Bearer token 发送密钥，或使用 X-API-Key。密钥绑定你的账号与方案；我们只保存哈希值，所以请在创建时拷贝密钥。

Authorization: Bearer ip_live_…
# or
X-API-Key: ip_live_…

速率限制

限制以每把密钥计算。每个回应都附有 X-RateLimit-Limit 与 X-RateLimit-Remaining（以 UTC 日计）；429 回应会附 Retry-After。

方案限制同样适用：每次新搜索使用一次搜索额度（找不到结果会退还），查找共用你的每小时查找额度，活动依你的活动上限。

端点

• GET/v1/me

  你的方案以及这把密钥适用的限制。

• POST/v1/search

  用和“发现达人”相同的筛选条件搜索达人数据库，回传粉丝数、平均观看、互动率、国家、语言，以及是否有 Email。

  curl -X POST https://api.influencerpact.com/v1/search \
    -H "Authorization: Bearer $LUMI_KEY" -H "Content-Type: application/json" \
    -d '{ "platform": "youtube", "keyword": "skincare", "country": "US", "minFollowers": 10000, "page": 1 }'

• GET/v1/creators/lookup?platform=youtube&handle=mkbhd

  用账号或个人页网址查找一位达人（改传 url= 取代 handle=）。

• POST/v1/creators/bulk

  每次最多依方案的批量上限查找账号或个人页网址。每一列不是达人数据，就是找不到的原因。

  curl -X POST https://api.influencerpact.com/v1/creators/bulk \
    -H "Authorization: Bearer $LUMI_KEY" -H "Content-Type: application/json" \
    -d '{ "platform": "tiktok", "items": ["@khaby.lame", "https://www.tiktok.com/@zachking"] }'

• GET/v1/creators/authenticity?platform=youtube&handle=mkbhd

  依达人近期帖子计算的互动真实度指针，附样本数与方法。受众人口统计会标示为无法获取。

• POST/v1/reverse/emails

  公开简介列出这些 Email，或在你联系人中的达人。

  curl -X POST https://api.influencerpact.com/v1/reverse/emails \
    -H "Authorization: Bearer $LUMI_KEY" -H "Content-Type: application/json" \
    -d '{ "emails": ["hello@creator.com"] }'

• GET/v1/campaigns

  你的活动与加总数据（观看、花费、CPM、CPE、ROI）。

• POST/v1/campaigns

  创建活动，可同时附上帖子链接。

  curl -X POST https://api.influencerpact.com/v1/campaigns \
    -H "Authorization: Bearer $LUMI_KEY" -H "Content-Type: application/json" \
    -d '{ "name": "Spring launch", "currency": "USD", "links": "https://youtu.be/dQw4w9WgXcQ" }'

• GET/v1/campaigns/{id}

  一个活动及所有追踪中帖子的最新数据。

• POST/v1/campaigns/{id}/posts

  为活动添加帖子链接（可附每篇成本）。

  curl -X POST https://api.influencerpact.com/v1/campaigns/{id}/posts \
    -H "Authorization: Bearer $LUMI_KEY" -H "Content-Type: application/json" \
    -d '{ "text": "https://www.tiktok.com/@user/video/7300000000000000000", "cost": 250 }'

• GET/v1/campaigns/{id}/history

  观看、点赞、评论与分享的每小时时间串行。

Email 反查每次请求最多 20 个 Email。

回应与错误

成功的回应 code 为 0，数据放在 data。错误会带固定的字符串 code 和可读的 message。

{ "code": 0, "message": "ok", "data": { … } }
{ "code": "API_RATE_MINUTE", "message": "Rate limit: 10 requests per minute", "data": null }

指针为 null 代表来源没有公开，我们绝不以估算值填补。