The structure and content of the reports are subject to change without prior notice.

For example, a new column may be added or the name of the sheet may be changed.

Marketing Account Report

Info

Console

The method is available for all models.

If you are using an API Key token, one of the accesses in the list is required to call the method

finance-and-accounting — View financial data and reports
all-methods — Full account management
all-methods:read-only — View all data

Starts the generation of the marketing account report.

You can find out the generation status and get a link to the finished report using a request. GET v2/reports/info/{reportId}.

Explanation of the report columns:

Sheet Полки (file advertiser_operations_shelf)

CSV column name	JSON column name	XLSX column name	Value type
DATE	date	Дата	string
SUM	sum	Сумма (с НДС), ₽	number
DEDUCTED_BONUSES	deductedBonuses	Списано бонусов	number
CAMPAIGN_NAME	campaignName	Кампания	string
SURFACE	surface	Площадки	string
OPERATION_TYPE	operationType	Тип операции	string
CABINET_TYPE	cabinetType	Тип кабинета	string
CABINET_NAME	cabinetName	Название кабинета	string

Sheet Буст продаж, оплата за показы (file advertiser_operations_cpm_boost)

CSV column name	JSON column name	XLSX column name	Value type
DATE	date	Дата	string
SUM	sum	Сумма (с НДС), ₽	number
DEDUCTED_BONUSES	deductedBonuses	Списано бонусов	number
CAMPAIGN_NAME	campaignName	Кампания	string
SURFACE	surface	Площадки	string
OPERATION_TYPE	operationType	Тип операции	string
CABINET_TYPE	cabinetType	Тип кабинета	string
CABINET_NAME	cabinetName	Название кабинета	string

Sheet Товарные баннеры (file advertiser_operations_product_banners)

CSV column name	JSON column name	XLSX column name	Value type
DATE	date	Дата	string
SUM	sum	Сумма (с НДС), ₽	number
DEDUCTED_BONUSES	deductedBonuses	Списано бонусов	number
CAMPAIGN_NAME	campaignName	Кампания	string
SURFACE	surface	Площадки	string
OPERATION_TYPE	operationType	Тип операции	string
CABINET_TYPE	cabinetType	Тип кабинета	string
CABINET_NAME	cabinetName	Название кабинета	string

Sheet Буст продаж, оплата за продажи (file advertiser_operations_cpa_auction_promotion)

CSV column name	JSON column name	XLSX column name	Value type
DATE	date	Дата	string
SUM	sum	Сумма (с НДС), ₽	number
DEDUCTED_BONUSES	deductedBonuses	Списано бонусов	number
CAMPAIGN_NAME	campaignName	Кампания	string
OPERATION_TYPE	operationType	Тип операции	string
CABINET_TYPE	cabinetType	Тип кабинета	string
CABINET_NAME	cabinetName	Название кабинета	string

Sheet Баннеры (бронирование) (file advertiser_operations_package_banners)

CSV column name	JSON column name	XLSX column name	Value type
DATE	date	Дата	string
SUM	sum	Сумма (с НДС), ₽	number
DEDUCTED_BONUSES	deductedBonuses	Списано бонусов	number
CAMPAIGN_NAME	campaignName	Кампания	string
SURFACE	surface	Площадки	string
OPERATION_TYPE	operationType	Тип операции	string
CABINET_TYPE	cabinetType	Тип кабинета	string
CABINET_NAME	cabinetName	Название кабинета	string

Sheet Баннеры (аукцион) (file advertiser_operations_auction_banners)

CSV column name	JSON column name	XLSX column name	Value type
DATE	date	Дата	string
SUM	sum	Сумма (с НДС), ₽	number
DEDUCTED_BONUSES	deductedBonuses	Списано бонусов	number
CAMPAIGN_NAME	campaignName	Кампания	string
SURFACE	surface	Площадки	string
OPERATION_TYPE	operationType	Тип операции	string
CABINET_TYPE	cabinetType	Тип кабинета	string
CABINET_NAME	cabinetName	Название кабинета	string

Sheet Баннеры кликаут (бронирование) (file advertiser_operations_package_banners_clickout)

