API influencerów dla danych o Twoim giftingu.

Do czego służy API

Dla osoby z operacji lub programisty, który chce mieć dane Pozto gdzie indziej: w bazie Airtable, hurtowni danych, dashboardzie czy wewnętrznym narzędziu. Albo w drugą stronę: do dodawania twórców z systemu, który wysyła Twoje prezenty, żeby nikt nie wpisywał ich dwa razy.

Działa na Twojej własnej liście, czyli na twórcach, którym wysłałeś produkt. To nie jest baza influencerów do przeszukiwania. Jeśli tego oczekujesz od API dla influencer marketingu, Pozto nie jest dla Ciebie.

Klucze, bazowy URL i limity

• Bazowy URL: https://pozto.co/api/v1
• Klucze: tworzy je właściciel zespołu w sekcji Ustawienia → API, w planie Brand. Klucz zaczyna się od pz_ i jest pokazywany raz: Pozto przechowuje tylko jego odcisk, więc skopiuj go od razu. Nazwij każdy klucz według przeznaczenia i unieważnij go w dowolnej chwili. Ustawienia pokazują, kiedy każdy klucz był ostatnio używany.
• Przesyłanie: Authorization: Bearer pz_… w każdym żądaniu.
• Zakres: jeden klucz odczytuje i dodaje dane we wszystkich markach Twojego zespołu.
• Limit żądań: 120 żądań na minutę na klucz.
• Strony: GET /creators i GET /posts zwracają po 100 elementów, a z &limit= do 500. Gdy jest więcej, odpowiedź zawiera next_cursor: odeślij go jako &cursor=, aby pobrać następną stronę. Na ostatniej stronie ma wartość null.
• Format: JSON na wejściu i wyjściu. Identyfikatory są ciągami znaków, a daty w formacie ISO 8601.

Endpointy

Co zawiera twórca i post

Twórca zawiera imię, e-mail, konta (i czy każdą nazwę konta znaleziono), kody rabatowe, status i każdy prezent: produkt i resztę paczki, kampanię, daty wysyłki i doręczenia, termin w dniach, numer przesyłki, honorarium, oczekiwaną liczbę postów i dotychczasowe posty.

Post to jeden film ze wszystkimi platformami, na których się pojawił: link, opis, data publikacji i czy Cię oznaczył. Dalej prezent i produkt, do którego się liczy, oraz to, jak Pozto o tym zdecydowało. Potem sprawdzenie filmu: czy znaleziono Twój produkt, każdy moment na ekranie w sekundach, każde wypowiedzenie nazwy z cytatem i krótkie podsumowanie. I oznaczenie reklamy: wyraźne, słabe lub brak, z uzasadnieniem.

Dodawanie twórców i postów

POST /creators przyjmuje brand_id i handles: @nazwy, linki do profili lub linki w stylu Linktree, maksymalnie sześć. Przyjmuje też platform, name, email, codes, product (id lub nazwę; nowa nazwa dodaje produkt), shipped_at, delivered_at, due_days (21, jeśli pominiesz) i tracking. Twórca, który już jest na liście, dopasowany po dowolnym koncie lub e-mailu, dostaje prezent zamiast duplikatu. Odpowiada kodem 201 dla nowego twórcy i 200 dla istniejącego, z id twórcy i id prezentu.

POST /posts przyjmuje brand_id i url, a opcjonalnie creator_id i product_id. Post trafia do właściciela konta, który jest dodawany do Twojej listy, jeśli jest nowy, i czeka w kolejce na sprawdzenie filmu. Odpowiedź mówi, czy post był nowy, podaje nazwę konta, platformę i czy liczy się jako post o Tobie.

# Spóźnieni twórcy w jednej marce
curl "https://pozto.co/api/v1/creators?brand_id=BRAND_ID&status=late" \
  -H "Authorization: Bearer pz_…"

# Dodaj twórcę i wysłany mu prezent
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"}'

# Posty od 1 października, od najnowszych
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01" \
  -H "Authorization: Bearer pz_…"

# Następna strona: next_cursor z poprzedniej odpowiedzi
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer pz_…"

Błędy

Błąd wraca jako JSON z jednym prostym zdaniem, np. {"error": "…"}, i statusem 4xx:

• 400: treść nie jest JSON-em albo pole jest nieprawidłowe, np. data doręczenia w przyszłości.
• 401: brak klucza albo klucz błędny lub unieważniony.
• 403: Twój zespół nie ma planu Brand.
• 404: w Twoim zespole nie ma marki o tym brand_id.
• 409: marka jest zablokowana, bo Twój plan obejmuje mniej marek, niż używa zespół.
• 429: ponad 120 żądań w ciągu minuty.

Czego API nie robi

• Nie wyszukuje influencerów. Odczytuje i uzupełnia Twoją własną listę. Twórców wyszukujesz w aplikacji, w sekcji Znajdź twórców.
• Nie zwraca wyświetleń, polubień ani EMV. Są w aplikacji od planu Starter i w cotygodniowym raporcie. Zobacz raportowanie influencer marketingu.
• Nie ma webhooków. Nowe posty pobierzesz, wywołując GET /posts z parametrem since.
• Nie edytuje ani nie usuwa. API odczytuje i dodaje. Zmiany i usuwanie odbywają się w aplikacji.
• Nie ma kluczy osobistych. Klucze należą do zespołu i tworzy je tylko właściciel.

Zawartość postów jest taka sama jak w aplikacji: Pozto znajduje posty, oglądając film, klatki, dźwięk i opis, więc posty bez oznaczenia też trafiają do API. Jak posty są znajdowane, wyjaśnia strona o śledzeniu influencerów.

Cennik

API jest w planie Brand: $999 miesięcznie lub $799 miesięcznie przy płatności rocznej, z 10 markami, 1,000 aktywnych twórców, nieograniczoną liczbą użytkowników i jednokrotnym logowaniem (SSO). Wszystko inne w Pozto jest dostępne w niższych planach, a darmowy plan obejmuje pierwszych 10 twórców. Zobacz plany.