Calling resources

You can access the API using GET or POST requests over HTTPS.

GET https://partner.yandex.ru/api/<resource>.<format>?lang=<response_language>&parameters=<other_request_parameters>
Authorization:<token>

Acceptable headers:

Name

Description

Accept

Resource format. Acceptable values:

  • text/xml, application/xml
  • text/json, application/json

Authorization

Data for authorization.

Parameters:

Parameter

Description

<resource>

The resource whose contents are being requested.

<format>

How to provide the response:

  • XML
  • JSON

The response format can be set in the HTTP Accept header.

Note

By default, the result is output in XML.

lang

Language for responses. Acceptable values:

  • ru — Russian
  • en — English

parameters

Other request parameters, which are listed in the resource descriptions.

POST https://partner.yandex.ru/api/<resource>.<format>
Authorization:<token>

Body of the POST request:

lang=<response_language>&parameters=<other_request_parameters>

Acceptable headers:

Name

Description

Accept

Resource format. Acceptable values:

  • text/xml, application/xml
  • text/json, application/json

Authorization

Data for authorization.

Parameters:

Parameter

Description

<resource>

The resource whose contents are being requested.

<format>

How to provide the response:

  • XML
  • JSON

The response format can be set in the HTTP Accept header.

Note

By default, the result is output in XML.

lang

Language for responses. Acceptable values:

  • ru — Russian
  • en — English

parameters

Other request parameters, which are listed in the resource descriptions.