Перейти к содержанию

Список карточек товаров

POST /content/v2/get/cards/list

Метод возвращает список созданных карточек товаров.

В ответе метода не будет карточек, находящихся в корзине. Получить такие карточки можно через отдельный метод

Чтобы получить больше 100 карточек товаров, используйте пагинацию: 1. Сделайте первый запрос:

        {
          "settings": {
            "sort": {
              "ascending": true
            },
            "cursor": {
              "limit": 100
            },
            "filter": {
              "withPhoto": -1
            }
          }
        }
Чтобы после выгрузки получать только новые или обновлённые карточки товаров, используйте сортировку по возрастанию: "sort":{"ascending":true}. 2. Скопируйте "updatedAt":"***","nmID":"***" из cursor ответа и вставьте в cursor запроса. 3. Повторите запрос. 4. Повторяйте пункты 2 и 3, пока значение total в ответе не станет меньше, чем значение limit в запросе. Это будет означать, что вы получили все карточки.

Чтобы получать только карточки товаров, которые были созданы или обновлены после предыдущей выгрузки данных: 1. Сохраните поля "cursor":{"updatedAt":"***","nmID":"***"} из последнего ответа предыдущей выгрузки. При выгрузке используйте сортировку по возрастанию: "sort":{"ascending":true}. 2. Укажите в первом запросе сохранённые поля "cursor":{"updatedAt":"***","nmID":"***"}. Продолжайте использовать сортировку по возрастанию. 3. Сохраните поля "cursor":{"updatedAt":"***","nmID":"***"} из последнего ответа текущей выгрузки.

Параметры

Имя Расположение Тип Обязательный Описание
locale query string нет Язык полей ответа name, value и object: - ru — русский - en — английский - zh — китайский Не используется в песочнице. Данные песочницы возвращаются только на русском языке

Тело запроса: object

Ответ: object

Примеры вызова

import os
from wildberries_sdk import items

token = os.getenv("WB_API_TOKEN")
api = items.DefaultApi(
    items.ApiClient(items.Configuration(api_key={"HeaderApiKey": token}))
)
result = api.content_v2_get_cards_list_post(object=...)
print(result)
import { Configuration, DefaultApi } from 'wildberries-sdk';

const api = new DefaultApi(new Configuration({ apiKey: process.env.WB_API_TOKEN }));
const result = await api.contentV2GetCardsListPost({ ... });
console.log(result);
cfg := items.NewConfiguration()
cfg.AddDefaultHeader("Authorization", os.Getenv("WB_API_TOKEN"))
client := items.NewAPIClient(cfg)
result, _, err := client.DefaultApi.ContentV2GetCardsListPost(context.Background()).Execute()
<?php
$config = Wildberries\Sdk\Items\Configuration::getDefaultConfiguration()
    ->setApiKey('Authorization', getenv('WB_API_TOKEN'));
$api = new Wildberries\Sdk\Items\Api\DefaultApi(new GuzzleHttp\Client(), $config);
$result = $api->contentV2GetCardsListPost(...);
use wildberries_sdk_items::apis::{configuration::Configuration, configuration::ApiKey, default_api};

let mut config = Configuration::new();
config.api_key = Some(ApiKey { prefix: None, key: std::env::var("WB_API_TOKEN").unwrap() });
let result = default_api::content_v2_get_cards_list_post(&config, ...).await?;