Vaikuttaja-API lahjadatallesi.

Mihin API on tarkoitettu

Se on operatiiviselle tekijälle tai kehittäjälle, joka haluaa Pozton datan muualle: Airtable-tietokantaan, tietovarastoon, hallintapaneeliin tai sisäiseen työkaluun. Tai toisin päin: tekijöiden lisäämiseen järjestelmästä, joka lähettää lahjasi, jotta kenenkään ei tarvitse kirjoittaa niitä kahdesti.

Se toimii omalla tekijälistallasi, niillä tekijöillä, joille olet lähettänyt tuotteita. Se ei ole haettava vaikuttajatietokanta. Jos sitä tarvitset vaikuttaja-API:lta, Pozto ei ole oikea valinta.

Avaimet, perus-URL ja rajat

• Perus-URL: https://pozto.co/api/v1
• Avaimet: tiimin omistaja luo ne kohdassa Asetukset → API, Brand-paketissa. Avain alkaa pz_ ja näytetään vain kerran: Pozto säilyttää vain sormenjäljen, joten kopioi se silloin. Nimeä jokainen avain sen käyttötarkoituksen mukaan ja peru se milloin tahansa. Asetuksissa näkyy, milloin kutakin avainta on viimeksi käytetty.
• Lähettäminen: Authorization: Bearer pz_… jokaisessa pyynnössä.
• Laajuus: yksi avain lukee ja lisää tiimisi jokaiseen brändiin.
• Pyyntöraja: 120 pyyntöä minuutissa avainta kohden.
• Sivut: GET /creators ja GET /posts palauttavat 100 kerrallaan tai enintään 500 parametrilla &limit=. Kun lisää on, vastauksessa on next_cursor: lähetä se takaisin parametrina &cursor= seuraavaa sivua varten. Viimeisellä sivulla se on null.
• Muoto: JSON sisään ja ulos. Tunnisteet ovat merkkijonoja ja päivämäärät ISO 8601 -muodossa.

Rajapinnat

Mitä tekijä ja julkaisu sisältävät

Tekijän mukana tulevat nimi, sähköposti, tilit (ja löytyikö kukin käyttäjänimi), alennuskoodit, tila ja jokainen lahja: tuote ja paketin muu sisältö, sen kampanja, lähetys- ja toimituspäivä, määräaika päivinä, seurantanumero, palkkio, toivotut julkaisut ja tähänastiset julkaisut.

Julkaisu on yksi video kaikkine alustoineen, joille se julkaistiin: linkki, kuvateksti, julkaisupäivä ja merkitsikö se sinut. Sitten lahja ja tuote, joihin se lasketaan, ja miten Pozto sen päätti. Sitten videotarkistus: löytyikö tuotteesi, jokainen ruudulla näkyvä hetki sekunteina, jokainen kerta, kun se sanottiin, lainauksineen, ja lyhyt yhteenveto. Ja mainosmerkintä: selkeä, heikko tai puuttuu, perusteluineen.

Tekijöiden ja julkaisujen lisääminen

POST /creators ottaa brand_id:n ja handles-kentän: @-nimet, profiililinkit tai Linktree-tyyppiset linkit, enintään kuusi. Se ottaa myös kentät platform, name, email, codes, product (tunniste tai nimi; uusi nimi lisää tuotteen), shipped_at, delivered_at, due_days (21, jos jätät sen pois) ja tracking. Listalla jo oleva tekijä, joka tunnistetaan minkä tahansa tilinsä tai sähköpostinsa perusteella, saa lahjan kaksoiskappaleen sijaan. Se vastaa 201 uudelle tekijälle ja 200 olemassa olevalle, tekijän ja lahjan tunnisteiden kera.

POST /posts ottaa brand_id:n ja url:n sekä valinnaisesti creator_id:n ja product_id:n. Julkaisu kirjataan tilin omistajalle, tämä lisätään listallesi, jos hän on uusi, ja julkaisu jonotetaan videotarkistukseen. Se vastaa tiedolla siitä, oliko julkaisu uusi, käyttäjänimellä, alustalla ja sillä, lasketaanko se sinusta tehdyksi julkaisuksi.

# Myöhässä olevat tekijät yhdessä brändissä
curl "https://pozto.co/api/v1/creators?brand_id=BRAND_ID&status=late" \
  -H "Authorization: Bearer pz_…"

# Lisää tekijä ja hänelle lähettämäsi lahja
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"}'

# Julkaisut 1. lokakuuta alkaen, uusin ensin
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01" \
  -H "Authorization: Bearer pz_…"

# Seuraava sivu: edellisen vastauksen next_cursor
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer pz_…"

Virheet

Virhe palautetaan JSONina yhdellä selkeällä lauseella, kuten {"error": "…"}, ja 4xx-tilakoodilla:

• 400: runko ei ole JSONia tai jokin kenttä ei kelpaa, esimerkiksi tulevaisuudessa oleva toimituspäivä.
• 401: avain puuttuu, on väärä tai peruttu.
• 403: tiimisi ei ole Brand-paketissa.
• 404: tiimissäsi ei ole brändiä tällä brand_id:llä.
• 409: brändi on lukittu, koska pakettisi sisältää vähemmän brändejä kuin tiimisi käyttää.
• 429: yli 120 pyyntöä minuutissa.

Mitä API ei tee

• Ei vaikuttajahakua. Se lukee omaa listaasi ja lisää siihen. Tekijöiden haku tapahtuu sovelluksen Etsi tekijöitä -näkymässä.
• Ei näyttökertoja, tykkäyksiä tai EMV:tä vastauksissa. Ne ovat sovelluksessa Starterista alkaen ja viikkoraportissa. Katso vaikuttajaraportointi.
• Ei webhookeja. Hae uudet julkaisut kutsumalla GET /posts since-parametrilla.
• Ei muokkauksia tai poistoja. API lukee ja lisää. Muutokset ja poistot tehdään sovelluksessa.
• Ei henkilökohtaisia avaimia. Avaimet kuuluvat tiimille, ja vain omistaja luo ne.

Julkaisujen sisältö on sama kuin sovelluksessa: Pozto löytää julkaisut tarkastelemalla videota, kuvia, ääntä ja kuvatekstiä, joten myös merkitsemättömät julkaisut tulevat mukaan. Vaikuttajaseuranta kertoo, miten julkaisut löydetään.

Hinnoittelu

API kuuluu Brand-pakettiin: $999 kuukaudessa tai $799 kuukaudessa vuosilaskutuksella, sisältäen 10 brändiä, 1,000 aktiivista tekijää, rajattomasti käyttäjäpaikkoja ja kertakirjautumisen. Kaikki muu Poztossa alkaa edullisemmista paketeista, ja ilmainen paketti kattaa ensimmäiset 10 tekijääsi. Katso paketit.