Инфлуенсер API за ваше податке о поклонима.

Чему служи API

Намењен је особи из операција или програмеру који жели Pozto податке негде другде: у Airtable бази, складишту података, контролној табли или интерном алату. Или обрнуто: за додавање креатора из система који шаље ваше поклоне, да их нико не уноси двапут.

Ради са вашом листом, креаторима којима сте послали производ. То није база инфлуенсера за претрагу. Ако вам од инфлуенсер API-ја треба то, Pozto није прави избор.

Кључеви, основни URL и ограничења

• Основни URL: https://pozto.co/api/v1
• Кључеви: прави их власник тима у Подешавања → API, на плану Brand. Кључ почиње са pz_ и приказује се само једном: Pozto чува само отисак, па га тада копирајте. Сваки кључ именујте према намени и опозовите га кад год желите. Подешавања показују када је сваки кључ последњи пут коришћен.
• Слање: Authorization: Bearer pz_… у сваком захтеву.
• Опсег: један кључ чита и додаје у сваки бренд вашег тима.
• Ограничење броја захтева: 120 захтева у минуту по кључу.
• Странице: GET /creators и GET /posts враћају по 100, а са &limit= до 500. Када има још, одговор има next_cursor: пошаљите га назад као &cursor= за следећу страницу. На последњој страници је null.
• Формат: JSON на улазу и излазу. ID-јеви су стрингови, а датуми су у ISO 8601 формату.

Крајње тачке

Шта садрже креатор и објава

Креатор долази са именом, имејлом, налозима (и податком да ли је свако корисничко име пронађено), кодовима за попуст, статусом и сваким поклоном: производом и остатком пакета, кампањом, датумима слања и испоруке, роком у данима, бројем за праћење пошиљке, хонораром, траженим бројем објава и објавама до сада.

Објава је један видео, са сваком платформом на којој је објављен: линк, опис, датум објаве и да ли вас означава. Затим поклон и производ за који се рачуна и како је Pozto то одлучио. Затим провера видеа: да ли је ваш производ пронађен, сваки тренутак на екрану у секундама, сваки помен са цитатом и кратак сажетак. И означавање: јасно, слабо или никакво, са образложењем.

Додавање креатора и објава

POST /creators прима brand_id и handles: @имена, линкове ка профилима или линкове у стилу Linktree-а, до шест. Прима и platform, name, email, codes, product (id или назив; нови назив додаје производ), shipped_at, delivered_at, due_days (21 ако га изоставите) и tracking. Креатор који је већ на листи, препознат по било ком налогу или имејлу, добија поклон уместо дупликата. Одговара са 201 за новог креатора и 200 за постојећег, са id-јем креатора и id-јем поклона.

POST /posts прима brand_id и url, а опционо creator_id и product_id. Објава се заводи код власника налога, он се додаје на вашу листу ако је нов, а објава се ставља у ред за проверу видеа. Одговор садржи да ли је објава нова, корисничко име, платформу и да ли се рачуна као објава о вама.

# Креатори који касне, у једном бренду
curl "https://pozto.co/api/v1/creators?brand_id=BRAND_ID&status=late" \
  -H "Authorization: Bearer pz_…"

# Додајте креатора и поклон који сте му послали
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"}'

# Објаве од 1. октобра, од најновије
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01" \
  -H "Authorization: Bearer pz_…"

# Следећа страница: next_cursor из претходног одговора
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer pz_…"

Грешке

Грешка стиже као JSON са једном једноставном реченицом, на пример {"error": "…"}, и статусом 4xx:

• 400: тело захтева није JSON или поље није исправно, на пример датум испоруке у будућности.
• 401: нема кључа или је кључ погрешан или опозван.
• 403: ваш тим није на плану Brand.
• 404: у вашем тиму нема бренда са тим brand_id.
• 409: бренд је закључан јер ваш план има мање брендова него што тим користи.
• 429: више од 120 захтева у минуту.

Шта API не ради

• Нема претраге инфлуенсера. Чита и додаје у вашу листу. Претрага креатора је Пронађи креаторе, у апликацији.
• Нема прегледа, лајкова ни EMV-а у одговорима. Они су у апликацији од плана Starter и у недељном извештају. Погледајте извештавање о инфлуенсерима.
• Нема webhook-ова. За нове објаве позовите GET /posts са since.
• Нема измена ни брисања. API чита и додаје. Измене и уклањања се раде у апликацији.
• Нема личних кључева. Кључеви припадају тиму и прави их само власник.

Садржај објава је исти као у апликацији: Pozto проналази објаве гледајући видео, кадрове, звук и опис, па стижу и објаве без ознаке. Праћење инфлуенсера објашњава како се објаве проналазе.

Цене

API долази уз план Brand: $999 месечно или $799 месечно уз годишње плаћање, са 10 брендова, 1.000 активних креатора, неограниченим бројем корисника и јединственом пријавом (SSO). Све остало у Pozto-у почиње на нижим плановима, а бесплатни план покрива ваших првих 10 креатора. Погледајте планове.