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 на вході й виході. Ідентифікатори — рядки, дати — у форматі ISO 8601.

Ендпоінти

Що містять креатор і публікація

Креатор містить ім’я, email, акаунти (і чи знайдено кожен нікнейм), промокоди, статус і кожен подарунок: продукт і решту вмісту коробки, кампанію, дати відправлення й доставки, строк у днях, трек-номер, гонорар, скільки публікацій очікується і скільки вже є.

Публікація — це одне відео з кожною платформою, де воно вийшло: посилання, підпис, дата публікації і чи вас позначили. Далі — подарунок і продукт, до яких вона зараховується, і як Pozto це визначив. Потім перевірка відео: чи знайдено ваш продукт, кожен момент у кадрі в секундах, кожна згадка вголос із цитатою і короткий підсумок. І маркування: чітке, слабке чи відсутнє, з поясненням чому.

Додавання креаторів і публікацій

POST /creators приймає brand_id і handles: @нікнейми, посилання на профілі чи посилання типу Linktree, до шести. Також приймає platform, name, email, codes, product (id чи назва; нова назва додає продукт), shipped_at, delivered_at, due_days (21, якщо не вказати) і tracking. Креатор, який уже є в списку і збігається за будь-яким акаунтом чи email, отримує подарунок замість дубліката. Відповідь — 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 і в щотижневому звіті. Дивіться звітність з інфлюенсер-маркетингу.
• Немає вебхуків. Щоб отримати нові публікації, запитуйте GET /posts із since.
• Немає редагування чи видалення. API читає й додає. Зміни й видалення робляться в застосунку.
• Немає персональних ключів. Ключі належать команді, і створює їх лише власник.

Вміст публікацій такий самий, як у застосунку: Pozto знаходить публікації, переглядаючи відео — кадри, аудіо й підпис, тож публікації без позначки теж потрапляють сюди. Відстеження інфлюенсерів пояснює, як знаходять публікації.

Ціни

API входить у план Brand: $999 на місяць або $799 на місяць при оплаті за рік, із 10 брендами, 1,000 активних креаторів, необмеженою кількістю місць і єдиним входом (SSO). Усе інше в Pozto доступне на нижчих планах, а безкоштовний план охоплює перших 10 креаторів. Переглянути плани.