CSV column name	JSON column name	XLSX column name	Value type
DATE	date	Дата	string
SUM	sum	Сумма (с НДС), ₽	number
DEDUCTED_BONUSES	deductedBonuses	Списано бонусов	number
CAMPAIGN_NAME	campaignName	Кампания	string
OPERATION_TYPE	operationType	Тип операции	string
CABINET_TYPE	cabinetType	Тип кабинета	string
CABINET_NAME	cabinetName	Название кабинета	string

Sheet Баннеры кликаут (аукцион) (file advertiser_operations_auction_banners_clickout)

CSV column name	JSON column name	XLSX column name	Value type
DATE	date	Дата	string
SUM	sum	Сумма (с НДС), ₽	number
DEDUCTED_BONUSES	deductedBonuses	Списано бонусов	number
CAMPAIGN_NAME	campaignName	Кампания	string
OPERATION_TYPE	operationType	Тип операции	string
CABINET_TYPE	cabinetType	Тип кабинета	string
CABINET_NAME	cabinetName	Название кабинета	string

Sheet Пуши (бронирование) (file advertiser_operations_package_pushes)

CSV column name	JSON column name	XLSX column name	Value type
DATE	date	Дата	string
SUM	sum	Сумма (с НДС), ₽	number
DEDUCTED_BONUSES	deductedBonuses	Списано бонусов	number
CAMPAIGN_NAME	campaignName	Кампания	string
SURFACE	surface	Площадки	string
OPERATION_TYPE	operationType	Тип операции	string
CABINET_TYPE	cabinetType	Тип кабинета	string
CABINET_NAME	cabinetName	Название кабинета	string

Sheet Пуши (аукцион) (file advertiser_operations_auction_pushes)

CSV column name	JSON column name	XLSX column name	Value type
DATE	date	Дата	string
SUM	sum	Сумма (с НДС), ₽	number
DEDUCTED_BONUSES	deductedBonuses	Списано бонусов	number
CAMPAIGN_NAME	campaignName	Кампания	string
SURFACE	surface	Площадки	string
OPERATION_TYPE	operationType	Тип операции	string
CABINET_TYPE	cabinetType	Тип кабинета	string
CABINET_NAME	cabinetName	Название кабинета	string

Sheet Поп-ап уведомления (бронирование) (file advertiser_operations_package_popups)

CSV column name	JSON column name	XLSX column name	Value type
DATE	date	Дата	string
SUM	sum	Сумма (с НДС), ₽	number
DEDUCTED_BONUSES	deductedBonuses	Списано бонусов	number
CAMPAIGN_NAME	campaignName	Кампания	string
SURFACE	surface	Площадки	string
OPERATION_TYPE	operationType	Тип операции	string
CABINET_TYPE	cabinetType	Тип кабинета	string
CABINET_NAME	cabinetName	Название кабинета	string

Sheet Поп-ап уведомления (аукцион) (file advertiser_operations_auction_popups)

CSV column name	JSON column name	XLSX column name	Value type
DATE	date	Дата	string
SUM	sum	Сумма (с НДС), ₽	number
DEDUCTED_BONUSES	deductedBonuses	Списано бонусов	number
CAMPAIGN_NAME	campaignName	Кампания	string
SURFACE	surface	Площадки	string
OPERATION_TYPE	operationType	Тип операции	string
CABINET_TYPE	cabinetType	Тип кабинета	string
CABINET_NAME	cabinetName	Название кабинета	string

Sheet Полки с оплатой по дням (file advertiser_operations_cpd_promotion)

CSV column name	JSON column name	XLSX column name	Value type
DATE	date	Дата	string
SUM	sum	Сумма (с НДС), ₽	number
CAMPAIGN_NAME	campaignName	Кампания	string
SURFACE	surface	Площадки	string
OPERATION_TYPE	operationType	Тип операции	string
CABINET_TYPE	cabinetType	Тип кабинета	string
CABINET_NAME	cabinetName	Название кабинета	string

Sheet Рекламные материалы (file advertiser_operations_marketing_promo_yandex_market)

