Et influencer-API for gavedataene dine.

Hva API-et er til

Det er for driftsansvarlige eller utviklere som vil ha dataene fra Pozto et annet sted: en Airtable-base, et datavarehus, et dashbord, et internt verktøy. Eller motsatt vei: legge til skapere fra systemet som sender gavene dine, så ingen må skrive dem inn to ganger.

Det jobber med din egen liste, skaperne du har sendt produkter til. Det er ikke en database med influencere å søke i. Er det det du trenger fra et influencer-API, er ikke Pozto riktig verktøy.

Nøkler, base-URL og grenser

• Base-URL: https://pozto.co/api/v1
• Nøkler: teameieren lager dem under Innstillinger → API, på Brand-planen. En nøkkel starter med pz_ og vises bare én gang: Pozto lagrer bare et fingeravtrykk, så kopier den med en gang. Gi hver nøkkel et navn etter hva den skal brukes til, og trekk den tilbake når som helst. Innstillinger viser når hver nøkkel sist ble brukt.
• Slik sender du den: Authorization: Bearer pz_… på hver forespørsel.
• Omfang: én nøkkel leser og legger til i alle merkevarene i teamet ditt.
• Grense: 120 forespørsler i minuttet per nøkkel.
• Sider: GET /creators og GET /posts returnerer 100 om gangen, eller opptil 500 med &limit=. Når det finnes flere, har svaret en next_cursor: send den tilbake som &cursor= for neste side. Den er null på siste side.
• Format: JSON inn og ut. ID-er er strenger, og datoer er ISO 8601.

Endepunkter

Hva en skaper og et innlegg inneholder

En skaper kommer med navn, e-post, kontoer (og om hvert brukernavn ble funnet), rabattkoder, status og hver gave: produktet og resten av pakken, kampanjen, datoene for sending og levering, fristen i dager, sporingsnummer, honorar, ønskede innlegg og innlegg så langt.

Et innlegg er én video, med hver plattform den ble lagt ut på: lenke, bildetekst, postedato og om den tagget deg. Deretter gaven og produktet den teller for, og hvordan Pozto avgjorde det. Så videosjekken: om produktet ditt ble funnet, hvert øyeblikk i bildet i sekunder, hver gang det ble sagt med sitat, og en kort oppsummering. Og reklamemerkingen: tydelig, svak eller ingen, med begrunnelse.

Legge til skapere og innlegg

POST /creators tar brand_id og handles: @navn, profillenker eller lenker i Linktree-stil, opptil seks. Den tar også platform, name, email, codes, product (en id eller et navn; et nytt navn legger til produktet), shipped_at, delivered_at, due_days (21 hvis du utelater det) og tracking. En skaper som allerede står på listen, gjenkjent på en av kontoene eller e-posten, får gaven i stedet for et duplikat. Den svarer 201 for en ny skaper og 200 for en eksisterende, med skaperens id og gavens id.

POST /posts tar brand_id og url, og eventuelt creator_id og product_id. Innlegget legges under den som eier kontoen, legges til på listen din hvis vedkommende er ny, og settes i kø for videosjekken. Den svarer med om det var nytt, brukernavnet, plattformen og om det teller som et innlegg om deg.

# Creators who are late, in one brand
curl "https://pozto.co/api/v1/creators?brand_id=BRAND_ID&status=late" \
  -H "Authorization: Bearer pz_…"

# Add a creator and the gift you sent them
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"}'

# Posts since October 1, newest first
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01" \
  -H "Authorization: Bearer pz_…"

# The next page: the next_cursor from the answer before
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer pz_…"

Feil

En feil kommer tilbake som JSON med én enkel setning, som {"error": "…"}, og en 4xx-status:

• 400: innholdet er ikke JSON, eller et felt er ugyldig, for eksempel en leveringsdato fram i tid.
• 401: ingen nøkkel, eller en nøkkel som er feil eller tilbakekalt.
• 403: teamet ditt er ikke på Brand-planen.
• 404: ingen merkevare med den brand_id i teamet ditt.
• 409: merkevaren er låst, fordi planen din har færre merkevarer enn teamet ditt bruker.
• 429: mer enn 120 forespørsler i løpet av ett minutt.

Hva API-et ikke gjør

• Ikke influencersøk. Det leser og legger til i din egen liste. Å søke etter skapere gjør du med Finn skapere, i appen.
• Ingen visninger, likes eller EMV i svarene. De finnes i appen fra Starter, og i den ukentlige rapporten. Se influencerrapportering.
• Ingen webhooks. For å hente nye innlegg spør du GET /posts med since.
• Ingen endringer eller sletting. API-et leser og legger til. Endringer og fjerning gjøres i appen.
• Ingen personlige nøkler. Nøklene tilhører teamet, og bare eieren lager dem.

Innholdet i innleggene er det samme som i appen: Pozto finner innlegg ved å se på videoen, bilder, lyd og bildetekst, så utaggede innlegg kommer også med. Influencersporing forklarer hvordan innlegg blir funnet.

Priser

API-et følger med Brand-planen: $999 i måneden, eller $799 i måneden ved årlig betaling, med 10 merkevarer, 1 000 aktive skapere, ubegrenset antall brukere og single sign-on. Alt annet i Pozto starter på lavere planer, og gratisplanen dekker dine første 10 skapere. Se planene.