Hediye gönderimi verileriniz için bir influencer API.

API ne işe yarar

Pozto’nun verilerini başka bir yerde isteyen operasyon sorumlusu ya da geliştirici içindir: bir Airtable tabanı, bir veri ambarı, bir panel, bir iç araç. Ya da tam tersi: hediyelerinizi gönderen sistemden içerik üreticisi eklemek, böylece kimse onları iki kez yazmak zorunda kalmaz.

Kendi listeniz, yani ürün gönderdiğiniz içerik üreticileri üzerinde çalışır. Aranacak bir influencer veritabanı değildir. Bir influencer API’sinden beklediğiniz buysa, Pozto aradığınız şey değil.

Anahtarlar, temel URL ve sınırlar

• Temel URL: https://pozto.co/api/v1
• Anahtarlar: Brand planında ekip sahibi bunları Ayarlar → API bölümünde oluşturur. Bir anahtar pz_ ile başlar ve yalnızca bir kez gösterilir: Pozto yalnızca bir parmak izini saklar, bu yüzden o anda kopyalayın. Her anahtara ne için olduğunu belirten bir ad verin ve istediğiniz zaman iptal edin. Ayarlar her anahtarın en son ne zaman kullanıldığını gösterir.
• Gönderme: her istekte Authorization: Bearer pz_…
• Kapsam: tek bir anahtar ekibinizdeki her markayı okur ve her markaya ekleme yapar.
• İstek sınırı: anahtar başına dakikada 120 istek.
• Sayfalar: GET /creators ve GET /posts bir seferde 100 kayıt döndürür; &limit= ile en fazla 500. Daha fazlası olduğunda yanıtta bir next_cursor bulunur: sonraki sayfa için bunu &cursor= olarak geri gönderin. Son sayfada null olur.
• Biçim: giriş ve çıkış JSON. Kimlikler dizedir, tarihler ISO 8601 biçimindedir.

Uç noktalar

Bir içerik üreticisi ve bir paylaşım neleri içerir

Bir içerik üreticisi; adı, e-postası, hesapları (ve her kullanıcı adının bulunup bulunmadığı), indirim kodları, durumu ve her hediyesiyle gelir: ürün ve kutunun geri kalanı, kampanyası, kargolanma ve teslim tarihleri, gün cinsinden son tarih, takip numarası, ücret, istenen paylaşım sayısı ve şu ana kadarki paylaşımlar.

Bir paylaşım, yayınlandığı her platformla birlikte tek bir videodur: bağlantı, açıklama, paylaşım tarihi ve sizi etiketleyip etiketlemediği. Ardından sayıldığı hediye ve ürün ile Pozto’nun buna nasıl karar verdiği. Ardından video kontrolü: ürününüzün bulunup bulunmadığı, ekranda göründüğü her an saniye cinsinden, alıntıyla birlikte söylendiği her an ve kısa bir özet. Ve reklam beyanı: net, zayıf ya da yok, nedeniyle birlikte.

İçerik üreticisi ve paylaşım ekleme

POST /creators, brand_id ve handles alır: @adlar, profil bağlantıları ya da Linktree tarzı bağlantılar, en fazla altı tane. Ayrıca platform, name, email, codes, product (bir kimlik ya da ad; yeni bir ad ürünü ekler), shipped_at, delivered_at, due_days (boş bırakırsanız 21) ve tracking alır. Listede zaten olan, hesaplarından herhangi biri ya da e-postasıyla eşleşen bir içerik üreticisi, kopyası oluşturulmak yerine hediyeyi alır. Yeni bir içerik üreticisi için 201, mevcut biri için 200 döndürür; içerik üreticisinin ve hediyenin kimliğiyle birlikte.

POST /posts, brand_id ve url alır; isteğe bağlı olarak creator_id ve product_id. Paylaşım, hesabın sahibi kimse onun altına kaydedilir, yeniyse listenize eklenir ve video kontrolü için sıraya alınır. Yeni olup olmadığını, kullanıcı adını, platformu ve sizin hakkınızda bir paylaşım sayılıp sayılmadığını döndürür.

# Bir markada geciken içerik üreticileri
curl "https://pozto.co/api/v1/creators?brand_id=BRAND_ID&status=late" \
  -H "Authorization: Bearer pz_…"

# Bir içerik üreticisi ve ona gönderdiğiniz hediyeyi ekleyin
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"}'

# 1 Ekim’den bu yana paylaşımlar, en yeniden başlayarak
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01" \
  -H "Authorization: Bearer pz_…"

# Sonraki sayfa: önceki yanıttaki next_cursor
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer pz_…"

Hatalar

Bir hata, {"error": "…"} gibi tek bir sade cümle içeren JSON ve 4xx durum koduyla döner:

• 400: gövde JSON değil ya da bir alan geçersiz, örneğin gelecekte bir teslim tarihi.
• 401: anahtar yok ya da anahtar yanlış veya iptal edilmiş.
• 403: ekibiniz Brand planında değil.
• 404: ekibinizde bu brand_id ile bir marka yok.
• 409: marka kilitli, çünkü planınızdaki marka sayısı ekibinizin kullandığından az.
• 429: bir dakikada 120’den fazla istek.

API’nin yapmadıkları

• Influencer araması yok. Kendi listenizi okur ve ona ekleme yapar. İçerik üreticisi aramak uygulamadaki İçerik üreticisi bul’un işidir.
• Yanıtlarda görüntülenme, beğeni ya da EMV yok. Bunlar Starter’dan itibaren uygulamada ve haftalık raporda. Influencer raporlama sayfasına bakın.
• Webhook yok. Yeni paylaşımları almak için since ile GET /posts isteği yapın.
• Düzenleme ya da silme yok. API okur ve ekler. Değişiklikler ve kaldırmalar uygulamada yapılır.
• Kişiye özel anahtar yok. Anahtarlar ekibe aittir ve yalnızca sahibi oluşturur.

Paylaşımlardaki bilgiler uygulamadakiyle aynıdır: Pozto paylaşımları videoyu, kareleri, sesi ve açıklamayı izleyerek bulur; böylece etiketsiz paylaşımlar da gelir. Paylaşımların nasıl bulunduğunu influencer takibi anlatır.

Fiyatlandırma

API, Brand planıyla gelir: aylık $999 ya da yıllık ödemede aylık $799; 10 marka, 1,000 aktif içerik üreticisi, sınırsız kullanıcı ve tek oturum açma (SSO) ile. Pozto’daki diğer her şey daha düşük planlarda başlar ve ücretsiz plan ilk 10 içerik üreticinizi kapsar. Planları görün.