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 наведнъж или до 500 с &limit=. Когато има още, отговорът съдържа next_cursor: изпратете го обратно като &cursor= за следващата страница. На последната страница е null.
• Формат: JSON на входа и изхода. Идентификаторите са низове, а датите са в 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 и в седмичния отчет. Вижте отчетите за инфлуенсъри.
• Няма webhooks. За да вземете новите публикации, извикайте GET /posts със since.
• Няма редакции или изтривания. API-то чете и добавя. Промените и премахванията стават в приложението.
• Няма лични ключове. Ключовете принадлежат на екипа и само собственикът ги създава.

Съдържанието на публикациите е същото като в приложението: Pozto намира публикациите, като гледа видеото, кадрите, звука и описанието, така че и публикациите без таг минават. Проследяването на инфлуенсъри обяснява как се намират публикациите.

Цени

API-то идва с плана Brand: $999 на месец или $799 на месец при годишно плащане, с 10 марки, 1,000 активни креатори, неограничени потребители и единен вход (SSO). Всичко останало в Pozto започва от по-ниски планове, а безплатният план покрива първите ви 10 креатори. Вижте плановете.