API документация · /yandex/audience · 37 документов

API Яндекс Аудиторий: Сегменты, look-alike и доступы

Создание сегментов через API: из файла и CSV, из Метрики и AppMetrica, look-alike, геосегменты и пиксели; разрешения, представители, квоты и требования к данным. Ищите на сайте или подключите MCP-сервер к Claude Code и Cursor — каждый ответ со ссылкой на yandex.ru/dev/audience.

Искать в API Яндекс Аудиторий Подключить MCP

Попробуйте найти

Паспорт источника

Service ID: /yandex/audience
Источник: yandex.ru — официальная документация
Документов: 37
Состав: 28 методов · 9 страниц введения и справки
Проверка источника: 19.10.2026
Версия API: не подтверждена

yandex.ru/dev/audience/ru/

API Яндекс Аудиторий — один из 17 API в Bridge8. Тот же поиск и MCP-сервер работают для VK, Яндекса, Битрикс24, Авито и других:

Весь каталог: 25 источников →

Что включено

37 документов API Яндекс Аудиторий в одном поиске

Сохранённые копии yandex.ru. У каждого документа — ссылка на официальную страницу и дата импорта.

Введение и основы
8
Структура API, авторизация OAuth, вызов методов, форматы данных, квотирование, версии API, требования к данным, описание ошибок.
- Авторизация
- Квотирование
- Требования к данным
Управление сегментами
16
Создание из файла и CSV, сохранение, из Метрики и AppMetrica, look-alike, геосегменты, пиксельные сегменты; изменение, пересчёт и удаление.
- Создание сегмента из CSV-файла
- Сохранение сегмента из файла
- Сегмент с типом lookalike
Пиксели
5
Создание, изменение, удаление и восстановление пикселей, список пикселей.
- Создание пикселя
- Список пикселей
- Восстановление пикселя
Разрешения, представители, аккаунты
7
Разрешения на управление сегментом, представители аккаунта и список аккаунтов, представителем которых является пользователь.
- Создание разрешения
- Добавление представителя
- Список аккаунтов

С чего начать

Как создать сегмент из файла через API: пять шагов по документации

Коротко по официальной документации API Яндекс Аудиторий. Подробности каждого шага — в поиске Bridge8 или у вашего ИИ-агента.

Получите OAuth-токенЗарегистрируйте приложение в Яндекс OAuth с правами на создание и чтение сегментов. Токен передавайте в заголовке Authorization в каждом запросе.
Подготовьте файлНе менее 100 записей. Универсальный сегмент — CSV до 1 ГБ в UTF-8 или Windows-1251, названия колонок в первой строке; значения можно хешировать SHA-256.
Загрузите файлPOST /v1/management/segments/upload_csv_file — для типов данных crm и unified, для остальных — upload_file. В ответе — идентификатор сегмента.
Сохраните сегментPOST /v1/management/segment/{segmentId}/confirm: название, вид содержимого content_type и признак хеширования hashed.
Дождитесь обработкиСтатус processed означает, что загрузка и обработка завершены и сегмент готов для работы. Список сегментов — GET /v1/management/segments.

Квоты API

С одного IP-адреса: 30 запросов в секунду
На один user_login: 5000 запросов в сутки
Создание и изменение сегментов: 10 в минуту, 100 в час, 500 в сутки

При превышении API возвращает 429 Too Many Requests. Квота по user_login сбрасывается в полночь по московскому времени; ошибочные запросы тоже учитываются.

yandex.ru/dev/audience/ru/intro/quotas

Меньше 100 записей

Параметр check_size метода confirm позволяет сохранить такой сегмент, но для продвижения в Директе он недоступен, пока не превысит 100 записей.

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

Частые задачи: методы и руководства

Название ведёт на документ в поиске Bridge8, стрелка — на официальную страницу yandex.ru.

Методы API

7 из 28

Все 28 методов API в поиске

Введение и справка

6 из 9

