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 代表來源沒有公開，我們絕不以估算值填補。