CSV column name	JSON column name	XLSX column name	Value type
DATE	date	Дата	string
SUM	sum	Сумма (с НДС), ₽	number
SERVICE_TYPE	serviceType	Тип услуги	string
CAMPAIGN_NAME	campaignName	Кампания	string
OPERATION_TYPE	operationType	Тип операции	string
CABINET_TYPE	cabinetType	Тип кабинета	string
CABINET_NAME	cabinetName	Название кабинета	string

Sheet Реклама на внешних площадках (file advertiser_operations_marketing_promo_web)

CSV column name	JSON column name	XLSX column name	Value type
DATE	date	Дата	string
SUM	sum	Сумма (с НДС), ₽	number
SERVICE_TYPE	serviceType	Тип услуги	string
CAMPAIGN_NAME	campaignName	Кампания	string
OPERATION_TYPE	operationType	Тип операции	string
CABINET_TYPE	cabinetType	Тип кабинета	string
CABINET_NAME	cabinetName	Название кабинета	string

Sheet Реклама на внешних площадках-М (file advertiser_operations_marketing_promo_web_mark)

CSV column name	JSON column name	XLSX column name	Value type
DATE	date	Дата	string
SUM	sum	Сумма (с НДС), ₽	number
SERVICE_TYPE	serviceType	Тип услуги	string
CAMPAIGN_NAME	campaignName	Кампания	string
OPERATION_TYPE	operationType	Тип операции	string
CABINET_TYPE	cabinetType	Тип кабинета	string
CABINET_NAME	cabinetName	Название кабинета	string

Sheet ТВ реклама (file advertiser_operations_marketing_promo_tv)

CSV column name	JSON column name	XLSX column name	Value type
DATE	date	Дата	string
SUM	sum	Сумма (с НДС), ₽	number
SERVICE_TYPE	serviceType	Тип услуги	string
CAMPAIGN_NAME	campaignName	Кампания	string
OPERATION_TYPE	operationType	Тип операции	string
CABINET_TYPE	cabinetType	Тип кабинета	string
CABINET_NAME	cabinetName	Название кабинета	string

Sheet Рассылка по сегментам (file advertiser_operations_marketing_promo_mailing)

CSV column name	JSON column name	XLSX column name	Value type
DATE	date	Дата	string
SUM	sum	Сумма (с НДС), ₽	number
SERVICE_TYPE	serviceType	Тип услуги	string
CAMPAIGN_NAME	campaignName	Кампания	string
OPERATION_TYPE	operationType	Тип операции	string
CABINET_TYPE	cabinetType	Тип кабинета	string
CABINET_NAME	cabinetName	Название кабинета	string

Sheet Организация и проведение маркет (file advertiser_operations_marketing_promo_for_sales)

CSV column name	JSON column name	XLSX column name	Value type
DATE	date	Дата	string
SUM	sum	Сумма (с НДС), ₽	number
SERVICE_TYPE	serviceType	Тип услуги	string
CAMPAIGN_NAME	campaignName	Кампания	string
OPERATION_TYPE	operationType	Тип операции	string
CABINET_TYPE	cabinetType	Тип кабинета	string
CABINET_NAME	cabinetName	Название кабинета	string

Sheet Специальные размещения (file advertiser_operations_marketing_promo_adfox)

CSV column name	JSON column name	XLSX column name	Value type
DATE	date	Дата	string
SUM	sum	Сумма (с НДС), ₽	number
SERVICE_TYPE	serviceType	Тип услуги	string
CAMPAIGN_NAME	campaignName	Кампания	string
OPERATION_TYPE	operationType	Тип операции	string
CABINET_TYPE	cabinetType	Тип кабинета	string
CABINET_NAME	cabinetName	Название кабинета	string

Sheet Отзывы за баллы (file advertiser_operations_paid_opinion)

CSV column name	JSON column name	XLSX column name	Value type
DATE	date	Дата	string
SUM	sum	Сумма (с НДС), ₽	number
BRAND	brand	Бренд	string
CATEGORY	category	Категория	string
MODEL	model	Товар	string
MARKET_URL	marketUrl	Ссылка на Маркет	string

⚙️ Limit without subscription: 1 request per 2 minutes ⭐️ Limit with Medium subscription: 1 request per minute

Request

POST

