AdPump — Примеры JSON-запросов к API v5 Яндекс Директа

4 полных примера JSON-запросов к API v5 с заголовками и ответами.

Коротко: 4 примера: get, add campaign, add keywords, report.

← Каталог API Директа · Введение · Версии API · OAuth и доступ · Сервисы v5 · Лимиты и баллы · Ограничения · Кампании · Группы и объявления · Ключи и ставки · Минус-фразы и площадки · Отчёты · Песочница · Агентства · Ошибки · Автоматизация · Документация Яндекса

Содержание

campaigns.get
campaigns.add
keywords.add
Reports

Пример 1: campaigns.get

POST https://api.direct.yandex.com/json/v5/campaigns
Authorization: Bearer y0_AgAAAAAAexample_token
Accept-Language: ru
Content-Type: application/json; charset=utf-8

{

  "method": "get",

  "params": {

    "SelectionCriteria": {"States": ["ON"]},

    "FieldNames": ["Id", "Name", "State", "Status"],

    "Page": {"Limit": 10}

  }

}

--- Ответ 200 ---
{

  "result": {

    "Campaigns": [

      {"Id": 12345678, "Name": "Кампания поиск", "State": "ON", "Status": "ACCEPTED"}

    ]

  }

}

Пример 2: campaigns.add

POST https://api.direct.yandex.com/json/v5/campaigns
Authorization: Bearer y0_AgAAAAAAexample_token
Client-Login: my-client-login
Accept-Language: ru
Content-Type: application/json; charset=utf-8

{

  "method": "add",

  "params": {

    "Campaigns": [{

      "Name": "Тест API кампания",

      "StartDate": "2026-08-03",

      "TextCampaign": {

        "BiddingStrategy": {

          "Search": {"BiddingStrategyType": "HIGHEST_POSITION"},

          "Network": {"BiddingStrategyType": "SERVING_OFF"}

        }

      },

      "DailyBudget": {"Amount": 300000000, "Mode": "STANDARD"}

    }]

  }

}

--- Ответ 200 ---
{

  "result": {{

    "AddResults": [{{"Id": 87654321}}]

  }}

}

Пример 3: keywords.add + bids

POST https://api.direct.yandex.com/json/v5/keywords
Authorization: Bearer y0_AgAAAAAAexample_token
Client-Login: my-client-login
Accept-Language: ru

{

  "method": "add",

  "params": {

    "Keywords": [

      {"AdGroupId": 200001, "Keyword": "доставка цветов", "Bid": 12000000},

      {"AdGroupId": 200001, "Keyword": "!купить розы", "Bid": 10000000}

    ]

  }

}

--- Ответ 200 ---
{

  "result": {{

    "AddResults": [

      {{"Id": 300001, "Warnings": []}},

      {{"Id": 300002, "Warnings": []}}

    ]

  }}

}

Пример 4: Reports API (async)

POST https://api.direct.yandex.com/json/v5/reports
Authorization: Bearer y0_AgAAAAAAexample_token
Client-Login: my-client-login
Accept-Language: ru
Content-Type: application/json; charset=utf-8

{

  "params": {

    "SelectionCriteria": {},

    "FieldNames": ["Query", "CampaignName", "Clicks", "Cost"],

    "ReportName": "sq_report_example_001",

    "ReportType": "SEARCH_QUERY_PERFORMANCE_REPORT",

    "DateRangeType": "LAST_7_DAYS",

    "Format": "TSV",

    "IncludeVAT": "YES"

  }

}

--- Ответ 202 (retry-in: 30) ---
(повторить тот же запрос через 30 сек)

--- Ответ 200 (TSV) ---
"Query"	"CampaignName"	"Clicks"	"Cost"
"доставка цветов москва"	"Кампания поиск"	"45"	"1250.00"

Подробнее об асинхронном workflow: Отчёты.

Перейти в инструмент