> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Журнал изменений

> Последние обновления и история релизов платформы Pubrio.

Следите за эволюцией слоя данных Pubrio.

## Релизы 2026 года

<AccordionGroup>
  <Accordion title="v2.3.2 - Проход по справочнику фильтров поиска (сентябрь 2026)" defaultOpen>
    * **Новое:** [Перечисления и константы](/ru/api-reference/enums) — каждое фиксированное значение, которое принимает или возвращает API, на одной странице: уровни опыта, функции вакансий, источники и форматы рекламы, уровни охвата, платформы издателей, типы сигналов, уровни управления.
    * **Новое:** руководства по поиску для [Job Search](/ru/developer-guides/search/job-search), [News Search](/ru/developer-guides/search/news-search) и [Advertisement Search](/ru/developer-guides/search/advertisement-search) — таблицы фильтров, разборы ответов и рецепты для копирования.
    * **API:** Job Search документирует `functions`, `seniority_ranks`, `launch_dates`, `location_ids`, `created_at` и `is_ascending_order`. Строки ответа теперь объявляют `functions`, `seniority_rank`, `source_type`, `base_salary`, `experience_requirement`, `education_requirement` и `employment_type`.
    * **API:** Advertisement Search документирует `active_dates`, `reach_tiers`, `exclude_source_types`, `created_at`, `advertisement_search_id` и `is_ascending_order`. Исправлено описание `source_types` — он фильтрует результаты (а не только обогащение) и принимает `tiktok` и `apple`. Строки теперь объявляют `advertisement_format_normalized`, `advertiser`, `advertisement_url`, `is_company_matched` и тройку `total_impressions`; `metadata` документирует `applied_source_types`, `unsupported_source_types`, `coverage_notes` и `skipped_source_types`.
    * **API:** News Search документирует `published_at`, `news_search_id` и `is_ascending_order`, и объявляет каждое поле строки, включая `expansion_signals` (возвращается, когда установлен `is_expansion_signal_available` — это отменяет удаление из v2.3.1, которое было сделано до появления флага).
    * **API:** People Search документирует `exclude_people_titles`, `exclude_people_locations`, `exclude_departments`, `exclude_department_functions` и `company_exclude_locations`.
    * **API:** Company Search документирует `social_media` и `advertisement_status`.
    * **API:** каждый эндпоинт поиска теперь документирует `metadata.ignored_fields` — нераспознанные ключи тела отбрасываются, а не отклоняются, и перечисляются там. Job, News и Advertisement Search также объявляют `pagination` и типизированный блок `metadata` вместо произвольного объекта.
    * **Документация:** четыре схемы (`job_exclude_locations`, `advertisement_target_locations`, `advertisement_exclude_target_locations` и `domain_search_ids` в Expansion Rankings) содержали описание рядом с `$ref`, которое OpenAPI 3.0 молча отбрасывает. Теперь они отображаются.
  </Accordion>

  <Accordion title="v2.3.1 - Проход по справочнику Expansion API (август 2026)">
    * **API:** **Expansion Signal Search** (`POST /expansions/signals/search`) теперь документирован — запрашивайте необработанные, датированные строки сигналов, стоящие за стадией компании, вместо компаний, в которые они сводятся.
    * **API:** **Expansion Lookup** (`POST /expansions/lookup`) теперь документирован — детерминированный аналог Expansion Search, который никогда не ослабляет ваши фильтры автоматически, для дашбордов и плановых заданий, которым нужны воспроизводимые результаты.
    * **API:** мониторы, отслеживающие `expansions`, теперь имеют документированный словарь фильтров и payload вебхука. [См. Настройка вебхуков](/ru/developer-guides/setting-up-webhooks).
    * **API:** `is_include_metadata` документирован в Company Expansion Detail, Compare, Summaries и Rankings. Трафик по API-ключу по умолчанию облегчён — установите `true`, чтобы получать `confidence_score` и полные детали модели.
    * **API:** коды ошибок экспансии (`40043`, `40360`, `40435`, `40436`) добавлены в [Коды состояния](/ru/api-reference/status-codes).
    * **Удалено:** справочные страницы `/companies/{jobs,news,advertisements}/export`. Export возвращает CSV-вложение по отдельному балансу `data_export_credit` и не возвращает ничего, что уже не возвращает соответствующий эндпоинт Search в виде JSON — используйте Search с пагинацией вместо этого.
    * **Удалено:** справочная страница `/people/enrichment`, документировавшая эндпоинт, который так и не был выпущен. Чтобы обогатить данные человека, вызовите [People Lookup](/ru/api-reference/endpoint/people/lookup) с `is_enrichment_available: true`.
    * **Документация:** `profile_id` удалён из каждого тела запроса. Ваш ключ API уже идентифицирует вашу рабочую область, и этот параметр игнорировался в запросах по ключу API.
    * **API:** поиск похожих компаний и похожих людей теперь документирует требуемый им референсный идентификатор. Ранее `/companies/search/similar` возвращал `41847 Missing parameter` для каждой документированной комбинации параметров.
    * **API:** [Company Enrichment](/ru/api-reference/endpoint/companies/enrichment) документирует массивы `jobs`, `news`, `advertisements` и `similar_companies`, которые он возвращает вместе с записью компании, и предупреждает, что вызов обычно занимает 30–60 секунд.
    * **API:** восемь эндпоинтов теперь объявляют возвращаемую ими `metadata` верхнего уровня, включая блок `profile` с `credit`, `topup_credit` и `total_credit_cost`.
    * **API:** эндпоинты идентификаторов компаний документируют все девять принимаемых идентификаторов, добавляя `tiktok_url`, `wantedly_url`, `tw104_url`, `rocketpunch_url`, `remember_url` и `youtrust_url`.
    * **Документация:** `41847 Missing parameter` — самая частая ошибка API — добавлена в [Коды состояния](/ru/api-reference/status-codes).
    * **Документация:** [Аутентификация](/ru/api-reference/authentication) теперь охватывает требование `User-Agent`. Клиенты с общим user agent блокируются на границе с `HTTP 403` и `error code: 1010`, что легко спутать с неверным ключом API.
    * **Документация:** [Лимиты запросов](/ru/api-reference/rate-limits) документирует поля использования и квоты, возвращаемые Profile Usage, включая то, как `total_max_*` применяет множитель лицензии.
    * **API:** фильтры экспансии (`stages`, `signal_types`, `signal_strengths`, `freshness`, `momentum`, `polarity`) теперь перечисляют допустимые значения, и каждый предупреждает, что нераспознанное значение молча отбрасывается, а не отклоняется — на одних параметрах это отбрасывает фильтр, на других — ничего не находит.
    * **API:** `momentum` принимает `advancing`, `steady` и `pulling_back`. Значения `directions` в Expansion Reference (`retreating`, `new`) — это значения ответа в `stage.direction` и никогда не были валидны как фильтр.
    * **API:** исправлен News Insights — `mentions`, `topics`, `sources` и `top_source` являются полями integer/string внутри `data.totals`, а не массивами верхнего уровня. `topics` и `sources` — это счётчики уникальных значений; списки по отдельным элементам находятся в `category_breakdown` и `market_breakdown`.
    * **API:** исправлен Advertisement Insights — `postings[]` использует сокращённые ключи `r`, `m`, `ch`, `fo`, `n`; `reach_tiers[]` — это каталог `{slug, label}` без счётчиков; `creatives[]` документирует все десять полей, включая `image_url`, `cta` и `has_video`.
    * **API:** ключи `parameters` шаблона канала варьируются в зависимости от `channel_type_slug` — шаблоны email, LinkedIn и Twilio несут разные наборы.
    * **Документация:** удалены поля ответа, которые API не возвращает: `referral_code` из User, `similarity_score` из Similar People, `funding_status` и `crunchbase_url` из LinkedIn Company Lookup, `expansion_signals` из News Search, и `occurs_at` / `occurs_until` из Expansion Signal Search.
    * **Документация:** таблица кодов состояния перестроена на основе таблицы ошибок API. Девять кодов были неверны: `40075`, `40076`, `40091`, `40092` и `40095` были документированы для ошибок пагинации и квоты, но на самом деле это `41675`, `41676`, `41691`, `41692` и `41695` с **HTTP 416** — и каждый документированный номер является действующим кодом для чего-то не связанного. `40003`, `40602` и `40603` на самом деле `40303`, `40632` и `40633`; `40099` не существует.
    * **Документация:** теперь документирован **HTTP 416**. Переполнения пагинации и квоты возвращают 416 с кодом `416xx`, а не усечённый набор результатов.
    * **Документация:** добавлено семейство ошибок мониторов (`40020`–`40035`), включая `40021` — `detection_mode` нельзя изменить после создания монитора.
    * **API:** `per_page` ограничен `max_search_per_page` вашего тарифа (25 на большинстве тарифов); `26` возвращает HTTP 416. `page` ограничен `max_search_page`. Оба лимита и все остальные потолки тарифа возвращаются [Profile](/ru/api-reference/endpoint/profile/profile) и теперь перечислены в [Лимиты запросов](/ru/api-reference/rate-limits).
    * **API:** `people_contact_types` принимает ровно `email-work`, `email-personal` и `phone`. Нераспознанное значение **не** отклоняется — возвращается HTTP 200 с `emails: null` и нулевой стоимостью в кредитах, что неотличимо от того, что у человека нет контактных данных.
    * **API:** ответы погашения возвращают `null`, а не `[]`, для `emails` и `phones`, когда ничего не найдено.
    * **API:** документированы параметры `create` шаблона канала — `channel_node_id` это UUID из Channel Template Types, и он определяет, какие ключи `parameters` валидны. `delete` принимает числовые значения `channel_template_id` и удаляет по одной версии за раз.
    * **API:** валидация вебхука монитора теперь выполняет реальную подписанную доставку; URL, отвечающий только на `GET`, всё равно завершается ошибкой, и `details` возвращает тело ответа от вышестоящего сервера.
  </Accordion>

  <Accordion title="v2.3.0 - Релиз Expansion (июль 2026)">
    * **Новая функция:** **Market Expansion API.** Отслеживайте, какие компании выходят на какие рынки и насколько далеко они продвинулись — лестница из четырёх стадий (Изучение → Закрепление → Расширение → Масштабирование), построенная на реальных сигналах найма, новостей, рекламы, облачной инфраструктуры и мероприятий. Ищите по коридору с помощью `froms` / `tos`, углубляйтесь в выход на рынок одной компании и сравнивайте аналогов. [Начните с краткого руководства](/ru/knowledge-base/concepts/expansion-api-quickstart).
    * **Новая функция:** **Поиск на естественном языке.** Передайте простой запрос на английском `query` в Expansion Search («fintech companies expanding into the UK»), и Pubrio интерпретирует его в фильтры — с опциональными AI-объяснениями совпадений, основанными на реальных сигналах каждой компании через `is_explain_match`.
    * **API:** результаты теперь по умолчанию сортируются в порядке релевантности, ставя подтверждённые движения (несколько независимых типов сигналов) первыми; передайте `sort_by: "recent"` для чистой хронологии.
    * **API:** мониторы теперь могут отслеживать **сигналы экспансии** (`signal_types: ["expansions"]`) наряду с вакансиями, новостями и рекламой, а монитор можно составить черновиком из простого предложения на английском через [Monitor Interpret](/ru/api-reference/endpoint/monitors/interpret).
    * **API:** жизненный цикл монитора теперь представлен единым полем `status` (`draft` / `active` / `paused` / `inactive`), заменяющим прежние булевы `is_active` / `is_paused` в запросах и ответах.
  </Accordion>

  <Accordion title="v2.2.0 - Релиз Monitor (апрель 2026)">
    * **Новая функция:** **Мониторы.** Автоматизированное обнаружение сигналов с доставкой в реальном времени — отслеживайте вакансии, новости компаний и рекламные кампании по миллионам компаний без построения собственного конвейера опроса. Определите фильтры один раз, и Pubrio сканирует, обогащает и доставляет подходящие сигналы на ваш вебхук, email или последовательность охвата.
    * **Новая функция:** **Два режима обнаружения.** Выбирайте между **Signal First** (широкое сканирование рынка) и **Company First** (отслеживание именованных аккаунтов), чтобы соответствовать вашему рабочему процессу поиска потенциальных клиентов.
    * **Новая функция:** **Автоматическое обогащение людьми.** Каждый триггер монитора может автоматически находить и погашать контакты в подходящих компаниях — многослойное обогащение с настраиваемыми фильтрами по уровню управления, отделу и должности.
    * **API:** добавлено 15 новых эндпоинтов Monitor — полный CRUD, статистика, графики, журналы обнаружения, валидация вебхуков и тестовая обработка. [См. справочник Monitor API](/ru/api-reference/endpoint/monitors/create).
    * **API:** `profile_id` больше не требуется в телах запросов. Ключ API теперь включает информацию о рабочей области. Параметр по-прежнему принимается для обратной совместимости.
    * **API:** добавлены `operationId`, `summary`, `description` и `tags` для всех 59 эндпоинтов API для улучшения совместимости с AI-агентами и MCP-инструментами.
    * **Документация:** включён `llms.txt` для обнаружения AI-краулерами.
  </Accordion>

  <Accordion title="v2.1.0 - Бета AI Smart List (февраль 2026)">
    * **Новая функция:** **AI Smart Lists (бета).** Теперь пользователи могут загружать CSV и просматривать их в интерфейсе таблицы, где Pubrio автоматически заполняет пропущенные столбцы.
    * **Данные:** добавлено 3 миллиона новых верифицированных сущностей в регионе DACH (Германия, Австрия, Швейцария).
    * **API:** более быстрое время ответа (задержка снижена на 200 мс) для эндпоинта `/enrich/company`.
  </Accordion>

  <Accordion title="v2.0.0 - Новогоднее обновление (январь 2026)">
    * **Новая функция:** **Ads Search Intelligence.** Теперь мы индексируем центры прозрачности рекламы и репозитории платного поиска. Теперь вы можете видеть, *запускает ли* компания рекламу, *куда* она тратит деньги и *на какие* ключевые слова таргетируется.
    * **Улучшение:** усовершенствовано обнаружение «технологического стека» для компаний, использующих нестандартное локализованное ПО в LATAM.
  </Accordion>
