Et influencer-API til dine gifting-data.

Hvad API’et er til

Det er til den driftsansvarlige eller udvikleren, der vil have Poztos data et andet sted: i en Airtable-base, et data warehouse, et dashboard eller et internt værktøj. Eller den anden vej: at tilføje creators fra det system, der sender dine gaver, så ingen skal taste dem ind to gange.

Det arbejder på din egen liste, de creators, du har sendt produkter til. Det er ikke en database over influencere, du kan søge i. Hvis det er det, du har brug for fra et influencer-API, er Pozto ikke det rette.

Nøgler, base-URL og grænser

• Base-URL: https://pozto.co/api/v1
• Nøgler: teamets ejer opretter dem under Indstillinger → API på Brand-planen. En nøgle starter med pz_ og vises én gang: Pozto gemmer kun et fingeraftryk, så kopiér den med det samme. Giv hver nøgle et navn efter, hvad den bruges til, og tilbagekald den når som helst. Indstillinger viser, hvornår hver nøgle sidst blev brugt.
• Sådan sender du den: Authorization: Bearer pz_… på hver forespørgsel.
• Omfang: én nøgle læser og tilføjer til alle brands på dit team.
• Grænse: 120 forespørgsler i minuttet pr. nøgle.
• Sider: GET /creators og GET /posts returnerer 100 ad gangen eller op til 500 med &limit=. Når der er flere, har svaret et next_cursor: send det tilbage som &cursor= for at få næste side. Det er null på sidste side.
• Format: JSON ind og ud. Id’er er strenge, og datoer er ISO 8601.

Endpoints

Hvad en creator og et opslag indeholder

En creator kommer med navn, e-mail, konti (og om hvert brugernavn blev fundet), rabatkoder, status og hver gave: produktet og resten af pakken, dens kampagne, afsendelses- og leveringsdato, fristen i dage, trackingnummer, honorar, ønskede opslag og opslag indtil videre.

Et opslag er én video med hver platform, den blev lagt op på: link, billedtekst, postdato, og om den taggede dig. Dernæst den gave og det produkt, den tæller for, og hvordan Pozto afgjorde det. Så videotjekket: om dit produkt blev fundet, hvert øjeblik i billedet i sekunder, hver gang det blev sagt med citatet, og et kort resumé. Og oplysningen om samarbejde: tydelig, svag eller ingen, med begrundelse.

Tilføj creators og opslag

POST /creators tager brand_id og handles: @navne, profillinks eller Linktree-lignende links, op til seks. Den tager også platform, name, email, codes, product (et id eller et navn; et nyt navn tilføjer produktet), shipped_at, delivered_at, due_days (21, hvis du udelader den) og tracking. En creator, der allerede er på listen, genkendt på en af sine konti eller sin e-mail, får gaven i stedet for at blive oprettet to gange. Den svarer 201 for en ny creator og 200 for en eksisterende, med creatorens id og gavens id.

POST /posts tager brand_id og url og eventuelt creator_id og product_id. Opslaget arkiveres under den, der ejer kontoen, tilføjes til din liste, hvis de er nye, og sættes i kø til videotjekket. Den svarer med, om det var nyt, brugernavnet, platformen, og om det tæller som et opslag om dig.

# Creators, der er forsinkede, i ét brand
curl "https://pozto.co/api/v1/creators?brand_id=BRAND_ID&status=late" \
  -H "Authorization: Bearer pz_…"

# Tilføj en creator og den gave, du sendte
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"}'

# Opslag siden 1. oktober, nyeste først
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01" \
  -H "Authorization: Bearer pz_…"

# Næste side: next_cursor fra det forrige svar
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer pz_…"

Fejl

En fejl kommer tilbage som JSON med én enkel sætning, som {"error": "…"}, og en 4xx-status:

• 400: indholdet er ikke JSON, eller et felt er ugyldigt, f.eks. en leveringsdato i fremtiden.
• 401: ingen nøgle, eller en nøgle, der er forkert eller tilbagekaldt.
• 403: dit team er ikke på Brand-planen.
• 404: intet brand med det brand_id på dit team.
• 409: brandet er låst, fordi din plan har færre brands, end dit team bruger.
• 429: mere end 120 forespørgsler på et minut.

Det gør API’et ikke

• Ingen influencer-søgning. Det læser og tilføjer til din egen liste. Søgning efter creators sker i Find creators i appen.
• Ingen visninger, likes eller EMV i svarene. De findes i appen fra Starter og i den ugentlige rapport. Se influencer-rapportering.
• Ingen webhooks. For at hente nye opslag skal du spørge GET /posts med since.
• Ingen redigering eller sletning. API’et læser og tilføjer. Ændringer og fjernelser sker i appen.
• Ingen personlige nøgler. Nøgler tilhører teamet, og kun ejeren opretter dem.

Indholdet i opslagene er det samme som i appen: Pozto finder opslag ved at gennemgå videoen, billeder, lyd og billedtekst, så opslag uden tag kommer også med. Influencer-sporing forklarer, hvordan opslag bliver fundet.

Priser

API’et følger med Brand-planen: $999 om måneden, eller $799 om måneden ved årlig betaling, med 10 brands, 1,000 aktive creators, ubegrænsede brugere og single sign-on. Alt andet i Pozto starter på lavere planer, og den gratis plan dækker dine første 10 creators. Se planer.