https://api.partner.market.yandex.ru/v1/businesses/{businessId}/reports/marketing-detalization/generate

Path parameters

Name

Description

businessId

Type: integer

Cabinet ID. To find out, use the request GET v2/campaigns.

ℹ️ What is a cabinet and a store on the Market?

Min value: 1

Query parameters

Name

Description

format

Type: string

The format of the report or document. Report format:

FILE — the spreadsheet file (XLSX).
CSV — A ZIP archive with CSV files for each report sheet.
JSON — A ZIP archive with JSON files for each report sheet.

Default: FILE

Enum: FILE, CSV, JSON

Body

application/json

{
  "monthOfYear": {
    "year": 2025,
    "month": 12
  }
}

Name

Description

monthOfYear

Type: object

month

Type: integer

The month number.

Min value: 1

Max value: 12

year

Type: integer

Year.

Month and year.

Example

{
  "year": 2025,
  "month": 12
}

Responses

200 OK

In response, you receive an identifier that allows you to find out the generation status and download the finished report.

Body

application/json

{
  "status": "OK",
  "result": {
    "reportId": "example",
    "estimatedGenerationTime": 0
  }
}

Type: object

All of 2 types

Type: object
status

Type: string

The type of response. Possible values:

OK — There are no errors.

ERROR — an error occurred while processing the request.

Enum: OK, ERROR
The standard wrapper for server responses.
Example
```
{
  "status": "OK"
}
```

Type: object

result

Type: object

estimatedGenerationTime

Type: integer

Expected generation time in milliseconds.

reportId

Type: string

The ID that will be needed to track the generation status and receive the finished report or document.

Example: example

The ID that will be needed to track the generation status and receive the finished report or document.

Example

{
  "reportId": "example",
  "estimatedGenerationTime": 0
}

Example

{
  "result": {
    "reportId": "example",
    "estimatedGenerationTime": 0
  }
}

400 Bad Request

The request contains incorrect data. Learn more about errors in reports and documents

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

The type of response. Possible values:

OK — There are no errors.

ERROR — an error occurred while processing the request.

Enum: OK, ERROR
The standard wrapper for server responses.
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

The error code.

Example: example

message

Type: string

Description of the error.

Example: example

A list of errors.

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

A standard wrapper for server errors.

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

401 Unauthorized

The authorization data is not specified in the request. More information about the error

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

The type of response. Possible values:

OK — There are no errors.

ERROR — an error occurred while processing the request.

Enum: OK, ERROR
The standard wrapper for server responses.
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

The error code.

Example: example

message

Type: string

Description of the error.

Example: example

A list of errors.

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

A standard wrapper for server errors.

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

403 Forbidden

The authorization data is incorrect or access to the resource is prohibited. More information about the error

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

The type of response. Possible values:

OK — There are no errors.

ERROR — an error occurred while processing the request.

Enum: OK, ERROR
The standard wrapper for server responses.
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

The error code.

Example: example

message

Type: string

Description of the error.

Example: example

A list of errors.

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

A standard wrapper for server errors.

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

404 Not Found

The requested resource was not found. More information about the error

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

The type of response. Possible values:

OK — There are no errors.

ERROR — an error occurred while processing the request.

Enum: OK, ERROR
The standard wrapper for server responses.
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

The error code.

Example: example

message

Type: string

Description of the error.

Example: example

A list of errors.

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

A standard wrapper for server errors.

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

420 Method Failure

The resource access limit has been exceeded. More information about the error

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

The type of response. Possible values:

OK — There are no errors.

ERROR — an error occurred while processing the request.

Enum: OK, ERROR
The standard wrapper for server responses.
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

The error code.

Example: example

message

Type: string

Description of the error.

Example: example

A list of errors.

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

A standard wrapper for server errors.

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

500 Internal Server Error

Internal error of the Market. More information about the error

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

The type of response. Possible values:

OK — There are no errors.

ERROR — an error occurred while processing the request.

Enum: OK, ERROR
The standard wrapper for server responses.
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

The error code.

Example: example

message

Type: string

Description of the error.

Example: example

A list of errors.

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

A standard wrapper for server errors.

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Was the article helpful?

Report on convergence with closing documents

Impression Boost Report