Getting questions about the seller's products

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
  • communication — Customer communication
  • all-methods — Full account management
  • all-methods:read-only — View all data

Returns questions about the seller's products using the specified filters.

The results are returned page by page, one page contains no more than 50 questions.

⚙️ Limit: 10,000 requests per hour

Request

POST

https://api.partner.market.yandex.ru/v1/businesses/{businessId}/goods-questions

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

limit

Type: integer

The number of values per page.

Min value: 1

page_token

Type: string

ID of the results page.

If the parameter is omitted, the first page is returned.

We recommend transmitting the value of the output parameter nextPageToken, received during the last request.

If set page_token and the request has parameters page and pageSize they are ignored.

Example: eyBuZXh0SWQ6IDIzNDIgfQ==

Body

application/json
{
  "offerId": "example",
  "categoryIds": [
    0
  ],
  "questionIds": [
    1
  ],
  "dateFrom": "2020-02-02",
  "dateTo": "2020-02-02",
  "updatedDateFrom": "2020-02-02T14:30:30+03:00",
  "updatedDateTo": "2020-02-02T14:30:30+03:00",
  "needAnswer": false,
  "sort": "CREATED_AT_DESC"
}

Name

Description

categoryIds

Type: integer[] | null

Product category IDs.

Min items: 1

Unique items: true

Example
[
  0
]

dateFrom

Type: string<date>

The start date of the issue creation period.

If the parameter is omitted, the information is returned 1 month before the date specified in dateTo dates.

The maximum interval is 1 month.

Example: 2020-02-02

dateTo

Type: string<date>

The end date of the issue creation period.

If the parameter is omitted, the current date is used.

The maximum interval is 1 month.

Example: 2020-02-02

needAnswer

Type: boolean

Do I need an answer to the question?

  • true — only questions that are waiting to be answered.
  • false — all questions.

Default: false

offerId

Type: string

Your SKU — the product ID in your system.

Usage rules SKU:

  • For each product SKU there must be one.

  • Already set SKU it cannot be released and reused for another product. Each product should receive a new identifier that has never been used in your catalog before.

SKU The product can be changed in the seller's account on the Market. Read about how to do this. in the Help of the Market for sellers.

Warning

Spaces at the beginning and end of the value are automatically deleted. For example, " SKU123 " and "SKU123" they will be treated as identical values.

What is SKU and how to assign it

Min length: 1

Max length: 255

Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

Example: example

sort

Type: string

The sorting order of the questions.

  • CREATED_AT_DESC — by the issue creation date in descending order;
  • CREATED_AT_ASC — by the creation date of the question in ascending order.

Enum: CREATED_AT_DESC, CREATED_AT_ASC

Responses

200 OK

A list of questions.

Body

application/json
{
  "status": "OK",
  "result": {
    "questions": [
      {
        "questionIdentifiers": {},
        "businessId": 1,
        "text": "example",
        "createdAt": "2025-01-01T00:00:00Z",
        "votes": {},
        "author": {}
      }
    ],
    "paging": {
      "nextPageToken": "example"
    },
    "totalCount": 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

    questions
    Type: object[]

    author
    Type: object

    name

    Type: string

    The name of the author or the name of the cabinet.

    Example: example

    type

    Type: string

    Type of author:

    • USER — user.
    • BUSINESS — office.
    • VENDOR — manufacturer.
    • BRAND — brand.

    Enum: USER, BUSINESS, VENDOR, BRAND

    Information about the author of the comment.

    Example
    {
  "type": "USER",
  "name": "example"
}

    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

    createdAt

    Type: string<date-time>

    The date and time when the question was created.

    Example: 2025-01-01T00:00:00Z

    questionIdentifiers
    Type: object

    id

    Type: integer

    The issue ID.

    Min value: 1

    offerId

    Type: string

    Your SKU — the product ID in your system.

    Usage rules SKU:

    • For each product SKU there must be one.

    • Already set SKU it cannot be released and reused for another product. Each product should receive a new identifier that has never been used in your catalog before.

    SKU The product can be changed in the seller's account on the Market. Read about how to do this. in the Help of the Market for sellers.

    Warning

    Spaces at the beginning and end of the value are automatically deleted. For example, " SKU123 " and "SKU123" they will be treated as identical values.

    What is SKU and how to assign it

    Min length: 1

    Max length: 255

    Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

    Example: example

    categoryId

    Type: integer

    The category ID.

    Min value: 0

    Issue IDs.

    Example
    {
  "id": 1,
  "categoryId": 0,
  "offerId": "example"
}

    text

    Type: string

    Text content.

    Min length: 1

    Max length: 5000

    Example: example

    votes
    Type: object

    dislikes

    Type: integer

    The number of dislikes.

    likes

    Type: integer

    The number of likes.

    The number of likes and dislikes on a question, answer, or comment.

    Example
    {
  "likes": 0,
  "dislikes": 0
}

    A list of questions.

    Example
    [
  {
    "questionIdentifiers": {
      "id": 1,
      "categoryId": 0,
      "offerId": "example"
    },
    "businessId": 1,
    "text": "example",
    "createdAt": "2025-01-01T00:00:00Z",
    "votes": {
      "likes": 0,
      "dislikes": 0
    },
    "author": {
      "type": "USER",
      "name": "example"
    }
  }
]

    totalCount

    Type: integer

    The total number of questions that fall under the filter.

    paging
    Type: object

    nextPageToken

    Type: string

    ID of the next results page.

    Example: example

    The ID of the next page.

    Example
    {
  "nextPageToken": "example"
}

    A list of questions.

    Example
    {
  "questions": [
    {
      "questionIdentifiers": {
        "id": 1,
        "categoryId": 0,
        "offerId": "example"
      },
      "businessId": 1,
      "text": "example",
      "createdAt": "2025-01-01T00:00:00Z",
      "votes": {
        "likes": 0,
        "dislikes": 0
      },
      "author": {
        "type": "USER",
        "name": "example"
      }
    }
  ],
  "paging": {
    "nextPageToken": "example"
  },
  "totalCount": 0
}
    Example
    {
  "result": {
    "questions": [
      {
        "questionIdentifiers": {
          "id": 1,
          "categoryId": 0,
          "offerId": "example"
        },
        "businessId": 1,
        "text": "example",
        "createdAt": "2025-01-01T00:00:00Z",
        "votes": {
          "likes": 0,
          "dislikes": 0
        },
        "author": {
          "type": "USER",
          "name": "example"
        }
      }
    ],
    "paging": {
      "nextPageToken": "example"
    },
    "totalCount": 0
  }
}

400 Bad Request

The request contains incorrect data. 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"
    }
  ]
}

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 Yandex. 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"
    }
  ]
}

No longer supported, please use an alternative and newer version.

Previous
Deleting a comment
Next
Answers to the question