Все 9 страниц введения и справки в поиске

Как использовать

Три способа работать с документацией API Яндекс Аудиторий

Без регистрации — на сайте. С регистрацией — через MCP-сервер прямо в Claude Code, Cursor или своём агенте.

01 · На сайте
Поиск без регистрации
Выберите API Яндекс Аудиторий в поиске и введите метод или задачу. Результаты — только из этого источника, со ссылкой на yandex.ru.
API Яндекс Аудиторий · 37 → универсальный сегмент unified
02 · ИИ-агент по MCP
Спросите Claude Code или Cursor
Агент сам находит сервис, ищет фрагменты и читает документ целиком. В ответе — ссылка на источник и дата импорта.
«Напиши на Python загрузку CRM-выгрузки (телефоны и email в SHA-256) в Яндекс Аудитории: upload_csv_file и confirm. Сверь методы с yandex.ru/dev/audience»
resolve_service → search_docs → get_document
03 · Документ целиком
Читайте страницу полностью
get_document отдаёт документ постранично: параметры, поля, примеры. Удобно, когда агенту нужна вся страница, а не фрагмент.
get_document → Создание сегмента из CSV-файла

Пример ответа · POST …/segments/create_lookalike

API Яндекс Аудиторий /yandex/audience

POST …/segments/create_lookalike

Создаёт сегмент типа lookalike с заданными параметрами — похожий на один из существующих сегментов.

Параметры

lookalike_linkinteger: Идентификатор сегмента, на который должен быть похож созданный сегмент.
lookalike_valueinteger: Степень «похожести»: принимает значения от 1 до 5.
maintain_device_distributionboolean: true — распределение пользователей по типу устройств сохраняется, если это возможно.

yandex.ru/dev/audience/ru/ref/openapi/segments/createLookalike

JSON · OAuthверсия не подтверждена

Подключение

Подключите документацию API Яндекс Аудиторий к ИИ-агенту

Один MCP-сервер Bridge8 — и агент знает API Яндекс Аудиторий и ещё 16 API: VK, Яндекс Директ, Битрикс24, Авито и другие. Доступ бесплатный, вход по коду из письма — без пароля.

Как подключить за минуту

Получите токенВойдите в личный кабинет по почте и создайте Bearer-токен.
Добавьте серверАдрес https://bridge8.ru/mcp, транспорт Streamable HTTP. В совместимых клиентах можно войти через OAuth.
Спросите про API Яндекс Аудиторий«Найди в API Яндекс Аудиторий, как создать look-alike-сегмент, и покажи ссылку на источник».

Получить токен

Только документация

Bridge8 не подключается к вашему аккаунту Аудиторий, не выдаёт и не хранит OAuth-токены, не загружает файлы и не создаёт сегменты. Агент получает документацию и сам пишет код.

Claude Code — команда

claude mcp add --transport http bridge8 \
  https://bridge8.ru/mcp \
  --header "Authorization: Bearer <TOKEN>"

JSON для --mcp-config

{
  "mcpServers": {
    "bridge8": {
      "type": "http",
      "url": "https://bridge8.ru/mcp",
      "headers": {
        "Authorization": "Bearer <TOKEN>"
      }
    }
  }
}

Инструменты сервера — в порядке вызова

resolve_serviceНаходит сервис и версию по названию: «VK API», «Директ», «Битрикс24».
search_docsИщет фрагменты внутри выбранного сервиса — до 10 за запрос.
get_documentЧитает документ целиком, постранично, со ссылкой на источник.

Вопросы

Вопросы о API Яндекс Аудиторий

Что можно делать через API Яндекс Аудиторий?

Управлять сегментами: создавать их из собственных данных, из Метрики и AppMetrica, по геолокации и на основе существующих (lookalike), изменять и удалять. Кроме того — пикселями, разрешениями на сегменты, представителями и аккаунтами. Пошаговой справки по интерфейсу Аудиторий в Bridge8 нет.

