API influencer untuk data hadiah anda.

Untuk apa API ini

Ia untuk orang operasi atau pembangun yang mahu data Pozto berada di tempat lain: pangkalan Airtable, gudang data, papan pemuka, alat dalaman. Atau sebaliknya: menambah pencipta daripada sistem yang menghantar hadiah anda, supaya tiada siapa perlu menaipnya dua kali.

Ia berfungsi pada senarai anda sendiri, iaitu pencipta yang telah anda hantarkan produk. Ia bukan pangkalan data influencer untuk dicari. Jika itu yang anda perlukan daripada API influencer, Pozto bukan jawapannya.

Kunci, URL asas dan had

• URL asas: https://pozto.co/api/v1
• Kunci: pemilik pasukan membuatnya dalam Tetapan → API, pada pelan Brand. Kunci bermula dengan pz_ dan ditunjukkan sekali sahaja: Pozto hanya menyimpan cap jarinya, jadi salin ketika itu. Namakan setiap kunci mengikut kegunaannya, dan batalkannya bila-bila masa. Tetapan menunjukkan bila setiap kunci terakhir digunakan.
• Cara menghantarnya: Authorization: Bearer pz_… pada setiap permintaan.
• Skop: satu kunci membaca dan menambah kepada setiap jenama dalam pasukan anda.
• Had kadar: 120 permintaan seminit bagi setiap kunci.
• Halaman: GET /creators dan GET /posts memulangkan 100 pada satu masa, atau sehingga 500 dengan &limit=. Jika ada lagi, respons mempunyai next_cursor: hantar semula sebagai &cursor= untuk halaman seterusnya. Nilainya null pada halaman terakhir.
• Format: JSON masuk dan keluar. Id ialah rentetan, dan tarikh dalam ISO 8601.

Endpoint

Apa yang terkandung dalam pencipta dan siaran

Pencipta disertakan dengan nama, e-mel, akaun (dan sama ada setiap nama pengguna ditemui), kod diskaun, status, dan setiap hadiah: produk dan isi kotak yang lain, kempennya, tarikh dihantar dan sampai, tarikh akhir dalam hari, nombor penjejakan, yuran, siaran yang diminta dan siaran setakat ini.

Siaran ialah satu video, dengan setiap platform tempat ia disiarkan: pautan, kapsyen, tarikh siaran dan sama ada ia tag anda. Kemudian hadiah dan produk yang dikiranya, dan bagaimana Pozto memutuskannya. Kemudian semakan video: sama ada produk anda ditemui, setiap detik di skrin dalam saat, setiap kali ia disebut berserta petikannya, dan ringkasan pendek. Dan pendedahan: jelas, lemah atau tiada, berserta sebabnya.

Menambah pencipta dan siaran

POST /creators menerima brand_id dan handles: @nama, pautan profil atau pautan gaya Linktree, sehingga enam. Ia juga menerima platform, name, email, codes, product (id atau nama; nama baharu menambah produk itu), shipped_at, delivered_at, due_days (21 jika anda tidak memasukkannya) dan tracking. Pencipta yang sudah ada dalam senarai, dipadankan melalui mana-mana akaun atau e-mel mereka, menerima hadiah itu dan bukannya pendua. Ia menjawab 201 untuk pencipta baharu dan 200 untuk pencipta sedia ada, dengan id pencipta dan id hadiah.

POST /posts menerima brand_id dan url, serta creator_id dan product_id secara pilihan. Siaran difailkan di bawah pemilik akaun itu, ditambah ke senarai anda jika mereka baharu, dan dibariskan untuk semakan video. Ia menjawab sama ada siaran itu baharu, nama pengguna, platform dan sama ada ia dikira sebagai siaran tentang anda.

# Pencipta yang lewat, dalam satu jenama
curl "https://pozto.co/api/v1/creators?brand_id=BRAND_ID&status=late" \
  -H "Authorization: Bearer pz_…"

# Tambah pencipta dan hadiah yang anda hantar kepada mereka
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"}'

# Siaran sejak 1 Oktober, terbaru dahulu
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01" \
  -H "Authorization: Bearer pz_…"

# Halaman seterusnya: next_cursor daripada respons sebelumnya
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer pz_…"

Ralat

Ralat dipulangkan sebagai JSON dengan satu ayat ringkas, seperti {"error": "…"}, dan status 4xx:

• 400: badan permintaan bukan JSON, atau medan tidak sah, seperti tarikh sampai pada masa hadapan.
• 401: tiada kunci, atau kunci salah atau telah dibatalkan.
• 403: pasukan anda tidak berada pada pelan Brand.
• 404: tiada jenama dengan brand_id itu dalam pasukan anda.
• 409: jenama dikunci, kerana pelan anda mempunyai lebih sedikit jenama daripada yang digunakan pasukan anda.
• 429: lebih daripada 120 permintaan dalam seminit.

Apa yang tidak dilakukan oleh API

• Tiada carian influencer. Ia membaca dan menambah kepada senarai anda sendiri. Mencari pencipta dilakukan melalui Cari pencipta, dalam aplikasi.
• Tiada tontonan, suka atau EMV dalam respons. Ia ada dalam aplikasi mulai Starter, dan dalam laporan mingguan. Lihat laporan influencer.
• Tiada webhook. Untuk mendapatkan siaran baharu, panggil GET /posts dengan since.
• Tiada suntingan atau pemadaman. API membaca dan menambah. Perubahan dan pembuangan dilakukan dalam aplikasi.
• Tiada kunci individu. Kunci milik pasukan, dan hanya pemilik yang membuatnya.

Kandungan siaran sama seperti dalam aplikasi: Pozto menemui siaran dengan menonton video, bingkai, audio dan kapsyen, jadi siaran tanpa tag turut disertakan. Penjejakan influencer menerangkan cara siaran ditemui.

Harga

API disertakan dengan pelan Brand: $999 sebulan, atau $799 sebulan jika dibayar tahunan, dengan 10 jenama, 1,000 pencipta aktif, tempat duduk tanpa had dan log masuk tunggal. Semua yang lain dalam Pozto bermula pada pelan lebih rendah, dan pelan percuma meliputi 10 pencipta pertama anda. Lihat pelan.