Influencer API pro vaše data o giftingu.

K čemu API slouží

Je pro člověka z provozu nebo vývojáře, který chce mít data z Pozto jinde: v Airtable, v datovém skladu, v dashboardu, v interním nástroji. Nebo naopak: přidávat tvůrce ze systému, který vaše dary odesílá, aby je nikdo nepsal dvakrát.

Pracuje s vaším vlastním seznamem, s tvůrci, kterým jste poslali produkt. Není to databáze influencerů k vyhledávání. Pokud tohle od influencer API potřebujete, Pozto to není.

Klíče, základní URL a limity

• Základní URL: https://pozto.co/api/v1
• Klíče: vytváří je vlastník týmu v Nastavení → API, v tarifu Brand. Klíč začíná pz_ a zobrazí se jen jednou: Pozto si uchová pouze jeho otisk, takže si ho hned zkopírujte. Každý klíč pojmenujte podle účelu a kdykoli ho můžete zrušit. Nastavení ukazují, kdy byl který klíč naposledy použit.
• Odeslání: Authorization: Bearer pz_… u každého požadavku.
• Rozsah: jeden klíč čte a přidává do všech značek vašeho týmu.
• Limit požadavků: 120 požadavků za minutu na klíč.
• Stránkování: GET /creators a GET /posts vracejí 100 záznamů najednou, nebo až 500 s &limit=. Když jich je víc, odpověď obsahuje next_cursor: pošlete ho zpět jako &cursor= pro další stránku. Na poslední stránce je null.
• Formát: JSON na vstupu i výstupu. ID jsou řetězce a data ve formátu ISO 8601.

Endpointy

Co obsahuje tvůrce a příspěvek

Tvůrce obsahuje jméno, e-mail, účty (a zda byl každý profil nalezen), slevové kódy, stav a každý dar: produkt a zbytek balíčku, kampaň, datum odeslání a doručení, termín ve dnech, sledovací číslo zásilky, honorář, požadovaný počet příspěvků a dosavadní příspěvky.

Příspěvek je jedno video se všemi platformami, kde vyšlo: odkaz, popisek, datum zveřejnění a zda vás označil. Dále dar a produkt, ke kterému se počítá, a jak to Pozto určil. Pak kontrola videa: zda byl váš produkt nalezen, každý okamžik na obrazovce v sekundách, každá zmínka nahlas s citací a krátké shrnutí. A označení spolupráce: jasné, slabé nebo žádné, s odůvodněním.

Přidávání tvůrců a příspěvků

POST /creators přijímá brand_id a handles: @jména, odkazy na profily nebo odkazy typu Linktree, až šest. Dále platform, name, email, codes, product (id nebo název; nový název přidá produkt), shipped_at, delivered_at, due_days (21, pokud ho vynecháte) a tracking. Tvůrce, který už na seznamu je, spárovaný podle kteréhokoli účtu nebo e-mailu, dostane dar místo duplicity. Odpoví 201 u nového tvůrce a 200 u existujícího, s id tvůrce a id daru.

POST /posts přijímá brand_id a url, volitelně creator_id a product_id. Příspěvek se zařadí k tomu, komu účet patří, nový tvůrce se přidá na váš seznam a příspěvek se zařadí do fronty na kontrolu videa. Odpoví, zda byl nový, profilem, platformou a zda se počítá jako příspěvek o vás.

# Tvůrci se zpožděním v jedné značce
curl "https://pozto.co/api/v1/creators?brand_id=BRAND_ID&status=late" \
  -H "Authorization: Bearer pz_…"

# Přidání tvůrce a daru, který jste mu poslali
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"}'

# Příspěvky od 1. října, nejnovější první
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01" \
  -H "Authorization: Bearer pz_…"

# Další stránka: next_cursor z předchozí odpovědi
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer pz_…"

Chyby

Chyba se vrátí jako JSON s jednou srozumitelnou větou, například {"error": "…"}, a se stavem 4xx:

• 400: tělo není JSON nebo některé pole není platné, třeba datum doručení v budoucnosti.
• 401: chybí klíč, nebo je klíč chybný či zrušený.
• 403: váš tým nemá tarif Brand.
• 404: ve vašem týmu není značka s tímto brand_id.
• 409: značka je uzamčená, protože váš tarif má méně značek, než váš tým používá.
• 429: víc než 120 požadavků za minutu.

Co API neumí

• Žádné vyhledávání influencerů. Čte váš vlastní seznam a přidává do něj. Hledání tvůrců najdete v aplikaci pod Najít tvůrce.
• V odpovědích nejsou zhlédnutí, lajky ani EMV. Jsou v aplikaci od tarifu Starter a v týdenním reportu. Viz reporting influencerů.
• Žádné webhooky. Nové příspěvky získáte dotazem GET /posts se since.
• Žádné úpravy ani mazání. API čte a přidává. Změny a odebírání probíhají v aplikaci.
• Žádné osobní klíče. Klíče patří týmu a vytváří je jen vlastník.

Obsah příspěvků je stejný jako v aplikaci: Pozto hledá příspěvky sledováním videa, snímků, zvuku a popisku, takže projdou i neoznačené příspěvky. Jak se příspěvky hledají, vysvětluje stránka sledování influencerů.

Ceník

API je součástí tarifu Brand: $999 měsíčně, nebo $799 měsíčně při roční platbě, s 10 značkami, 1 000 aktivními tvůrci, neomezeným počtem uživatelů a jednotným přihlášením (SSO). Vše ostatní v Pozto začíná v nižších tarifech a bezplatný tarif pokryje vašich prvních 10 tvůrců. Zobrazit tarify.