---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.ru/dev/direct/doc/en/concepts/overview.md
  - https://yandex.ru/dev/direct/doc/ru/concepts/overview.md
sourcePath: ru/dg/concepts/overview.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/ru/llms.txt

# Обзор API Директа версии 5

Программный интерфейс (API) Яндекс Директа предназначен для автоматизированного управления кампаниями. Через API внешние приложения добавляют и редактируют кампании, объявления, ключевые фразы, задают ставки, получают статистику показов и кликов.

## Структура API {#objects}

API Директа состоит из веб-сервисов. Каждый сервис имеет собственный URL.

Каждый сервис предназначен для работы с определенным классом объектов: например, сервис `AdGroups` предназначен для управления группами объявлений, `Ads` — объявлениями и т. д.

[Подробнее об объектах](https://yandex.ru/dev/direct/doc/ru/objects/objects.md)

Сервис предоставляет набор методов для выполнения различных операций с объектами. Как правило, сервис включает следующие методы:

- `add` — добавление объектов;
- `update` — изменение параметров объектов;
- `delete` — удаление объектов;
- `get` — получение параметров объектов.

Сервисы могут включать и другие, специфические для объекта методы. Например, метод `moderate` сервиса `Ads` для отправки объявлений на модерацию.

[Подробнее о методах](https://yandex.ru/dev/direct/doc/ru/best-practice/principles.md)

## Доступ к API {#access}

Подключение к API Директа и его использование является бесплатным.

Запросы к API выполняются приложением от имени пользователей Директа — рекламодателей и рекламных агентств. Для авторизации API использует протокол OAuth 2.0: в запросах необходимо указывать авторизационный токен.

Разработчик приложения, выполняющего запросы к API, должен его предварительно зарегистрировать.

[Подробнее о доступе](https://yandex.ru/dev/direct/doc/ru/concepts/access.md)

## Формат взаимодействия {#format}

Запросы к API выполняются по протоколу HTTPS методом POST. Авторизационный токен и другие специальные параметры передаются в HTTP-заголовке. Входные и выходные структуры данных передаются в теле запроса и ответа.

API Яндекс Директа поддерживает два формата взаимодействия: JSON и SOAP/XML.

[Подробнее о формате](https://yandex.ru/dev/direct/doc/ru/concepts/format.md)