</AccordionGroup>

***

## Архив 2025 года: год партнёрств

2025 год был определён нашими крупными интеграциями с экосистемой, принёсшими данные Pubrio на платформы, которые вы используете каждый день.

<AccordionGroup>
  <Accordion title="Q4 2025 - Интеграции автоматизации">
    * **Интеграция:** **Ottokit.** Запущен нативный коннектор для рабочих процессов автономных агентов.
    * **Интеграция:** **Databar.** Pubrio добавлен как верифицированный провайдер в маркетплейс Databar для no-code исследований.
  </Accordion>

  <Accordion title="Q3 2025 - Синхронизация от дизайна к последовательности">
    * **Интеграция:** **Stripo.** Включена функциональность «Push to Sequence», позволяющая командам дизайна синхронизировать HTML-шаблоны напрямую с рабочими процессами Pubrio.
    * **Функция:** **Динамическая вставка переменных.** Позволила разрешать общие заполнители в шаблонах реальными данными Pubrio в реальном времени при отправке.
  </Accordion>

  <Accordion title="Q2 2025 - Партнёрство с Clay">
    * **Интеграция:** **Нативная интеграция с Clay.** Стали провайдером по умолчанию в меню обогащения Clay.
    * **Данные:** расширено покрытие «невидимых 70%» с включением 15 новых локальных реестров по Азиатско-Тихоокеанскому региону.
  </Accordion>
</AccordionGroup>
