Een influencer API voor je giftingdata.

Waar de API voor is

Hij is voor de ops-collega of developer die de data van Pozto ergens anders wil hebben: een Airtable-base, een datawarehouse, een dashboard, een interne tool. Of andersom: creators toevoegen vanuit het systeem dat je gifts verstuurt, zodat niemand ze twee keer hoeft in te typen.

Hij werkt met je eigen lijst, de creators naar wie je een product hebt gestuurd. Het is geen database van influencers om in te zoeken. Als je dat van een influencer API verwacht, dan is Pozto het niet.

Keys, base-URL en limieten

• Base-URL: https://pozto.co/api/v1
• Keys: de eigenaar van het team maakt ze aan via Instellingen → API, op het Brand-plan. Een key begint met pz_ en wordt één keer getoond: Pozto bewaart alleen een vingerafdruk, dus kopieer hem meteen. Geef elke key een naam naar zijn doel, en trek hem op elk moment in. Bij Instellingen zie je wanneer elke key voor het laatst is gebruikt.
• Meesturen: Authorization: Bearer pz_… bij elk verzoek.
• Bereik: één key leest en voegt toe bij elk merk van je team.
• Rate limit: 120 verzoeken per minuut per key.
• Pagina’s: GET /creators en GET /posts geven er 100 per keer terug, of maximaal 500 met &limit=. Als er meer zijn, bevat het antwoord een next_cursor: stuur die terug als &cursor= voor de volgende pagina. Op de laatste pagina is hij null.
• Formaat: JSON erin en eruit. Id’s zijn strings, en datums zijn ISO 8601.

Endpoints

Wat een creator en een post bevatten

Een creator komt met naam, e-mailadres, accounts (en of elke handle gevonden is), kortingscodes, status en elke gift: het product en de rest van het pakket, de campagne, verzend- en leverdatum, de deadline in dagen, het trackingnummer, de vergoeding, het gewenste aantal posts en de posts tot nu toe.

Een post is één video, met elk platform waarop hij verscheen: link, caption, postdatum en of je getagd bent. Daarna de gift en het product waarvoor hij telt, en hoe Pozto dat bepaalde. Dan de videocheck: of je product gevonden is, elk moment in beeld in seconden, elke keer dat het genoemd werd met het citaat, en een korte samenvatting. En de disclosure: duidelijk, zwak of geen, met de reden.

Creators en posts toevoegen

POST /creators neemt brand_id en handles: @namen, profiellinks of Linktree-achtige links, maximaal zes. Daarnaast platform, name, email, codes, product (een id of een naam; een nieuwe naam voegt het product toe), shipped_at, delivered_at, due_days (21 als je het weglaat) en tracking. Een creator die al op de lijst staat, herkend aan een van zijn accounts of zijn e-mailadres, krijgt de gift erbij in plaats van een dubbele vermelding. Het antwoord is 201 voor een nieuwe creator en 200 voor een bestaande, met het id van de creator en het id van de gift.

POST /posts neemt brand_id en url, en optioneel creator_id en product_id. De post wordt ingedeeld bij wie het account bezit, op je lijst gezet als het om een nieuwe creator gaat, en in de wachtrij gezet voor de videocheck. Het antwoord vertelt of hij nieuw was, de handle, het platform en of hij telt als een post over jou.

# 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_…"

Foutmeldingen

Een fout komt terug als JSON met één gewone zin, zoals {"error": "…"}, en een 4xx-status:

• 400: de body is geen JSON, of een veld is ongeldig, zoals een leverdatum in de toekomst.
• 401: geen key, of een key die fout of ingetrokken is.
• 403: je team zit niet op het Brand-plan.
• 404: geen merk met die brand_id in je team.
• 409: het merk is vergrendeld, omdat je plan minder merken heeft dan je team gebruikt.
• 429: meer dan 120 verzoeken in een minuut.

Wat de API niet doet

• Geen influencers zoeken. Hij leest je eigen lijst en voegt eraan toe. Creators zoeken doe je met Creators vinden, in de app.
• Geen views, likes of EMV in de antwoorden. Die staan in de app vanaf Starter, en in het wekelijkse rapport. Zie influencer rapportage.
• Geen webhooks. Om nieuwe posts op te halen, vraag je GET /posts op met since.
• Geen wijzigingen of verwijderingen. De API leest en voegt toe. Wijzigen en verwijderen doe je in de app.
• Geen persoonlijke keys. Keys horen bij het team, en alleen de eigenaar maakt ze aan.

Wat in de posts staat, is hetzelfde als in de app: Pozto vindt posts door de video te bekijken, beelden, audio en caption, dus niet-getagde posts komen ook mee. Influencer tracking legt uit hoe posts gevonden worden.

Prijzen

De API hoort bij het Brand-plan: $999 per maand, of $799 per maand bij jaarlijkse betaling, met 10 merken, 1.000 actieve creators, onbeperkt gebruikers en single sign-on. Al het andere in Pozto begint op lagere plannen, en het gratis plan dekt je eerste 10 creators. Bekijk de plannen.