Un API pentru influenceri, pentru datele tale de gifting.

La ce folosește API-ul

E pentru omul de operațiuni sau developerul care vrea datele Pozto în altă parte: o bază Airtable, un data warehouse, un dashboard, un instrument intern. Sau invers: adăugarea creatorilor direct din sistemul care îți expediază cadourile, ca nimeni să nu-i scrie de două ori.

Funcționează pe propria ta listă, creatorii cărora le-ai trimis produse. Nu e o bază de date de influenceri în care să cauți. Dacă asta îți trebuie de la un API pentru influenceri, Pozto nu e soluția.

Chei, URL de bază și limite

• URL de bază: https://pozto.co/api/v1
• Chei: proprietarul echipei le creează în Setări → API, pe planul Brand. O cheie începe cu pz_ și e afișată o singură dată: Pozto păstrează doar o amprentă, așa că copiaz-o atunci. Numește fiecare cheie după rolul ei și revoc-o oricând. Setările arată când a fost folosită ultima dată fiecare cheie.
• Cum o trimiți: Authorization: Bearer pz_… la fiecare cerere.
• Acces: o cheie citește și adaugă la toate brandurile echipei tale.
• Limită de cereri: 120 de cereri pe minut per cheie.
• Pagini: GET /creators și GET /posts returnează câte 100 odată, sau până la 500 cu &limit=. Când mai sunt, răspunsul are un next_cursor: trimite-l înapoi ca &cursor= pentru pagina următoare. Pe ultima pagină este null.
• Format: JSON la intrare și la ieșire. ID-urile sunt șiruri de caractere, iar datele calendaristice sunt în ISO 8601.

Endpointuri

Ce conțin un creator și o postare

Un creator vine cu numele, e-mailul, conturile (și dacă fiecare cont a fost găsit), codurile de reducere, starea și fiecare cadou: produsul și restul pachetului, campania, datele de expediere și livrare, termenul în zile, numărul de urmărire al coletului, onorariul, postările cerute și postările de până acum.

O postare e un videoclip, cu fiecare platformă pe care a apărut: link, descriere, data publicării și dacă ți-a dat tag. Apoi cadoul și produsul pentru care se numără și cum a decis Pozto asta. Apoi verificarea video: dacă produsul tău a fost găsit, fiecare moment pe ecran în secunde, de fiecare dată când a fost rostit, cu citatul, și un scurt rezumat. Și declararea: clară, slabă sau lipsă, cu motivul.

Adăugarea creatorilor și a postărilor

POST /creators primește brand_id și handles: @nume, linkuri de profil sau linkuri de tip Linktree, până la șase. Mai primește platform, name, email, codes, product (un id sau un nume; un nume nou adaugă produsul), shipped_at, delivered_at, due_days (21 dacă îl omiți) și tracking. Un creator aflat deja pe listă, recunoscut după oricare dintre conturi sau după e-mail, primește cadoul în loc să fie dublat. Răspunde cu 201 pentru un creator nou și 200 pentru unul existent, cu id-ul creatorului și id-ul cadoului.

POST /posts primește brand_id și url, iar opțional creator_id și product_id. Postarea e pusă la cel care deține contul, adăugat pe lista ta dacă e nou, și intră în coada verificării video. Răspunde dacă era nouă, cu contul, platforma și dacă se numără ca postare despre tine.

# Creatorii întârziați dintr-un brand
curl "https://pozto.co/api/v1/creators?brand_id=BRAND_ID&status=late" \
  -H "Authorization: Bearer pz_…"

# Adaugă un creator și cadoul trimis
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"}'

# Postările de la 1 octombrie, cele mai noi primele
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01" \
  -H "Authorization: Bearer pz_…"

# Pagina următoare: next_cursor din răspunsul anterior
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer pz_…"

Erori

O eroare vine ca JSON cu o singură propoziție simplă, de exemplu {"error": "…"}, și un cod 4xx:

• 400: corpul cererii nu e JSON sau un câmp nu e valid, de exemplu o dată de livrare în viitor.
• 401: lipsește cheia sau cheia e greșită ori revocată.
• 403: echipa ta nu e pe planul Brand.
• 404: nu există un brand cu acel brand_id în echipa ta.
• 409: brandul e blocat, pentru că planul tău are mai puține branduri decât folosește echipa.
• 429: mai mult de 120 de cereri într-un minut.

Ce nu face API-ul

• Nu caută influenceri. Citește și adaugă la propria ta listă. Căutarea de creatori se face cu Găsește creatori, în aplicație.
• Nu returnează vizualizări, aprecieri sau EMV. Acestea sunt în aplicație de la Starter și în raportul săptămânal. Vezi raportarea pentru influenceri.
• Fără webhookuri. Ca să preiei postările noi, apelează GET /posts cu since.
• Fără modificări sau ștergeri. API-ul citește și adaugă. Modificările și ștergerile se fac în aplicație.
• Fără chei personale. Cheile aparțin echipei și doar proprietarul le creează.

Postările conțin același lucru ca în aplicație: Pozto găsește postările urmărind videoclipul, cadrele, sunetul și descrierea, așa că apar și postările fără tag. Urmărirea influencerilor explică cum sunt găsite postările.

Prețuri

API-ul vine cu planul Brand: $999 pe lună sau $799 pe lună la plata anuală, cu 10 branduri, 1.000 de creatori activi, locuri nelimitate și single sign-on. Tot restul din Pozto începe pe planuri mai mici, iar planul gratuit acoperă primii tăi 10 creatori. Vezi planurile.