Погашение людей (People Redeem)

API Redeem People превращает people_search_id (или URL LinkedIn) в полный набор верифицированных контактов — рабочий email, личный email, телефон — для этого человека. Вы тратите кредиты только тогда, когда контактные данные действительно возвращены.

curl -X POST https://api.pubrio.com/redeem/people \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "people_search_id": "e37ccf38-ea8f-422e-9874-cb23b15e8fe4",
    "people_contact_types": ["email-work", "phone"]
  }'

Когда использовать Redeem

Используйте Redeem, когда вы уже знаете, кто этот человек, и вам нужны его контактные данные:

Вы выполнили People Search и хотите разблокировать контакты для найденных совпадений
У вас есть URL профиля LinkedIn, и вы хотите обратиться к этому человеку
У вас есть people_search_id из предыдущего ответа Pubrio

Если вместо этого у вас есть email или телефон, и вы хотите найти соответствующего человека, используйте People Contact Lookup — это обратное направление, 1 кредит за совпадение.

Три варианта

Эндпоинт	Когда использовать	Поведение
`POST /redeem/people`	По одному человеку за раз	Синхронно. Возвращает контакты в ответе.
`POST /redeem/people/batch`	2–N человек за один вызов	Асинхронно. Немедленно возвращает `redeem_query_id`.
`POST /redeem/people/batch/query`	Опрос результатов пакета	Возвращает полный набор результатов по завершении пакета.

Пакетный поток — правильный паттерн для любого рабочего процесса, управляемого списком — загрузки CSV, включение в последовательность, синхронизация с CRM — потому что он распараллеливает работу по разрешению контактов на стороне сервера.

Быстрый старт — одиночное погашение

curl -X POST https://api.pubrio.com/redeem/people \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "people_search_id": "e37ccf38-ea8f-422e-9874-cb23b15e8fe4",
    "people_contact_types": ["email-work", "phone"]
  }'

const res = await fetch("https://api.pubrio.com/redeem/people", {
  method: "POST",
  headers: {
    "pubrio-api-key": process.env.PUBRIO_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    people_search_id: "e37ccf38-ea8f-422e-9874-cb23b15e8fe4",
    people_contact_types: ["email-work", "phone"],
  }),
});
const { data } = await res.json();

import os, requests

res = requests.post(
    "https://api.pubrio.com/redeem/people",
    headers={"pubrio-api-key": os.environ["PUBRIO_API_KEY"]},
    json={
        "people_search_id": "e37ccf38-ea8f-422e-9874-cb23b15e8fe4",
        "people_contact_types": ["email-work", "phone"],
    },
)
data = res.json()["data"]

Ответ:

{
  "data": {
    "profile": {
      "credit": 450376,
      "topup_credit": 235237,
      "total_credit_cost": 15
    },
    "peoples": [
      {
        "people_search_id": "e37ccf38-ea8f-422e-9874-cb23b15e8fe4",
        "emails": [
          { "value": "[email protected]", "type": "email-work", "status": "Verified" }
        ],
        "phones": [
          { "value": "+15551234567", "type": "phone", "status": null }
        ]
      }
    ]
  }
}

profile отражает ваш баланс после списания и кредиты, которые стоил этот вызов, чтобы вы могли обновить счётчик в приложении без отдельного обращения к /profile/usage.

Идентификаторы

Вы можете определить человека для погашения двумя способами:

Идентификатор	Описание
`people_search_id`	UUID, возвращаемый любым эндпоинтом поиска/просмотра Pubrio. Самый дешёвый и надёжный вариант — без шага разрешения.
`linkedin_url`	URL профиля LinkedIn (например, `https://www.linkedin.com/in/jane-doe-123`). Pubrio сначала разрешает его в `people_search_id`; если профиль новый, это может включать одноразовый шаг внешнего обогащения.

people_contact_types — это контракт на то, что вы хотите получить обратно. Смешивайте любые из email-work, email-personal, phone — с вас взимается плата за каждый возвращённый тип, а не за каждый запрошенный. Запрос ["email-work", "phone"] и получение обратно только email-work оплачивает только email.

Массовое погашение (асинхронный паттерн)

Для более чем одного человека используйте пакетный поток. Он выполняет каждое погашение параллельно на стороне сервера и избегает затрат на обмен запрос-ответ для каждого вызова. Шаг 1 — отправка:

curl -X POST https://api.pubrio.com/redeem/people/batch \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "peoples": [
      "540574d1-ff74-475b-aea2-f8ae643b806d",
      "e37ccf38-ea8f-422e-9874-cb23b15e8fe4"
    ],
    "people_contact_types": ["email-work", "phone"]
  }'

{
  "data": {
    "redeem_query_id": "a046c1da-b3d4-4ca1-aca6-1dd8c8055701",
    "is_completed": false,
    "estimated_time": 6,
    "estimated_time_type": "second"
  }
}

