為你的公關品資料打造的網紅 API。

API 的用途

它是給想把 Pozto 資料放到別處的營運人員或開發者用的：Airtable、資料倉儲、儀表板、內部工具。也可以反過來：從寄送公關品的系統新增創作者，就不用有人再輸入一次。

它處理的是你自己的名單，也就是你寄過產品的創作者。它不是用來搜尋網紅的資料庫。如果你要的網紅 API 是那種東西，Pozto 不適合你。

金鑰、Base URL 和限制

• Base URL： https://pozto.co/api/v1
• 金鑰： 由團隊擁有者在 Brand 方案的「設定 → API」中建立。金鑰以 pz_ 開頭，只會顯示一次：Pozto 只保留指紋，所以請當下複製。依用途為每個金鑰命名，隨時都能撤銷。「設定」會顯示每個金鑰最近一次的使用時間。
• 傳送方式： 每個請求都帶上 Authorization: Bearer pz_…。
• 範圍： 一個金鑰可以讀取並新增到你團隊的每個品牌。
• 速率限制： 每個金鑰每分鐘 120 個請求。
• 分頁： GET /creators 與 GET /posts 每次回傳 100 筆，加上 &limit= 最多 500 筆。若還有更多，回應會附上 next_cursor：將它作為 &cursor= 傳回即可取得下一頁。最後一頁時為 null。
• 格式： 輸入和輸出都是 JSON。Id 為字串，日期為 ISO 8601。

端點

創作者和貼文包含哪些資料

創作者包含名稱、email、帳號（以及每個帳號是否找得到）、折扣碼、狀態，以及每份公關品：產品和同箱的其他東西、所屬活動、寄出和送達日期、以天數計的期限、物流追蹤編號、費用、要求的貼文數和目前的貼文數。

一則貼文就是一支影片，包含它發布的每個平台：連結、文案、發布日期，以及是否標註你。接著是它計入的公關品和產品，以及 Pozto 如何判定。再來是影片檢查：是否找到你的產品、每個入鏡時刻（以秒計）、每次被說出時的原話，以及簡短摘要。還有業配揭露：清楚、不足或沒有，並附上原因。

新增創作者和貼文

POST /creators 接受 brand_id 和 handles：@帳號、個人檔案連結或 Linktree 類型的連結，最多六個。也接受 platform、name、email、codes、product（id 或名稱；新名稱會新增產品）、shipped_at、delivered_at、due_days（省略則為 21）和 tracking。已在名單上的創作者（以任一帳號或 email 比對）會收到這份公關品，而不會重複建立。新創作者回應 201，既有創作者回應 200，並附上創作者 id 和公關品 id。

POST /posts 接受 brand_id 和 url，以及選填的 creator_id 和 product_id。貼文會歸到該帳號的擁有者名下，若是新創作者則加入你的名單，並排入影片檢查。回應會說明是否為新貼文、帳號、平台，以及它是否算是關於你的貼文。

# 某個品牌中逾期的創作者
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_…"

錯誤

錯誤會以 JSON 回傳一句簡單的說明，例如 {"error": "…"}，並附上 4xx 狀態碼：

• 400： 內容不是 JSON，或某個欄位無效，例如送達日期在未來。
• 401： 沒有金鑰，或金鑰錯誤或已撤銷。
• 403： 你的團隊不在 Brand 方案。
• 404： 你的團隊中沒有該 brand_id 的品牌。
• 409： 品牌已鎖定，因為你方案的品牌數少於團隊使用的數量。
• 429： 一分鐘內超過 120 個請求。

API 不做的事

• 沒有網紅搜尋。 它只讀取和新增你自己的名單。搜尋創作者請用 app 裡的「尋找創作者」。
• 回應中沒有觀看數、按讚數或 EMV。 這些在 app 中從 Starter 方案開始提供，也在每週報告裡。請見網紅成效報告。
• 沒有 webhook。 要取得新貼文，請用 since 呼叫 GET /posts。
• 無法編輯或刪除。 API 只能讀取和新增。修改和移除請在 app 中進行。
• 沒有個人金鑰。 金鑰屬於團隊，而且只有擁有者能建立。

貼文內容和 app 中相同：Pozto 透過檢視影片的畫面、音訊和文案來找到貼文，所以未標註的貼文也會被找到。網紅追蹤說明了貼文是怎麼被找到的。

價格

API 包含在 Brand 方案中：每月 $999，年繳則每月 $799，含 10 個品牌、1,000 位活躍創作者、不限使用者席次和單一登入（SSO）。Pozto 的其他功能都從更低的方案開始提供，免費方案涵蓋你的前 10 位創作者。查看方案。