---
metadata:
  - name: generator
    content: Diplodoc Platform v5.66.1
alternate:
  - https://yandex.com/dev/direct/doc/en/concepts/overview.md
  - https://yandex.com/dev/direct/doc/ru/concepts/overview.md
  - href: https://yandex.com/dev/direct/doc/ru/concepts/overview.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.com/dev/direct/doc/ru/llms.txt?revision=r22022696
    rel: describedby
sourcePath: ru/dg/concepts/overview.md
title: Обзор API Директа версии 5 — API Яндекс Директа
description: Программный интерфейс Яндекс Директа для автоматизированного управления кампаниями — структура API, веб-сервисы и методы, доступ и авторизация, форматы взаимодействия.
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/ru/llms.txt?revision=r22022696


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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