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.

Эндпоинты

Что содержат креатор и пост

Креатор приходит с именем, почтой, аккаунтами (и найден ли каждый из них), промокодами, статусом и каждым подарком: продукт и остальное содержимое коробки, кампания, даты отправки и доставки, срок в днях, трек-номер, гонорар, сколько постов нужно и сколько уже есть.

Пост — это одно видео со всеми платформами, где оно вышло: ссылка, подпись, дата публикации и отметил ли креатор вас. Затем подарок и продукт, к которым он относится, и как 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 не делает

• Нет поиска инфлюенсеров. API читает ваш собственный список и добавляет в него. Поиск креаторов — это «Найти креаторов» в приложении.
• Нет просмотров, лайков и EMV в ответах. Они есть в приложении с Starter и в еженедельном отчёте. См. отчёты по инфлюенсерам.
• Нет вебхуков. Чтобы получать новые посты, запрашивайте GET /posts с параметром since.
• Нет изменения и удаления. API читает и добавляет. Изменения и удаления делаются в приложении.
• Нет личных ключей. Ключи принадлежат команде, и создаёт их только владелец.

В постах то же, что и в приложении: Pozto находит посты, просматривая видео — кадры, аудио и подпись, — поэтому посты без отметки тоже попадают в выдачу. Как находятся посты, объясняет страница об отслеживании инфлюенсеров.

Цены

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