Sales Analytics Report

pathParams: []
searchParams:
  - description: The format of the report or document.
    name: format
    in: query
    required: false
    schema:
      description: >
        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.
      type: string
      enum:
        - FILE
        - CSV
        - JSON
      default: FILE
headers: []
body: |-
  {
    "businessId": 1,
    "campaignId": 1,
    "dateFrom": "2025-08-22",
    "dateTo": "2025-09-22",
    "grouping": "CATEGORIES"
  }
schema:
  description: >
    The data required to generate the report.


    The request must contain either `businessId`, or
    `campaignId` but not both at once.
  type: object
  required:
    - dateFrom
    - dateTo
    - grouping
  properties:
    businessId:
      description: "Cabinet ID. To find out, use the request [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md).\n\nℹ️ [What is a cabinet and a store on the Market?](https://yandex.ru/support/marketplace/account/introduction.html)\n"
      type: integer
      format: int64
      minimum: 1
    campaignId:
      description: "The ID of the campaign (store) — The technical identifier that represents your store in the Yandex Market system when working through the API. It is uniquely linked to your store, but it is intended only for automated interaction.\n\nYou can find it using a query [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md) or find it in the seller's office on the Market. Click on your account icon → **Settings** and in the menu on the left, select **APIs and modules**:\n\n* block **Campaign ID**;\n* tab **Query log** → drop-down list in the block **Show logs**.\n\n⚠️ Do not confuse it with:\n- the store's identifier, which is displayed in the merchant's personal account.\n- advertising campaigns.\n"
      type: integer
      format: int64
      minimum: 1
    dateFrom:
      type: string
      format: date
      description: |
        The beginning of the period, inclusive.

        Date format: `YYYY-MM-DD`.
      example: '2025-08-22'
    dateTo:
      type: string
      format: date
      description: |
        End of the period, inclusive.

        Date format: `YYYY-MM-DD`.
      example: '2025-09-22'
    grouping:
      type: string
      description: |
        Grouping of report data.
        Possible values:
        * `CATEGORIES` — grouping by category.
        * `OFFERS` — grouping by product.
      enum:
        - CATEGORIES
        - OFFERS
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/shows-sales/generate
host: https://api.partner.market.yandex.ru