ギフティングのデータを扱えるインフルエンサー API。

API でできること

Pozto のデータを別の場所で使いたい運用担当者や開発者向けです。Airtable のベース、データウェアハウス、ダッシュボード、社内ツールなど。逆方向にも使えます。ギフトを発送しているシステムからクリエイターを追加すれば、同じ情報を二度入力する必要がありません。

対象は自社のリスト、つまり商品を送ったクリエイターです。インフルエンサーを検索するためのデータベースではありません。インフルエンサー API にそれを求めているなら、Pozto は適していません。

キー、ベース URL、制限

• ベース URL： https://pozto.co/api/v1
• キー： Brand プランで、チームのオーナーが「設定」→「API」から作成します。キーは pz_ で始まり、表示されるのは一度だけです。Pozto はフィンガープリントしか保存しないため、その場でコピーしてください。用途ごとにキーに名前を付け、いつでも無効化できます。各キーが最後に使われた日時は「設定」で確認できます。
• 送り方： すべてのリクエストに Authorization: Bearer pz_… を付けます。
• 範囲： 1 つのキーで、チーム内のすべてのブランドの取得と追加ができます。
• レート制限： キーごとに 1 分あたり 120 リクエスト。
• ページ： GET /creators と GET /posts は 100 件ずつ返します。&limit= を付けると最大 500 件です。続きがある場合、レスポンスに next_cursor が含まれます。次のページを取得するには、それを &cursor= として送り返してください。最後のページでは null です。
• 形式： 入出力とも JSON。ID は文字列、日付は ISO 8601 です。

エンドポイント

クリエイターと投稿に含まれる情報

クリエイターには、名前、メールアドレス、アカウント（各アカウントが見つかったかどうか）、割引コード、ステータス、そして各ギフトが含まれます。ギフトには、商品と同梱品、キャンペーン、発送日と配達日、日数で表した期限、追跡番号、報酬、希望投稿数、現在の投稿数が入ります。

投稿は動画 1 本単位で、投稿されたすべてのプラットフォームの情報を持ちます：リンク、キャプション、投稿日、タグ付けの有無。次に、どのギフトと商品の投稿として数えたか、そして Pozto がそう判断した方法。さらに動画チェック：商品が見つかったか、画面に映った各タイミング（秒）、言及された各タイミングとその発言、短い要約。そして広告表記：明確、不十分、なしの判定とその理由です。

クリエイターと投稿の追加

POST /creators には brand_id と handles を渡します。@ユーザー名、プロフィールのリンク、Linktree などのリンクを最大 6 件まで指定できます。ほかに platform、name、email、codes、product（ID または名前。新しい名前なら商品が追加されます）、shipped_at、delivered_at、due_days（省略時は 21）、tracking も指定できます。いずれかのアカウントまたはメールアドレスで一致するクリエイターがすでにリストにいる場合は、重複を作らずにギフトを追加します。新しいクリエイターなら 201、既存なら 200 を返し、クリエイターの ID とギフトの ID が含まれます。

POST /posts には brand_id と url を渡し、必要に応じて creator_id と product_id も指定できます。投稿はアカウントの持ち主のもとに登録され、新しいクリエイターならリストに追加され、動画チェックの待ち行列に入ります。レスポンスには、新規かどうか、アカウント名、プラットフォーム、自社についての投稿として数えるかどうかが含まれます。

# 1 つのブランドで遅れているクリエイター
curl "https://pozto.co/api/v1/creators?brand_id=BRAND_ID&status=late" \
  -H "Authorization: Bearer pz_…"

# クリエイターと送ったギフトを追加
curl -X POST https://pozto.co/api/v1/creators \
  -H "Authorization: Bearer pz_…" \
  -H "Content-Type: application/json" \
  -d '{"brand_id":"BRAND_ID","handles":["@maya.glows"],"product":"Glow Serum","shipped_at":"2026-10-14"}'

# 10 月 1 日以降の投稿を新しい順に
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01" \
  -H "Authorization: Bearer pz_…"

# 次のページ：直前のレスポンスの next_cursor
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer pz_…"

エラー

エラーは {"error": "…"} のように 1 文の説明を含む JSON と、4xx のステータスで返ります。

• 400： 本文が JSON でない、または未来の配達日など、項目の値が正しくありません。
• 401： キーがない、キーが間違っている、または無効化されています。
• 403： チームが Brand プランではありません。
• 404： その brand_id のブランドがチームにありません。
• 409： プランのブランド数がチームで使っている数より少ないため、ブランドがロックされています。
• 429： 1 分間に 120 リクエストを超えました。

API でできないこと

• インフルエンサー検索はありません。 取得と追加の対象は自社のリストです。クリエイター探しはアプリの「クリエイターを探す」で行います。
• レスポンスに再生数、いいね、EMV は含まれません。 これらは Starter 以上のアプリと週次レポートで確認できます。インフルエンサーレポートをご覧ください。
• Webhook はありません。 新しい投稿を取り込むには、since を付けて GET /posts を呼び出してください。
• 編集や削除はできません。 API は取得と追加のみ。変更や削除はアプリで行います。
• 個人ごとのキーはありません。 キーはチームに属し、作成できるのはオーナーだけです。

投稿の中身はアプリと同じです。Pozto は動画のフレーム、音声、キャプションを見て投稿を見つけるため、タグなしの投稿も取得できます。投稿の見つけ方はインフルエンサー投稿の追跡で説明しています。

料金

API は Brand プランに含まれます。月額 $999、年払いなら月額 $799 で、ブランド 10 件、アクティブなクリエイター 1,000 名、シート数無制限、シングルサインオン付き。Pozto のそれ以外の機能はより下位のプランから使え、無料プランでは最初の 10 名のクリエイターまで対応します。プランを見る。