Шаг 2 — опрос:

curl -X POST https://api.pubrio.com/redeem/people/batch/query \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "redeem_query_id": "a046c1da-b3d4-4ca1-aca6-1dd8c8055701" }'

Когда is_completed равно true, ответ содержит полный массив peoples с разрешёнными контактами и общей стоимостью пакета в кредитах.

Опрашивайте с периодичностью, указанной в estimated_time. Опрос чаще, чем указанная оценка, лишь расходует лишние обращения — работа ещё не завершена.

Стоимость в кредитах

Кредиты списываются за каждый возвращённый контакт, а не за запрос. Цены за запись:

Тип контакта	Кредиты за запись
`email-work` / `email-personal`	5
`phone`	10

Если у человека нет рабочего email и вы запросили только email-work, с вас за эту запись не взимается ничего. Если вы запросили и email, и телефон, и Pubrio вернул оба, с вас взимается плата за оба. Полную таблицу тарифов с расценками по тарифным планам см. отдельно.

Распространённые паттерны

Конвейер поиск → погашение

Выполните People Search, позвольте пользователю выбрать строки в вашем UI, затем отправьте выбранные people_search_id через /redeem/people/batch. Оплачивайте только то, что используется.

Поток вставки URL LinkedIn

Принимайте список URL LinkedIn из экспорта CRM или расширения браузера. Отправляйте их через /redeem/people (по одному) или постройте небольшую пакетную обёртку.

Включение в последовательность

Перед добавлением контактов в исходящую цепочку рассылки погашайте только email-work — это делает стоимость предсказуемой и подаёт доставляемые адреса вашему отправителю.

Обогащение CRM

Сопоставьте существующие записи CRM с people_search_id (через People Lookup), затем погашайте пакетно по расписанию.

FAQ

Будет ли с меня взята плата, если контакт не найден?

Нет. Кредиты списываются за каждую возвращённую запись. Если у человека нет доступного рабочего email, вы не платите за этот слот контакта — даже если вы его запросили.

Что если один и тот же человек дважды встречается в моём пакете?

Дубликаты дедуплицируются на стороне сервера. С вас взимается плата один раз.

Что происходит, если URL LinkedIn неизвестен Pubrio?

Pubrio выполняет одноразовое внешнее разрешение. Если профиль разрешается, применяется обычное ценообразование redeem. Если нет — кредиты не списываются.

Насколько свежи контактные данные?

Pubrio регулярно повторно верифицирует записи email и телефона. Каждый контакт сопровождается полем status (Verified, null и т.д.), чтобы вы могли фильтровать только верифицированные записи на своей стороне.

Могу ли я погасить только телефон, только email или только личный email?

Да — people_contact_types это массив. Передайте именно те типы, которые вам нужны; оплата взимается только за то, что возвращено.

Массово или по одному — когда выигрывает асинхронный паттерн?

Начиная примерно с 3 записей пакет выигрывает по задержке и по надёжности на запись. Пакетный эндпоинт выполняет внутреннее распараллеливание и параллелит любые шаги внешнего обогащения, поэтому пакет из 50 записей ближе к 5 секундам по настенному времени, чем 50 × время одного запроса-ответа.

Связанное

People Contact Lookup

Обратный поиск: найдите человека по email, телефону или имени + домену. 1 кредит за совпадение.

People Search

Найдите людей, соответствующих профилю (должность, локация, размер компании, технологии и т.д.).

People Lookup

Разрешите полный профиль одного человека из идентификатора — без разблокировки контактов.

Тарифы

Стоимость в кредитах по всем эндпоинтам, по уровню тарифа.

Мониторинг

Поиск

Фильтры

Люди

Экспансия

Погашение людей (People Redeem)

Когда использовать Redeem

Три варианта

Быстрый старт — одиночное погашение

Идентификаторы

Массовое погашение (асинхронный паттерн)

Стоимость в кредитах

Распространённые паттерны

Конвейер поиск → погашение

Поток вставки URL LinkedIn

Включение в последовательность

Обогащение CRM

FAQ

Связанное

People Contact Lookup

People Search

People Lookup

Тарифы

​Когда использовать Redeem

​Три варианта

​Быстрый старт — одиночное погашение

​Идентификаторы

​Массовое погашение (асинхронный паттерн)

​Стоимость в кредитах

​Распространённые паттерны

Конвейер поиск → погашение

Поток вставки URL LinkedIn

Включение в последовательность

Обогащение CRM

​FAQ

​Связанное

People Contact Lookup

People Search

People Lookup

Тарифы

Когда использовать Redeem

Три варианта

Быстрый старт — одиночное погашение

Идентификаторы

Массовое погашение (асинхронный паттерн)

Стоимость в кредитах

Распространённые паттерны

FAQ

Связанное