Как авторизоваться в API?

Получите OAuth-токен: зарегистрируйте приложение в Яндекс OAuth и выберите права на создание и изменение сегментов и на чтение их параметров. Токен передаётся для каждого метода в HTTP-заголовке Authorization, например Authorization: OAuth <токен>.

Какие квоты у API Аудиторий?

С одного IP-адреса — 30 запросов в секунду, на один user_login — 5000 в сутки; при превышении — 429 Too Many Requests. На создание и изменение сегментов любого типа: не больше 10 запросов в минуту, 100 в час и 500 в сутки. Ошибочные запросы учитываются в квотировании.

Какие требования к файлу с данными?

В файле должно быть не менее 100 записей. Универсальный сегмент — CSV до 1 ГБ в UTF-8 или Windows-1251, в первой строке названия колонок через запятую: phone, email, idfa_gaid, mac, client_id. Значения можно хешировать SHA-256, добавив суффикс _SHA256 к названию колонки.

Можно ли сохранить сегмент меньше 100 записей?

Да: параметр check_size метода confirm позволяет создавать сегменты меньше 100 записей. Но такие сегменты нельзя использовать для продвижения в Директе, пока их размер не превысит 100 записей.

Как сделать сегмент из цели Метрики?

Методом POST /v1/management/segments/create_metrika: в metrika_segment_type укажите goal_id (доступны также counter_id и segment_id), в metrika_segment_id — идентификатор объекта из Метрики. Для AppMetrica есть отдельный метод create_appmetrica.

Это официальный сайт Яндекс Аудиторий?

Нет. Bridge8 хранит копию официальной документации API yandex.ru/dev/audience для поиска и ИИ-агентов. У каждого фрагмента — ссылка на первоисточник и дата импорта; версия API не подтверждена.

Bridge8 может загрузить мой сегмент?

Нет. Bridge8 — документация для разработчиков: он не подключается к Аудиториям от вашего имени, не выдаёт и не хранит токены и не загружает файлы с данными клиентов.

Ещё в Bridge8

Один поиск и один MCP-сервер для 17 API, справки и курсов. Сервисы и версии ищутся раздельно и не смешиваются.

Другие API в Bridge8

16 API · 5 721 документ

Яндекс

7 API

VK и MAX

3 API

CRM, телефония, банк

3 API

Объявления и рассылки

3 API

Справка и курсы

8 источников

Справка Яндекс Директа, Справка Яндекс Метрики, Справка Яндекс Вебмастера, Справка Яндекс Вордстата, Справка VK Рекламы, Справка Авито Рекламы, Курсы Яндекса (ЯРД), Курсы VK Рекламы.

Каталог на главной

← На главную: поиск по всем источникам bridge8.ru/#catalog

API Яндекс Аудиторий: Сегменты, look-alike и доступы

37 документов API Яндекс Аудиторий в одном поиске

Введение и основы

Управление сегментами

Пиксели

Разрешения, представители, аккаунты

Как создать сегмент из файла через API: пять шагов по документации

Частые задачи: методы и руководства

Методы API

Введение и справка

Три способа работать с документацией API Яндекс Аудиторий

Поиск без регистрации

Спросите Claude Code или Cursor

Читайте страницу полностью

Подключите документацию API Яндекс Аудиторий к ИИ-агенту

Как подключить за минуту

Вопросы о API Яндекс Аудиторий

Что можно делать через API Яндекс Аудиторий?

Как авторизоваться в API?

Какие квоты у API Аудиторий?

Какие требования к файлу с данными?

Можно ли сохранить сегмент меньше 100 записей?

Как сделать сегмент из цели Метрики?

Это официальный сайт Яндекс Аудиторий?

Bridge8 может загрузить мой сегмент?

Связанные источники и все API

Другие API в Bridge8

Яндекс

VK и MAX

CRM, телефония, банк

Объявления и рассылки

Справка и курсы

Добавим документацию вашего API в Bridge8