API influencer untuk data gifting Anda.

Untuk apa API ini

API ini untuk tim ops atau developer yang ingin data Pozto ada di tempat lain: base Airtable, data warehouse, dashboard, atau tool internal. Atau sebaliknya: menambahkan kreator dari sistem yang mengirim hadiah Anda, supaya tidak ada yang mengetiknya dua kali.

API ini bekerja pada daftar kreator Anda sendiri, yaitu kreator yang sudah Anda kirimi produk. Ini bukan database influencer untuk dicari. Kalau itu yang Anda butuhkan dari sebuah API influencer, Pozto bukan jawabannya.

Key, base URL, dan batasan

• Base URL: https://pozto.co/api/v1
• Key: pemilik tim membuatnya di Pengaturan → API, di paket Brand. Key diawali pz_ dan hanya ditampilkan sekali: Pozto hanya menyimpan fingerprint-nya, jadi salin saat itu juga. Beri nama setiap key sesuai kegunaannya, dan cabut kapan saja. Pengaturan menampilkan kapan setiap key terakhir dipakai.
• Cara mengirim: Authorization: Bearer pz_… di setiap request.
• Cakupan: satu key bisa membaca dan menambahkan data ke semua brand di tim Anda.
• Rate limit: 120 request per menit per key.
• Halaman: GET /creators dan GET /posts mengembalikan 100 sekaligus, atau hingga 500 dengan &limit=. Jika masih ada, respons memuat next_cursor: kirim kembali sebagai &cursor= untuk halaman berikutnya. Nilainya null di halaman terakhir.
• Format: JSON untuk input dan output. Id berupa string, dan tanggal berformat ISO 8601.

Endpoint

Isi data kreator dan postingan

Data kreator berisi nama, email, akun (dan apakah setiap username ditemukan), kode diskon, status, dan setiap hadiah: produk dan isi paket lainnya, kampanyenya, tanggal dikirim dan tiba, tenggat dalam hari, nomor resi, fee, jumlah postingan yang diminta, dan jumlah postingan sejauh ini.

Satu postingan adalah satu video, dengan setiap platform tempat video itu diunggah: link, caption, tanggal posting, dan apakah men-tag Anda. Lalu hadiah dan produk yang dihitungnya, dan bagaimana Pozto memutuskannya. Lalu cek video: apakah produk Anda ditemukan, setiap momen di layar dalam detik, setiap kali disebut beserta kutipannya, dan ringkasan singkat. Dan pengungkapan: jelas, lemah, atau tidak ada, beserta alasannya.

Menambahkan kreator dan postingan

POST /creators menerima brand_id dan handles: @nama, link profil, atau link ala Linktree, hingga enam. Juga menerima platform, name, email, codes, product (id atau nama; nama baru akan menambahkan produk), shipped_at, delivered_at, due_days (21 jika dikosongkan), dan tracking. Kreator yang sudah ada di daftar, dicocokkan lewat salah satu akunnya atau email-nya, mendapat hadiah baru alih-alih dibuat duplikat. Responsnya 201 untuk kreator baru dan 200 untuk kreator yang sudah ada, dengan id kreator dan id hadiah.

POST /posts menerima brand_id dan url, serta creator_id dan product_id secara opsional. Postingan dicatat atas nama pemilik akun, kreatornya ditambahkan ke daftar Anda jika baru, dan postingan masuk antrean cek video. Responsnya berisi apakah postingan itu baru, username, platform, dan apakah dihitung sebagai postingan tentang Anda.

# Kreator yang terlambat, di satu brand
curl "https://pozto.co/api/v1/creators?brand_id=BRAND_ID&status=late" \
  -H "Authorization: Bearer pz_…"

# Tambahkan kreator dan hadiah yang Anda kirim
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"}'

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

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

Error

Error dikembalikan sebagai JSON berisi satu kalimat sederhana, seperti {"error": "…"}, dengan status 4xx:

• 400: body bukan JSON, atau ada field yang tidak valid, seperti tanggal tiba di masa depan.
• 401: tidak ada key, atau key salah atau sudah dicabut.
• 403: tim Anda tidak memakai paket Brand.
• 404: tidak ada brand dengan brand_id itu di tim Anda.
• 409: brand terkunci, karena paket Anda punya jumlah brand lebih sedikit daripada yang dipakai tim Anda.
• 429: lebih dari 120 request dalam satu menit.

Yang tidak dilakukan API

• Tidak ada pencarian influencer. API membaca dan menambah daftar Anda sendiri. Pencarian kreator ada di Cari kreator, di dalam aplikasi.
• Tidak ada views, likes, atau EMV di respons. Data itu ada di aplikasi mulai Starter, dan di laporan mingguan. Lihat laporan influencer.
• Tidak ada webhook. Untuk mengambil postingan baru, panggil GET /posts dengan since.
• Tidak ada edit atau hapus. API hanya membaca dan menambah. Perubahan dan penghapusan dilakukan di aplikasi.
• Tidak ada key per orang. Key milik tim, dan hanya pemilik tim yang bisa membuatnya.

Isi data postingan sama dengan di aplikasi: Pozto menemukan postingan dengan menonton videonya, frame, audio, dan caption, jadi postingan tanpa tag juga ikut masuk. Influencer tracking menjelaskan bagaimana postingan ditemukan.

Harga

API tersedia di paket Brand: $999 per bulan, atau $799 per bulan jika dibayar tahunan, dengan 10 brand, 1,000 kreator aktif, kursi tanpa batas, dan single sign-on. Semua fitur Pozto lainnya mulai tersedia di paket yang lebih rendah, dan paket gratis mencakup 10 kreator pertama Anda. Lihat paket.