InfluencerPact API

クイックスタート

右側でキーを作成し、任意のエンドポイントを呼び出してください。レスポンスはすべて JSON です。

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

認証

キーは Authorization ヘッダーの Bearer トークン、または X-API-Key で送信します。キーはアカウントとプランに紐づき、保存するのはハッシュのみなので、作成時にコピーしてください。

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

レート制限

制限はキーごとに適用されます。すべてのレスポンスに X-RateLimit-Limit と X-RateLimit-Remaining（UTC 日単位）が付き、429 には Retry-After が付きます。

プランの上限も適用されます。検索は新しいクエリごとに検索クレジットを 1 消費（結果ゼロなら返却）、照会は 1 時間あたりの照会枠を共有、キャンペーンはキャンペーン上限に従います。

エンドポイント

• GET/v1/me

  プランとこのキーに適用される制限。

• POST/v1/search

  Discover と同じフィルターでクリエイターデータベースを検索。フォロワー数、平均再生数、エンゲージメント率、国、言語、メールの有無を返します。

  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 でクリエイターを 1 件照会（handle= の代わりに url= も可）。

• POST/v1/creators/bulk

  プランの一括上限までのハンドルまたはプロフィール URL を 1 リクエストで照会。各行はクリエイター情報か、見つからなかった理由です。

  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

  公開プロフィールにこれらのメールを記載している、または自分の連絡先にいるクリエイター。

  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}

  キャンペーン 1 件と、追跡中の全投稿の最新指標。

• 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

  再生数・いいね・コメント・シェアの毎時時系列。

メール逆引きは 1 リクエストあたり最大 20 件です。

レスポンスとエラー

成功時は code が 0 で、データは data に入ります。エラーには固定の文字列 code と読みやすい message が付きます。

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

指標が null の場合、ソースが公開していないことを意味します。推定値で埋めることはありません。