Influencer API az ajándékozási adataidhoz.

Mire való az API

Annak az operatív kollégának vagy fejlesztőnek szól, aki máshol is szeretné látni a Pozto adatait: egy Airtable-bázisban, adattárházban, irányítópulton vagy belső eszközben. Vagy fordítva: kreátorok hozzáadására abból a rendszerből, amely az ajándékaidat küldi, hogy senkinek ne kelljen kétszer begépelnie őket.

A saját kreátorlistádon dolgozik, azokon, akiknek terméket küldtél. Nem kereshető influencer-adatbázis. Ha egy influencer API-tól erre van szükséged, a Pozto nem ez.

Kulcsok, alap-URL és korlátok

• Alap-URL: https://pozto.co/api/v1
• Kulcsok: a csapat tulajdonosa hozza létre őket a Beállítások → API menüben, a Brand csomagban. A kulcs pz_ előtaggal kezdődik, és csak egyszer jelenik meg: a Pozto csak egy ujjlenyomatot tárol, ezért akkor másold ki. Nevezd el mindegyik kulcsot aszerint, mire használod, és bármikor visszavonhatod. A Beállítások mutatja, mikor használták utoljára az egyes kulcsokat.
• Küldése: Authorization: Bearer pz_… minden kérésben.
• Hatókör: egy kulccsal a csapatod minden márkáját olvashatod és bővítheted.
• Kéréskorlát: kulcsonként percenként 120 kérés.
• Oldalak: a GET /creators és a GET /posts 100 elemet ad vissza, vagy legfeljebb 500-at az &limit= használatával. Ha van még, a válaszban van egy next_cursor: küldd vissza &cursor= néven a következő oldalhoz. Az utolsó oldalon értéke null.
• Formátum: JSON be és ki. Az azonosítók stringek, a dátumok ISO 8601 formátumúak.

Végpontok

Mit tartalmaz egy kreátor és egy poszt

Egy kreátorral együtt jön a neve, e-mail-címe, fiókjai (és hogy az egyes felhasználóneveket megtalálta-e a rendszer), kedvezménykódjai, státusza és minden ajándéka: a termék és a csomag többi része, a kampánya, a feladás és a kézbesítés dátuma, a határidő napokban, a nyomkövetési szám, a díj, a kért és az eddigi posztok száma.

Egy poszt egy videó, minden platformmal, ahová felkerült: link, leírás, posztolás dátuma, és hogy megjelölt-e. Utána az ajándék és a termék, amelyhez beszámít, és hogy a Pozto ezt hogyan döntötte el. Majd a videóellenőrzés: megtalálta-e a termékedet, minden képernyős pillanat másodpercben, minden alkalom, amikor elhangzott, az idézettel, és egy rövid összefoglaló. Végül a reklámjelölés: egyértelmű, gyenge vagy nincs, indoklással.

Kreátorok és posztok hozzáadása

A POST /creators a brand_id és a handles mezőt várja: @neveket, profillinkeket vagy Linktree-szerű linkeket, legfeljebb hatot. Elfogadja továbbá a platform, name, email, codes, product (azonosító vagy név; egy új név új terméket ad hozzá), shipped_at, delivered_at, due_days (ha kihagyod, 21) és tracking mezőt. Ha a kreátor már a listán van – bármelyik fiókja vagy az e-mail-címe alapján –, duplikátum helyett az ajándékot kapja meg. Új kreátornál 201-gyel, meglévőnél 200-zal válaszol, a kreátor és az ajándék azonosítójával.

A POST /posts a brand_id és az url mezőt várja, opcionálisan a creator_id és a product_id mezőt. A poszt ahhoz kerül, akié a fiók, ha új, felkerül a listádra, és sorba áll a videóellenőrzéshez. A válaszban szerepel, hogy új volt-e, a felhasználónév, a platform, és hogy rólad szóló posztnak számít-e.

# Késésben lévő kreátorok egy márkánál
curl "https://pozto.co/api/v1/creators?brand_id=BRAND_ID&status=late" \
  -H "Authorization: Bearer pz_…"

# Kreátor és a neki küldött ajándék hozzáadása
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"}'

# Posztok október 1. óta, a legújabbal kezdve
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01" \
  -H "Authorization: Bearer pz_…"

# A következő oldal: az előző válasz next_cursor értékével
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer pz_…"

Hibák

A hiba JSON-ként érkezik egyetlen érthető mondattal, például {"error": "…"}, és 4xx státusszal:

• 400: a törzs nem JSON, vagy egy mező érvénytelen, például jövőbeli kézbesítési dátum.
• 401: nincs kulcs, vagy a kulcs hibás vagy visszavont.
• 403: a csapatod nem a Brand csomagot használja.
• 404: nincs ilyen brand_id azonosítójú márka a csapatodban.
• 409: a márka zárolva van, mert a csomagod kevesebb márkát enged, mint amennyit a csapatod használ.
• 429: több mint 120 kérés egy percen belül.

Amit az API nem csinál

• Nincs influencerkeresés. A saját listádat olvassa és bővíti. Kreátorokat az appban, a Kreátorkeresésben kereshetsz.
• Nincsenek megtekintések, lájkok vagy EMV a válaszokban. Ezek az appban vannak a Startertől, és a heti riportban. Lásd: influencer riportok.
• Nincsenek webhookok. Az új posztokért kérdezd le a GET /posts végpontot a since paraméterrel.
• Nincs szerkesztés vagy törlés. Az API olvas és hozzáad. A módosítások és törlések az appban történnek.
• Nincsenek személyes kulcsok. A kulcsok a csapathoz tartoznak, és csak a tulajdonos hozhatja létre őket.

A posztok tartalma ugyanaz, mint az appban: a Pozto a videó képkockáinak, hangjának és leírásának vizsgálatával találja meg a posztokat, így a jelöletlen posztok is megjelennek. Az influencerkövetés elmagyarázza, hogyan találjuk meg a posztokat.

Árak

Az API a Brand csomaggal jár: havi $999, éves fizetéssel havi $799, 10 márkával, 1000 aktív kreátorral, korlátlan felhasználóval és egyszeri bejelentkezéssel (SSO). A Pozto minden más funkciója alacsonyabb csomagokban kezdődik, az ingyenes csomag pedig az első 10 kreátorodat fedi le. Csomagok megtekintése.