HTTP headers

Request headers

Authorization

Contains the OAuth token of the Yandex.Direct user that the API request is being made on behalf of.

Example:

Authorization: Bearer 0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f
Accept-Language

Language for response messages. The selected language is used when returning textual explanations for statuses of objects (campaigns, ads, and others), and for the texts of errors and warnings. The following languages are supported:

  • en — English
  • ru — Russian
  • en — English
  • uk — Ukrainian

Example:

Accept-Language: ru

If this header is omitted or contains a language that is not supported by the Yandex.Direct API, response messages are given in English.

Client-Login

The username of an advertiser who is a client of the advertising agency. This is required if the request is made by an agency.

Example:

Client-Login: agrom
Use-Operator-Units: true
Spend the agency's points, not the advertiser's, when making a request. See the section Restrictions. This header is only allowed in requests from an agency.

Request example

POST /json/v5/ads/ HTTP/1.1
Host: api.direct.yandex.com
Authorization: Bearer 0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f
Accept-Language: ru
Client-Login: agrom
Use-Operator-Units: true
Content-Type: application/json; charset=utf-8

{
  "method":"add",
  "params": {
    ...
  } 
}

Response headers

RequestId

Unique request ID (string) assigned by the Yandex.Direct API server. Returned for both successful and failed requests.

Please indicate this ID when contacting the Support service.

Example:

RequestId:8695244274068608439
Units

The number of points: 1) spent on executing the request; 2) available remainder of the daily limit; 3) the daily limit. See the section Restrictions.

Example:

Units: 10/20828/64000

Response example

HTTP/1.1 200 OK
Connection:keep-alive
Content-Type:application/json
Date:Fri, 28 Nov 2014 17:07:02 GMT
RequestId:8695244274068608439
Units: 10/20828/64000
Server:nginx
Transfer-Encoding:chunked

{
  "result": {
    ...
  }
}