Ett influencer-API för din giftingdata.

Vad API:et är till för

Det är till för driftsansvarig eller utvecklaren som vill ha Poztos data någon annanstans: en Airtable-bas, ett datalager, en instrumentpanel, ett internt verktyg. Eller tvärtom: att lägga till kreatörer från systemet som skickar dina gåvor, så att ingen skriver in dem två gånger.

Det arbetar med din egen lista, kreatörerna du har skickat produkter till. Det är ingen databas med influencers att söka i. Är det vad du behöver av ett influencer-API är Pozto fel val.

Nycklar, bas-URL och gränser

• Bas-URL: https://pozto.co/api/v1
• Nycklar: teamets ägare skapar dem under Inställningar → API, på Brand-planen. En nyckel börjar med pz_ och visas en gång: Pozto sparar bara ett fingeravtryck, så kopiera den då. Namnge varje nyckel efter vad den används till, och återkalla den när du vill. Inställningar visar när varje nyckel senast användes.
• Så skickar du den: Authorization: Bearer pz_… i varje anrop.
• Omfattning: en nyckel läser och lägger till i alla varumärken i ditt team.
• Anropsgräns: 120 anrop i minuten per nyckel.
• Sidor: GET /creators och GET /posts returnerar 100 åt gången, eller upp till 500 med &limit=. När det finns fler har svaret ett next_cursor: skicka tillbaka det som &cursor= för nästa sida. På sista sidan är det null.
• Format: JSON in och ut. Id:n är strängar och datum är ISO 8601.

Endpoints

Vad en kreatör och ett inlägg innehåller

En kreatör kommer med namn, mejladress, konton (och om varje användarnamn hittades), rabattkoder, status och varje gåva: produkten och resten av paketet, dess kampanj, datum för skickad och levererad, deadline i dagar, spårningsnummer, arvode, önskade inlägg och inlägg hittills.

Ett inlägg är en video, med varje plattform den publicerades på: länk, bildtext, publiceringsdatum och om den taggade dig. Sedan gåvan och produkten den räknas för, och hur Pozto kom fram till det. Sedan videokontrollen: om din produkt hittades, varje ögonblick i bild i sekunder, varje gång den nämndes med citatet, och en kort sammanfattning. Och reklammärkningen: tydlig, svag eller ingen, med varför.

Lägga till kreatörer och inlägg

POST /creators tar brand_id och handles: @namn, profillänkar eller länkar i Linktree-stil, upp till sex. Det tar också platform, name, email, codes, product (ett id eller ett namn; ett nytt namn lägger till produkten), shipped_at, delivered_at, due_days (21 om du utelämnar det) och tracking. En kreatör som redan finns på listan, matchad på något av sina konton eller sin mejladress, får gåvan i stället för en dubblett. Det svarar 201 för en ny kreatör och 200 för en befintlig, med kreatörens id och gåvans id.

POST /posts tar brand_id och url, och valfritt creator_id och product_id. Inlägget arkiveras under den som äger kontot, läggs till på din lista om personen är ny och köas för videokontrollen. Det svarar med om det var nytt, användarnamnet, plattformen och om det räknas som ett inlägg om dig.

# Kreatörer som är sena, i ett varumärke
curl "https://pozto.co/api/v1/creators?brand_id=BRAND_ID&status=late" \
  -H "Authorization: Bearer pz_…"

# Lägg till en kreatör och gåvan du skickade
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"}'

# Inlägg sedan 1 oktober, nyaste först
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01" \
  -H "Authorization: Bearer pz_…"

# Nästa sida: next_cursor från föregående svar
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer pz_…"

Fel

Ett fel kommer tillbaka som JSON med en enkel mening, som {"error": "…"}, och en 4xx-status:

• 400: innehållet är inte JSON, eller ett fält är ogiltigt, till exempel ett leveransdatum i framtiden.
• 401: ingen nyckel, eller en nyckel som är fel eller återkallad.
• 403: ditt team har inte Brand-planen.
• 404: inget varumärke med det brand_id i ditt team.
• 409: varumärket är låst, eftersom din plan har färre varumärken än ditt team använder.
• 429: fler än 120 anrop på en minut.

Vad API:et inte gör

• Ingen influencersökning. Det läser och lägger till i din egen lista. Att söka kreatörer görs i Hitta kreatörer, i appen.
• Inga visningar, likes eller EMV i svaren. De finns i appen från Starter, och i veckorapporten. Se influencerrapportering.
• Inga webhooks. För att hämta nya inlägg, anropa GET /posts med since.
• Inga ändringar eller borttagningar. API:et läser och lägger till. Ändringar och borttagningar görs i appen.
• Inga personliga nycklar. Nycklarna tillhör teamet, och bara ägaren skapar dem.

Innehållet i inläggen är detsamma som i appen: Pozto hittar inlägg genom att granska videon, bildrutor, ljud och bildtext, så otaggade inlägg kommer också med. Influencerbevakning förklarar hur inlägg hittas.

Priser

API:et ingår i Brand-planen: $999 i månaden, eller $799 i månaden vid årsbetalning, med 10 varumärken, 1 000 aktiva kreatörer, obegränsat antal användare och single sign-on. Allt annat i Pozto börjar på lägre planer, och gratisplanen täcker dina första 10 kreatörer. Se planer.