# Pubrio Documentation: Russian Начало работы Документация API

> Pubrio API documentation — market expansion intelligence: detect when companies enter new markets via typed, dated signals across 200+ markets, with company & people enrichment, search, lookup, and real-time monitors. REST API reference, guides, and concept docs.

## Документация API

### Документация API

- [Обзор Pubrio API](https://docs.pubrio.com/ru/api-reference/introduction.md): Полный справочник REST API Pubrio — эндпоинты для обогащения данных компаний и людей, поиска, просмотра, погашения, мониторинга в реальном времени и многого другого.
- [Аутентификация](https://docs.pubrio.com/ru/api-reference/authentication.md): Аутентифицируйте запросы к Pubrio API с помощью заголовка `pubrio-api-key` — настройка, управление ключами и рекомендации по безопасности.
- [Лимит запросов](https://docs.pubrio.com/ru/api-reference/rate-limits.md): Лимит запросов для обеспечения стабильности и надёжности.
- [Коды состояния / Ошибки](https://docs.pubrio.com/ru/api-reference/status-codes.md): Pubrio использует HTTP-коды состояния и коды ошибок для обозначения результата ваших запросов.
- [Перечисления и константы](https://docs.pubrio.com/ru/api-reference/enums.md): Все фиксированные значения, которые принимает или возвращает Pubrio API — ранги должности, функции работы, источники и форматы объявлений, уровни охвата, типы сигналов, уровни менеджмента — на одной странице.
- [Logo API](https://docs.pubrio.com/ru/api-reference/logo-api.md): Бесплатный публичный поиск логотипов компаний по домену. Встраивайте логотипы компаний в вашу CRM, дашборды, маркетинговые страницы или цепочки рассылок с помощью простого URL — без ключа API.

### Конечные точки

#### Профиль (рабочая область)

- [Данные профиля](https://docs.pubrio.com/ru/api-reference/endpoint/profile/profile.md): Получить текущие данные профиля рабочей области, включая информацию о тарифном плане и настройки.
- [Использование профиля](https://docs.pubrio.com/ru/api-reference/endpoint/profile/profile-usage.md): Получить статистику использования кредитов и квот текущего профиля рабочей области.
- [Данные пользователя](https://docs.pubrio.com/ru/api-reference/endpoint/user/user.md): Получить сведения о текущем аутентифицированном пользователе.

#### Ключи API

- [Список журналов запросов API](https://docs.pubrio.com/ru/api-reference/endpoint/api-keys/logs.md): Получить постраничный список журналов запросов API для рабочей области. Каждая запись содержит сводку одного запроса, выполненного с `pubrio-api-key`, включая путь, метод, код состояния, длительность, размер ответа и стоимость в кредитах. Используйте эндпоинт [Look up log details](/api-reference/end…
- [Просмотр журнала запросов API](https://docs.pubrio.com/ru/api-reference/endpoint/api-keys/logs_lookup.md): Получить полное тело запроса, заголовки запроса, тело ответа и размер ответа для конкретной записи журнала запросов API. Используйте это, чтобы изучить, что было отправлено или возвращено для конкретного `query_log_id`, найденного через эндпоинт списка.
- [Ежедневное использование API](https://docs.pubrio.com/ru/api-reference/endpoint/api-keys/usage_daily.md): Получить ежедневную разбивку запросов API и израсходованных кредитов рабочей области за указанный диапазон дат. Ответ включает временной ряд по дням и ряд с разбивкой по эндпоинтам, подходящие для построения диаграмм использования.
- [Детализация использования API](https://docs.pubrio.com/ru/api-reference/endpoint/api-keys/usage_breakdown.md): Получить разбивку запросов API и израсходованных кредитов за указанный диапазон дат, сгруппированную как по отдельным ключам API (`by_key`), так и по эндпоинтам (`by_endpoint`). Полезно для выявления ключей с наибольшим трафиком и наиболее ресурсоёмких по кредитам эндпоинтов в рабочей области.

#### Обогащение данных

- [Обогащение при просмотре компании](https://docs.pubrio.com/ru/api-reference/endpoint/companies/enrichment.md): Обогащение данных о компании в реальном времени. Возвращает запись о компании вместе с недавними сигналами найма, публикаций в СМИ, рекламы и похожих компаний за один вызов.

#### Похожие компании

- [Поиск похожих компаний (Lookalike)](https://docs.pubrio.com/ru/api-reference/endpoint/companies/similar.md): **Устарело.** Используйте вместо этого `POST /companies/search/similar`. Тело запроса то же самое; результаты возвращаются в `data.lookalikes` вместе с объектом `data.pagination`.
- [Поиск похожих компаний](https://docs.pubrio.com/ru/api-reference/endpoint/companies/search_similar.md): Поиск компаний, похожих на образцовую компанию. Укажите ровно один единичный идентификатор (`domain_search_id`, `domain`, `linkedin_url` или другой `*_url`). Каждая строка содержит `similarity_score` от 0 до 1.
- [Поиск похожих людей](https://docs.pubrio.com/ru/api-reference/endpoint/people/search_similar.md): Поиск людей, похожих на образцового человека или должность. Укажите один образец (`people_search_id`, `linkedin_url`, `linkedin_urls`, `peoples` или `people_titles`). Каждый человек содержит `similarity_score` от 0 до 1. Образец лишь задаёт, что считать похожим; любой другой фильтр сужает результаты…

#### Просмотр

- [Просмотр компании](https://docs.pubrio.com/ru/api-reference/endpoint/companies/lookup.md): Получить подробную информацию о конкретной компании по её идентификатору поиска в Pubrio, домену или URL LinkedIn.
- [Просмотр похожих компаний (алиас)](https://docs.pubrio.com/ru/api-reference/endpoint/companies/similar_lookup.md): Устаревший псевдоним эндпоинта «Просмотр компании по идентификатору»: возвращает одну запись компании по её идентификатору поиска в Pubrio, домену или URL LinkedIn. Чтобы найти похожие компании, используйте «Поиск похожих компаний».
- [Просмотр вакансий компании](https://docs.pubrio.com/ru/api-reference/endpoint/companies/job_lookup.md): Получить данные о вакансиях конкретной компании по идентификатору поиска вакансий.
- [Просмотр новостей компании](https://docs.pubrio.com/ru/api-reference/endpoint/companies/news_lookup.md): Получить данные новостной статьи о конкретной компании по идентификатору поиска новостей.
- [Просмотр рекламы компании](https://docs.pubrio.com/ru/api-reference/endpoint/companies/advertisements_lookup.md): Получить данные о рекламе конкретной компании по идентификатору поиска рекламы. Ответ включает разрешённый `destination_url`, исходный `raw_link_url` и, для рекламы Meta, `publisher_platforms`.
- [Просмотр облачного следа компании](https://docs.pubrio.com/ru/api-reference/endpoint/companies/cloud_footprints_lookup.md): Возвращает одну запись облачного следа по идентификатору, вместе с облачными регионами, городами и недавней выборкой инфраструктуры. См. [руководство по поиску облачного следа](/ru/developer-guides/search/cloud-footprint-search).
- [Просмотр технологий компании](https://docs.pubrio.com/ru/api-reference/endpoint/companies/technology_lookup.md): Получить подробную информацию о конкретной технологии, используемой компаниями.
- [Просмотр данных о людях](https://docs.pubrio.com/ru/api-reference/endpoint/people/lookup.md): Получить подробную информацию о конкретном человеке по его идентификатору поиска в Pubrio или URL профиля LinkedIn.

#### Поиск

- [Поиск компаний](https://docs.pubrio.com/ru/api-reference/endpoint/companies/search.md): Поиск в базе данных Pubrio компаний, соответствующих заданным критериям, таким как отрасль, размер, местоположение и технологии.
- [Поиск вакансий компании](https://docs.pubrio.com/ru/api-reference/endpoint/companies/job_search.md): Поиск вакансий. См. [руководство по поиску вакансий](/en/developer-guides/search/job-search).
- [Поиск новостей компании](https://docs.pubrio.com/ru/api-reference/endpoint/companies/news_search.md): Поиск новостей о компаниях. См. [руководство по поиску новостей](/en/developer-guides/search/news-search).
- [Поиск рекламы компаний](https://docs.pubrio.com/ru/api-reference/endpoint/companies/advertisements_search.md): Поиск рекламы, размещённой компаниями. См. [руководство по поиску рекламы](/en/developer-guides/search/advertisement-search).
- [Поиск облачного следа компаний](https://docs.pubrio.com/ru/api-reference/endpoint/companies/cloud_footprints_search.md): Поиск по публичной облачной и хостинговой инфраструктуре компаний: какие провайдеры, страны и регионы они используют. Одна запись — одна компания у одного провайдера в одной стране. См. [руководство по поиску облачного следа](/ru/developer-guides/search/cloud-footprint-search).
- [Поиск людей](https://docs.pubrio.com/ru/api-reference/endpoint/people/search.md): Поиск в базе данных Pubrio людей, соответствующих заданным критериям, таким как должность, местоположение, компания и уровень.

#### Аналитика

- [Аналитика вакансий компании](https://docs.pubrio.com/ru/api-reference/endpoint/companies/job_insights.md): Агрегированные данные сигналов найма для компании за период: объём публикаций, распределение по уровням, топ функций/отделов/местоположений и еженедельный временной ряд.
- [Аналитика новостей компании](https://docs.pubrio.com/ru/api-reference/endpoint/companies/news_insights.md): Агрегированные данные новостных сигналов для компании за период: объём упоминаний, топ тем и источников, разбивка по категориям и рынкам, а также еженедельный временной ряд.
- [Аналитика рекламы компании](https://docs.pubrio.com/ru/api-reference/endpoint/companies/advertisements_insights.md): Агрегированные данные рекламных сигналов для компании за период: количество активных и запущенных объявлений, распределение по каналам и площадкам, примеры креативов, охват аудитории в виде распределения по уровням и еженедельный временной ряд. Охват указывается как распределение по уровням, а не в…
- [Аналитика облачного следа компании](https://docs.pubrio.com/ru/api-reference/endpoint/companies/cloud_footprints_insights.md): Облачный след одной компании за один вызов: итоги, ведущие провайдеры, страны и регионы, новые хосты по неделям, последние хосты и флаги изменений, на которые стоит реагировать. См. [руководство по аналитике облачного следа](/ru/developer-guides/search/cloud-footprint-insights).

#### Экспансия

- [Обзор экспансии](https://docs.pubrio.com/ru/api-reference/endpoint/expansions/dashboard.md): Ключевые показатели экспансии на уровне рынка — количество компаний по стадиям на каждом рынке и основные трансграничные потоки. Агрегированные данные, без постраничной навигации. Отвечает `408`, если запрос не успевает выполниться вовремя.
- [Поиск экспансии](https://docs.pubrio.com/ru/api-reference/endpoint/expansions/market_lookup.md): Поиск компаний, выходящих на один или несколько рынков, с использованием фирмографических фильтров и фильтров сигналов или запроса на естественном языке, с возможными пояснениями совпадений от ИИ, основанными на реальных сигналах каждой компании. Отправьте хотя бы один из параметров: `tos`, `froms`,…
- [Детали экспансии компании](https://docs.pubrio.com/ru/api-reference/endpoint/expansions/company_lookup.md): Подробный профиль экспансии для одной компании — текущая стадия, сигналы, присутствие на рынке и история переходов стадий — для одного рынка или агрегированно по всем рынкам.
- [Сравнение экспансий компаний](https://docs.pubrio.com/ru/api-reference/endpoint/expansions/company_compare.md): Сравнить масштаб экспансии нескольких компаний бок о бок, с возможным включением сопоставимых аналогов для целевой компании.
- [Пакетные сводки экспансии компаний](https://docs.pubrio.com/ru/api-reference/endpoint/expansions/company_summaries.md): Готовые к отображению сводки экспансии для пакета компаний, подготовленные для сравнения бок о бок без агрегации на стороне клиента.
- [События сигналов компании](https://docs.pubrio.com/ru/api-reference/endpoint/expansions/company_pulse_events.md): Обогащённая, постраничная детализация событий сигналов, определяющих экспансию отдельной компании.
- [Рейтинги экспансии](https://docs.pubrio.com/ru/api-reference/endpoint/expansions/company_markers.md): Облегчённый ранжированный список пар компания/рынок по показателю экспансии — подходит для отображения на карте или тепловой карте.
- [Поиск сигналов экспансии](https://docs.pubrio.com/ru/api-reference/endpoint/expansions/signal_search.md): Необработанные, постраничные строки сигналов экспансии — датированные подтверждающие данные, лежащие в основе стадии каждой компании, с указанием источника и URL подтверждения.

#### Погашение

- [Погашение людей — одиночное](https://docs.pubrio.com/ru/api-reference/endpoint/redeem/people.md): Списать кредиты для получения полных контактных данных (email, телефон) конкретного человека.
- [Погашение людей — массовое](https://docs.pubrio.com/ru/api-reference/endpoint/redeem/people/batch.md): Отправить пакетный запрос на получение контактных данных сразу для нескольких людей.
- [Погашение людей — статус массовой операции](https://docs.pubrio.com/ru/api-reference/endpoint/redeem/people/batch/query.md): Проверить статус и результаты ранее отправленного запроса на пакетное погашение.
- [Просмотр контактов — одиночный](https://docs.pubrio.com/ru/api-reference/endpoint/redeem/people/contact/lookup.md): Обратный поиск человека по email, телефону или имени и фамилии в сочетании с доменом или компанией. Возвращает `people_search_id` и базовые данные найденного человека, а также метаданные `match`, описывающие способ сопоставления. Списывает 1 кредит за каждое тарифицируемое совпадение.
- [Просмотр контактов — массовый](https://docs.pubrio.com/ru/api-reference/endpoint/redeem/people/contact/lookup/batch.md): Пакетная версия `/redeem/people/contact/lookup`. Отправьте до предельного размера пакета, установленного вашей подпиской, в одном запросе. Каждая запись в `peoples` принимает те же идентификаторы, что и тело запроса для одиночного просмотра. Списывает 1 кредит за каждое тарифицируемое совпадение. Ду…

#### LinkedIn

- [Просмотр компании по LinkedIn (в реальном времени)](https://docs.pubrio.com/ru/api-reference/endpoint/companies/linkedin_lookup.md): Получить данные о компании по URL страницы компании в LinkedIn. Предоставляет получение данных в реальном времени.
- [Поиск людей по LinkedIn (в реальном времени)](https://docs.pubrio.com/ru/api-reference/endpoint/people/linkedin_lookup.md): Получить данные о человеке по URL профиля LinkedIn. Предоставляет получение данных в реальном времени.

#### Каналы

##### Типы

- [Тип шаблона канала](https://docs.pubrio.com/ru/api-reference/endpoint/channels/types/template_types.md): Получить доступные типы каналов для шаблонов рассылок.

##### Шаблоны

- [Шаблоны каналов](https://docs.pubrio.com/ru/api-reference/endpoint/channels/templates/templates.md): Получить список всех шаблонов каналов для рассылок в рабочей области.
- [Создать шаблон канала](https://docs.pubrio.com/ru/api-reference/endpoint/channels/templates/create.md): Создать новый шаблон канала для рассылок с заданными параметрами.
- [Создать версию шаблона канала](https://docs.pubrio.com/ru/api-reference/endpoint/channels/templates/create_version.md): Создать новую версию существующего шаблона канала.
- [Установить шаблон канала по умолчанию](https://docs.pubrio.com/ru/api-reference/endpoint/channels/templates/default.md): Получить шаблон канала по умолчанию для рабочей области.
- [Просмотр шаблона канала](https://docs.pubrio.com/ru/api-reference/endpoint/channels/templates/lookup.md): Получить данные конкретного шаблона канала по идентификатору.
- [Обновить шаблон канала](https://docs.pubrio.com/ru/api-reference/endpoint/channels/templates/update.md): Обновить конфигурацию существующего шаблона канала.
- [Удалить шаблон канала](https://docs.pubrio.com/ru/api-reference/endpoint/channels/templates/delete.md): Удалить шаблон канала из рабочей области.

#### Мониторинг

- [Список мониторов](https://docs.pubrio.com/ru/api-reference/endpoint/monitors/monitors.md): Получить список всех мониторов в рабочей области.
- [Создание монитора](https://docs.pubrio.com/ru/api-reference/endpoint/monitors/create.md): Создать монитор данных: постоянно активное наблюдение, которое непрерывно выявляет важные для вас бизнес-сигналы — новые вакансии, новости, рекламу или движения по экспансии на рынки — среди заданных вами компаний и фильтров, обогащает каждое совпадение данными о компании и контактами и доставляет и…
- [Интерпретация монитора](https://docs.pubrio.com/ru/api-reference/endpoint/monitors/interpret.md): Предварительный просмотр монитора перед его созданием — превратите запрос на естественном языке (на любом языке) в проверенную **черновую** конфигурацию, которую можно просмотреть, скорректировать и затем отправить в [Create Monitor](/en/api-reference/endpoint/monitors/create). Этот вызов можно выпо…
- [Обновление монитора](https://docs.pubrio.com/ru/api-reference/endpoint/monitors/update.md): Обновить конфигурацию и правила обнаружения существующего монитора.
- [Дублирование монитора](https://docs.pubrio.com/ru/api-reference/endpoint/monitors/duplicate.md): Создать копию существующего монитора с той же конфигурацией.
- [Удаление монитора](https://docs.pubrio.com/ru/api-reference/endpoint/monitors/delete.md): Удалить монитор из рабочей области.
- [Просмотр монитора](https://docs.pubrio.com/ru/api-reference/endpoint/monitors/lookup.md): Получить подробную информацию о конкретном мониторе.
- [Раскрытие сигнатуры монитора](https://docs.pubrio.com/ru/api-reference/endpoint/monitors/signature_reveal.md): Получить секрет подписи вебхука для монитора.
- [Проверка вебхука монитора](https://docs.pubrio.com/ru/api-reference/endpoint/monitors/webhook_validate.md): Отправить подписанную тестовую полезную нагрузку на URL вебхука и сообщить, была ли она принята.

##### Статистика

- [Статистика монитора](https://docs.pubrio.com/ru/api-reference/endpoint/monitors/statistics.md): Получить общую статистику срабатываний мониторов по всей рабочей области. Параметр monitor_id отсутствует — показатели агрегируются по всем мониторам рабочей области (мониторы на основе списков наблюдения исключены).
- [Журналы статистики монитора](https://docs.pubrio.com/ru/api-reference/endpoint/monitors/statistics_logs.md): Получить постраничный список журналов обнаружения для конкретного монитора.
- [Просмотр записи журнала статистики монитора](https://docs.pubrio.com/ru/api-reference/endpoint/monitors/statistics_logs_lookup.md): Получить данные конкретной записи журнала обнаружения монитора.
- [График статистики монитора](https://docs.pubrio.com/ru/api-reference/endpoint/monitors/statistics_chart.md): Получить готовые для построения диаграмм временные ряды статистики монитора.

##### Обработка

- [Пробная обработка монитора](https://docs.pubrio.com/ru/api-reference/endpoint/monitors/process_try.md): Запустить сохранённый монитор по идентификатору либо запустить несохранённую разовую конфигурацию, передав её непосредственно в теле запроса; при указании monitor_id встроенные поля переопределяют сохранённый монитор для этого запуска.
- [Повтор обработки монитора](https://docs.pubrio.com/ru/api-reference/endpoint/monitors/process_retry.md): Повторить неудачный запуск обработки монитора.

#### Фильтры

- [Технологии](https://docs.pubrio.com/ru/api-reference/endpoint/technologies/technologies.md): Получить список технологий, доступных для фильтров поиска.
- [Категории технологий](https://docs.pubrio.com/ru/api-reference/endpoint/technologies/categories.md): Получить список категорий технологий для фильтрации.
- [Локации](https://docs.pubrio.com/ru/api-reference/endpoint/locations/locations.md): Получить список местоположений, доступных для фильтров поиска.
- [Размер компании](https://docs.pubrio.com/ru/api-reference/endpoint/company-size/company-size.md): Получить список категорий размера компании для фильтрации.
- [Уровни управления](https://docs.pubrio.com/ru/api-reference/endpoint/management-levels/management-levels.md): Получить список уровней управления и должностного стажа для фильтрации.
- [Отделы](https://docs.pubrio.com/ru/api-reference/endpoint/departments/departments.md): Получить список названий отделов для фильтрации.
- [Функция отдела](https://docs.pubrio.com/ru/api-reference/endpoint/departments/function.md): Получить список функций отделов для фильтрации.
- [Отрасли](https://docs.pubrio.com/ru/api-reference/endpoint/verticals/verticals.md): Получить список отраслей для фильтрации.
- [Категории отраслей](https://docs.pubrio.com/ru/api-reference/endpoint/verticals/vertical_categories.md): Получить список категорий отраслей для фильтрации.
- [Подкатегории отраслей](https://docs.pubrio.com/ru/api-reference/endpoint/verticals/vertical_sub_categories.md): Получить список подкатегорий отраслей для фильтрации.
- [Категории новостей](https://docs.pubrio.com/ru/api-reference/endpoint/news/categories.md): Получить список категорий новостных статей для фильтрации.
- [Галереи новостей](https://docs.pubrio.com/ru/api-reference/endpoint/news/galleries.md): Получить список галерей новостей для фильтрации.
- [Языки новостей](https://docs.pubrio.com/ru/api-reference/endpoint/news/languages.md): Получить список доступных языков для фильтрации новостей.
- [Фильтры экспансии](https://docs.pubrio.com/ru/api-reference/endpoint/expansions/types.md): Справочный каталог таксономии экспансии — стадии, типы сигналов, уровни силы, полярности, динамика и свежесть — используемый для интерпретации значений, возвращаемых другими эндпоинтами экспансии.

#### Прочее

- [Часовые пояса](https://docs.pubrio.com/ru/api-reference/endpoint/timezones/timezones.md): Получить список поддерживаемых часовых поясов.

## OpenAPI Specs

- [ru-openapi](/ru/api-reference/ru-openapi.json)