Eine Influencer-API für Ihre Gifting-Daten.

Wofür die API gedacht ist

Sie ist für die Ops-Person oder den Entwickler, die die Daten von Pozto woanders brauchen: in einer Airtable-Base, einem Data Warehouse, einem Dashboard, einem internen Tool. Oder umgekehrt: Creator aus dem System hinzufügen, das Ihre Geschenke verschickt, damit niemand sie zweimal eintippt.

Sie arbeitet mit Ihrer eigenen Liste, den Creatorn, denen Sie Produkte geschickt haben. Sie ist keine Influencer-Datenbank zum Durchsuchen. Wenn Sie das von einer Influencer-API erwarten, ist Pozto nicht das Richtige.

Keys, Basis-URL und Limits

• Basis-URL: https://pozto.co/api/v1
• Keys: Der Team-Owner erstellt sie unter Einstellungen → API, im Brand-Tarif. Ein Key beginnt mit pz_ und wird nur einmal angezeigt: Pozto speichert nur einen Fingerabdruck, kopieren Sie ihn also sofort. Benennen Sie jeden Key nach seinem Zweck und widerrufen Sie ihn jederzeit. In den Einstellungen sehen Sie, wann jeder Key zuletzt benutzt wurde.
• Mitsenden: Authorization: Bearer pz_… bei jeder Anfrage.
• Reichweite: Ein Key liest und ergänzt alle Marken Ihres Teams.
• Rate Limit: 120 Anfragen pro Minute und Key.
• Seiten: GET /creators und GET /posts liefern 100 auf einmal, mit &limit= bis zu 500. Gibt es mehr, enthält die Antwort einen next_cursor: Schicken Sie ihn als &cursor= zurück, um die nächste Seite zu erhalten. Auf der letzten Seite ist er null.
• Format: JSON rein und raus. IDs sind Strings, Datumsangaben im Format ISO 8601.

Endpunkte

Was ein Creator und ein Post enthalten

Ein Creator kommt mit Name, E-Mail, Konten (und ob jedes Handle gefunden wurde), Rabattcodes, Status und jedem Geschenk: das Produkt und der Rest des Pakets, die Kampagne, Versand- und Zustelldatum, die Frist in Tagen, Sendungsnummer, Honorar, gewünschte und bisherige Posts.

Ein Post ist ein Video, mit jeder Plattform, auf der es erschienen ist: Link, Caption, Postdatum und ob Sie getaggt wurden. Dann das Geschenk und Produkt, für das er zählt, und wie Pozto das entschieden hat. Dann der Video-Check: ob Ihr Produkt gefunden wurde, jeder Moment im Bild in Sekunden, jede Nennung mit Zitat und eine kurze Zusammenfassung. Und die Kennzeichnung: klar, schwach oder keine, mit Begründung.

Creator und Posts hinzufügen

POST /creators nimmt brand_id und handles: @Namen, Profillinks oder Linktree-artige Links, bis zu sechs. Außerdem platform, name, email, codes, product (eine ID oder ein Name; ein neuer Name legt das Produkt an), shipped_at, delivered_at, due_days (21, wenn Sie es weglassen) und tracking. Ein Creator, der schon auf der Liste steht – erkannt an einem seiner Konten oder seiner E-Mail –, bekommt das Geschenk, statt doppelt angelegt zu werden. Die Antwort ist 201 für einen neuen Creator und 200 für einen bestehenden, mit der ID des Creators und der ID des Geschenks.

POST /posts nimmt brand_id und url, optional creator_id und product_id. Der Post wird dem Inhaber des Kontos zugeordnet, der bei Bedarf neu auf Ihre Liste kommt, und für den Video-Check eingereiht. Die Antwort sagt, ob er neu war, nennt Handle und Plattform und ob er als Post über Sie zählt.

# Überfällige Creator einer Marke
curl "https://pozto.co/api/v1/creators?brand_id=BRAND_ID&status=late" \
  -H "Authorization: Bearer pz_…"

# Einen Creator und das verschickte Geschenk hinzufügen
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 seit dem 1. Oktober, neueste zuerst
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01" \
  -H "Authorization: Bearer pz_…"

# Die nächste Seite: der next_cursor aus der vorherigen Antwort
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer pz_…"

Fehler

Ein Fehler kommt als JSON mit einem einfachen Satz zurück, etwa {"error": "…"}, und einem 4xx-Status:

• 400: Der Body ist kein JSON, oder ein Feld ist ungültig, etwa ein Zustelldatum in der Zukunft.
• 401: Kein Key, oder ein falscher bzw. widerrufener Key.
• 403: Ihr Team ist nicht im Brand-Tarif.
• 404: Keine Marke mit dieser brand_id in Ihrem Team.
• 409: Die Marke ist gesperrt, weil Ihr Tarif weniger Marken umfasst, als Ihr Team nutzt.
• 429: Mehr als 120 Anfragen in einer Minute.

Was die API nicht kann

• Keine Influencer-Suche. Sie liest und ergänzt Ihre eigene Liste. Die Suche nach Creatorn heißt in der App „Creator finden“.
• Keine Views, Likes oder EMV in den Antworten. Die stehen ab Starter in der App und im Wochenbericht. Siehe Influencer-Reporting.
• Keine Webhooks. Neue Posts holen Sie mit GET /posts und since ab.
• Kein Bearbeiten oder Löschen. Die API liest und fügt hinzu. Änderungen und Löschungen passieren in der App.
• Keine persönlichen Keys. Keys gehören dem Team, und nur der Owner erstellt sie.

Die Posts enthalten dasselbe wie in der App: Pozto findet Posts, indem es das Video ansieht – Bilder, Ton und Caption –, deshalb kommen auch ungetaggte Posts mit. Wie Posts gefunden werden, erklärt Influencer-Tracking.

Preise

Die API ist im Brand-Tarif enthalten: $999 pro Monat oder $799 pro Monat bei jährlicher Zahlung, mit 10 Marken, 1,000 aktiven Creatorn, unbegrenzten Plätzen und Single Sign-on. Alles andere in Pozto gibt es schon in kleineren Tarifen, und der Free-Tarif deckt Ihre ersten 10 Creator ab. Tarife ansehen.