GET/creatives/

Returns a list of registered creative content.

Request format

GET https://distribution.yandex.net/api/v2/creatives/
  ? [[clid](*clid)=<string>]
  & [[page](*page)=<integer>]
  & [[page_size](*page_size)=<integer>]

clid

Required parameter. CLID for which to show a list of creative content built for it.

page

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

page_size

Page size. Default value – 30.

Response format

{
  "data": {
    "count": {integer},
    "countItemsOnPage": {integer},
    "current": {integer},
    "next": {integer},
    "previous": {integer},
    "results": [
      {
        "clid": {integer},
        "token": {string},
        "dt_created": {string},
        "dt_changed": {string},
        "description": {string}
      }
    ]
  },
  "result": "ok"
}      

Response parameters

count

Number of creative content pieces.

countItemsOnPage

Number of entries on the page.

current

Current page number.

next

Next page number.

previous

Previous page number.

result

Creative content details.

clid

CLID the creative content is assigned to.

token

Creative content token.

dt_created

Creative content creation date.

dt_changed

Creative content change date.

description

Creative content description.

Example for JSON

Request:

curl -i -H "Accept: application/json" -H "Authorization: OAuth 66..." -X GET "https://distribution.yandex.ru/api/v2/creatives/?clid=123456"

Response:


{
  "data": {
    "count": 2,
    "countItemsOnPage": 30,
    "current": 1,
    "next": null,
    "previous": null,
    "results": [
      {
        "clid": 123456,
        "token": "4CQwVszL78EMgDAwBoV",
        "dt_created": "2023-08-26T18:12:15.315552+03:00",
        "dt_changed": "2023-08-26T18:12:19.101429+03:00",
        "description": "Test description"
      },
      {
        "clid": 123456,
        "token": "4CQwVszL78EMgDAvrAo",
        "dt_created": "2023-08-26T17:19:59.515248+03:00",
        "dt_changed": "2023-08-26T17:20:04.495564+03:00",
        "description": "Test description 2"
      }
    ]
  },
  "result": "ok"
}