---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.ru/dev/market/partner-api/doc/en/reference/reports/generateCompetitorsPositionReport.md
  - https://yandex.ru/dev/market/partner-api/doc/ru/reference/reports/generateCompetitorsPositionReport.md
  - https://yandex.ru/dev/market/partner-api/doc/zh/reference/reports/generateCompetitorsPositionReport.md
  - href: zh/reference/reports/generateCompetitorsPositionReport.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/market/partner-api/doc/zh/llms.txt

{% note warning "报告的结构及内容如有更改，恕不另行通知。" %}

例如，可以添加新列或更改工作表的名称。

{% endnote %}

<!-- source: zh/api/reports/generateCompetitorsPositionReport.md -->
<div class="openapi">

# 竞争地位报告

<!-- markdownlint-disable-file -->

{% list tabs %}

- Info

  
  <!-- source: zh/_auto/method_scopes/generateCompetitorsPositionReport.md -->
  **方法适用于模式：[FBY](https://yandex.ru/dev/market/partner-api/doc/zh/overview/fby.md), [FBS](https://yandex.ru/dev/market/partner-api/doc/zh/overview/fbs.md), [Express](https://yandex.ru/dev/market/partner-api/doc/zh/overview/express.md) 和 [DBS](https://yandex.ru/dev/market/partner-api/doc/zh/overview/dbs.md).**

  {% cut "**如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一**" %}

  * promotion — [商品推广](https://yandex.ru/dev/market/partner-api/doc/zh/_auto/scopes_summary/pages/promotion.md)
  * promotion:read-only — [查看商品推广信息](https://yandex.ru/dev/market/partner-api/doc/zh/_auto/scopes_summary/pages/promotion_read-only.md)
  * finance-and-accounting — [查看财务信息和报告](https://yandex.ru/dev/market/partner-api/doc/zh/_auto/scopes_summary/pages/finance-and-accounting.md)
  * all-methods — 全面管理账户
  * all-methods:read-only — 查看所有数据

  {% endcut %}
  <!-- endsource: zh/_auto/method_scopes/generateCompetitorsPositionReport.md -->
  
  
  开始生成指定期间的"竞争地位"报告。 [这是什么报告](https://yandex.ru/support2/marketplace/ru/analytics/competitors.html)
  
  您可以使用请求查找生成状态并获取指向已完成报告的链接。 [GET v2/reports/info/{reportId}](https://yandex.ru/dev/market/partner-api/doc/zh/reference/reports/getReportInfo.md).
  
  
  {% note info "Значение -1 в отчете" %}
  
  
  如果在列中的CSV文件 **POSITION** 它是-1，当天没有指定类别的物品的订单。
  
  
  {% endnote %}
  
  
  
  <!-- source: zh/_auto/reports/masterstat/competitors_position.md -->
  报告列说明：

  {% cut "表单**Конкурентная позиция**（文件**competitors_position**）" %}

  #|
  || **CSV中的列名** | **JSON中的列名** | **XLSX中的列名** | **值类型** ||
  || DAY | day | День | string ||
  || SELLERS_COUNT | sellersCount | Продавцов в категории | integer ||
  || POSITION | position | Ваша позиция | integer ||
  || TOTAL_GMV | totalGmv | Общий оборот в категории, ₽ | number ||
  || GMV | gmv | Ваш оборот в категории, ₽ | number ||
  || AVG_TOTAL_GMV | avgTotalGmv | Средний оборот в категории, ₽ | number ||
  || SHARE | share | Ваша доля, % | number ||
  || AVG_GMV_OF_TOP_FIVE_PERCENT_SELLERS | avgGmvOfTopFivePercentSellers | Средний оборот 5% лидеров, ₽ | number ||
  || NEAREST_COMPETITOR_GMV | nearestCompetitorGmv | Оборот ближайшего конкурента, ₽ | number ||
  |#

  {% endcut %}
  <!-- endsource: zh/_auto/reports/masterstat/competitors_position.md -->
  
  
  
  <!-- source: zh/_includes/common/report-data-period-400-days.md -->
  {% note warning "Ограничения по тарифному плану" %}


  数据上传期和同一时间生成的报告数量取决于您的数据计划:
  * **没有订阅或"轻"关税** — 最近90天的数据可用，并且一次可以生成1个报告
  * **"中等"关税** — 过去400天的数据可用，最多可同时生成10份报告。

  阅读更多关于卖家订阅的信息 [在市场对卖家的帮助](https://yandex.ru/support/marketplace/ru/marketing/subscription).


  {% endnote %}
  <!-- endsource: zh/_includes/common/report-data-period-400-days.md -->
  
  
  
  <!-- source: zh/_auto/method_limits/generateCompetitorsPositionReport.md -->
  |<div style="text-align: left;">**⚙️ 没有订阅的限制:** 1 请求 在 10 分钟<br>**⭐️ [使用中等订阅限制](https://yandex.ru/support/marketplace/ru/marketing/subscription):** 1 请求 在 6 分钟</div>|
  |-|
  <!-- endsource: zh/_auto/method_limits/generateCompetitorsPositionReport.md -->
  
  
  
  ## Request
  
  <div class="openapi__requests">
  
  <div class="openapi__request__wrapper" style="--method: var(--dc-openapi-methods-post);margin-bottom: 12px">
  
  <div class="openapi__request">
  
  POST {.openapi__method}
  ```text translate=no
  https://api.partner.market.yandex.ru/v2/reports/competitors-position/generate
  ```
  
  </div>
  
  </div>
  
  </div>
  
  ### Query parameters
  
  #|
  || **Name** | **Description** ||
  ||
  
  _format_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string
  
  报告或文档的格式。
  报告格式:
  
  * `FILE` — 电子表格文件（XLSX).
  * `CSV` — 每个报告表都有一个包含CSV文件的ZIP存档。
  * `JSON` — 每个报告表都有一个带有JSON文件的ZIP压缩包.
  
  
  _Default:_{.json-schema-reset .json-schema-value} `FILE`
  
  _Enum:_{.json-schema-reset .json-schema-value} `FILE`, `CSV`, `JSON`
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "businessId": 1,
    "categoryId": 0,
    "dateFrom": "2025-08-22",
    "dateTo": "2025-09-22"
  }
  ```
  
  {% endcut %}
  
  #|
  || **Name** | **Description** ||
  ||
  
  _businessId_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  **Type**: integer
  
  内阁ID。  
  
  
  
  _Min value:_{.json-schema-reset .json-schema-assertion} `1`
  {.table-cell}
  ||
  ||
  
  _categoryId_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  **Type**: integer
  
  的类别ID。
  {.table-cell}
  ||
  ||
  
  _dateFrom_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  **Type**: string&lt;date&gt;
  
  期的开始，包括在内。
  
  日期格式: `YYYY-MM-DD`.
  
  
  _Example:_{.json-schema-reset .json-schema-example} `2025-08-22`
  {.table-cell}
  ||
  ||
  
  _dateTo_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  **Type**: string&lt;date&gt;
  
  期结束，包括在内。
  
  日期格式: `YYYY-MM-DD`.
  
  
  _Example:_{.json-schema-reset .json-schema-example} `2025-09-22`
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  </div>
  
  ## Responses
  
  <div class="openapi__response__code__200">
  
  ## 200 OK
  
  作为响应，您会收到一个标识符，该标识符允许您查找生成状态并下载完成的报告。
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "result": {
      "reportId": "example",
      "estimatedGenerationTime": 0
    }
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
  - {% cut "**Type**: object" %}
  
    #|
    ||
  
    _status_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    响应的类型。
    可能的值:
    * `OK` — 没有错误。
    * `ERROR` — 处理请求时出错。
  
  
    _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    服务器响应的标准包装器。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK"
    }
    ```
  
    {% endcut %}
  
  - {% cut "**Type**: object" %}
  
    #|
    ||
  
    _result_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    {% cut "**Type**: object" %}
  
    #|
    ||
  
    _estimatedGenerationTime_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: integer
  
    预计生成时间以毫秒为单位。
    {.table-cell}
    ||
    ||
  
    _reportId_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    跟踪生成状态和接收完成的报告或文档所需的ID。
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    跟踪生成状态和接收完成的报告或文档所需的ID。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "reportId": "example",
      "estimatedGenerationTime": 0
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "result": {
        "reportId": "example",
        "estimatedGenerationTime": 0
      }
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__400">
  
  ## 400 Bad Request
  
  请求包含不正确的数据。 [有关错误的更多信息](https://yandex.ru/dev/market/partner-api/doc/zh/concepts/error-codes.md#400)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      响应的类型。
      可能的值:
      * `OK` — 没有错误。
      * `ERROR` — 处理请求时出错。
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      服务器响应的标准包装器。
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      的错误代码。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      错误的描述。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      错误列表。
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    服务器错误的标准包装器。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__401">
  
  ## 401 Unauthorized
  
  请求中未指定授权数据。 [有关错误的更多信息](https://yandex.ru/dev/market/partner-api/doc/zh/concepts/error-codes.md#401)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      响应的类型。
      可能的值:
      * `OK` — 没有错误。
      * `ERROR` — 处理请求时出错。
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      服务器响应的标准包装器。
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      的错误代码。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      错误的描述。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      错误列表。
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    服务器错误的标准包装器。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__403">
  
  ## 403 Forbidden
  
  授权数据不正确或禁止访问资源。 [有关错误的更多信息](https://yandex.ru/dev/market/partner-api/doc/zh/concepts/error-codes.md#403)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      响应的类型。
      可能的值:
      * `OK` — 没有错误。
      * `ERROR` — 处理请求时出错。
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      服务器响应的标准包装器。
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      的错误代码。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      错误的描述。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      错误列表。
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    服务器错误的标准包装器。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__420">
  
  ## 420 Method Failure
  
  已超出资源访问限制。 [有关错误的更多信息](https://yandex.ru/dev/market/partner-api/doc/zh/concepts/error-codes.md#420)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      响应的类型。
      可能的值:
      * `OK` — 没有错误。
      * `ERROR` — 处理请求时出错。
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      服务器响应的标准包装器。
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      的错误代码。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      错误的描述。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      错误列表。
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    服务器错误的标准包装器。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__500">
  
  ## 500 Internal Server Error
  
  市场的内部错误。 [有关错误的更多信息](https://yandex.ru/dev/market/partner-api/doc/zh/concepts/error-codes.md#500)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      响应的类型。
      可能的值:
      * `OK` — 没有错误。
      * `ERROR` — 处理请求时出错。
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      服务器响应的标准包装器。
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      的错误代码。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      错误的描述。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      错误列表。
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    服务器错误的标准包装器。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
        

- Console

  ```openapi-sandbox translate=no
  pathParams: []
  searchParams:
    - description: 报告或文档的格式。
      name: format
      in: query
      required: false
      schema:
        description: |
          报告格式:
  
          * `FILE` — 电子表格文件（XLSX).
          * `CSV` — 每个报告表都有一个包含CSV文件的ZIP存档。
          * `JSON` — 每个报告表都有一个带有JSON文件的ZIP压缩包.
        type: string
        enum:
          - FILE
          - CSV
          - JSON
        default: FILE
  headers: []
  body: |-
    {
      "businessId": 1,
      "categoryId": 0,
      "dateFrom": "2025-08-22",
      "dateTo": "2025-09-22"
    }
  schema:
    description: 生成报告所需的数据。
    type: object
    required:
      - dateFrom
      - dateTo
      - businessId
      - categoryId
    properties:
      businessId:
        description: "内阁ID。  {% if audience == \"partner\" %} 要找到答案，请使用请求 [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md).\n\nℹ️ [什么是市场上的橱柜和商店？](https://yandex.ru/support/marketplace/account/introduction.html)\n\n:::no-translate\n{% endif %}\n:::\n\n"
        type: integer
        format: int64
        minimum: 1
      categoryId:
        description: 的类别ID。
        type: integer
        format: int64
      dateFrom:
        type: string
        format: date
        description: |
          期的开始，包括在内。
  
          日期格式: `YYYY-MM-DD`.
        example: '2025-08-22'
      dateTo:
        type: string
        format: date
        description: |
          期结束，包括在内。
  
          日期格式: `YYYY-MM-DD`.
        example: '2025-09-22'
  bodyType: application/json
  method: post
  security:
    - type: apiKey
      name: 'Api-Key'
      in: header
    - type: oauth2
      x-inline: true
      flows:
        implicit:
          authorizationUrl: https://oauth.yandex.ru/authorize
          scopes:
            market:partner-api: API Яндекс.Маркета / Поиска по товарам для партнеров
  path: v2/reports/competitors-position/generate
  host: https://api.partner.market.yandex.ru
  
  ```
        

{% endlist %}


</div>
<!-- endsource: zh/api/reports/generateCompetitorsPositionReport.md -->


[*Deprecated]: No longer supported, please use an alternative and newer version.