Наша собственная статистика посещений включена всегда. Google Analytics помогает нам понять, как пользуются нашими публичными страницами (но не вашим рабочим пространством после входа), и включается только с вашего разрешения. См. нашу политику конфиденциальности.

API JD.com Все SKU с ценами

POST

Состояние API

Состояние за 24 ч
100%
Среднее время за 24 ч
19.03 s
  • Стабильно / норма
  • Доступно
  • Ограничено
  • Почти недоступно
Работает стабильно

Получайте все SKU товара JD.com по любому из его SKU в item_id. Вы получаете по одной записи на цвет, размер или объём с ценой, статусом наличия и лимитом покупки. Первая запись — отправленный вами SKU. price — цена, которую видит неавторизованный покупатель до применения купонов при оформлении заказа.

Цена: $1.39 за 1 000 запросов ($0.001389 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Каждая запрошенная запись считается одним вызовом: limit заранее определяет сумму списания, а за записи, которые не вернулись, средства возвращаются. Только синхронный режим: все данные, которые возвращает эндпоинт (по каждой цели в пакете или каждому SKU товара), считываются в рамках этого вызова, а при указании "mode": "async" эндпоинт возвращает ошибку 422 до списания средств.

Промпт для ИИ

Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra JD.com Все SKU с ценами (jd/skus).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: jd и action: skus, а параметры передайте в params.
- Обязательные параметры:
  - item_id: Определяет один товар JD.com для skus по любому из его SKU. Передайте строку цифр, ссылку на товар JD (https://item.jd.com/<digits>.html, https://item.m.jd.com/product/<digits>.html или страницу wqitem.jd.com, открытую в…
- Необязательные параметры:
  - limit: Максимальное число записей в этом вызове, целое число от 1 до 100. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. (по умолчанию: 100)
- Возвращает список записей. Основные поля каждой записи: item_id (Числовой ID товара JD), url, product_id (ID группы товара JD, общий для всех SKU…), is_requested (Соответствует ли эта запись SKU, указан…), title, properties (Атрибуты продажи этого SKU в виде «назв…), color (Цвет (или отделка) этого SKU, как указа…), size (Размер, объём или значение характеристи…), price, currency, on_sale (Выставлен ли этот SKU на продажу (skus)), in_stock (Можно ли заказать этот SKU с немедленно…); всего полей: 28, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=jd.
- Пример тела запроса:
{
  "platform": "jd",
  "action": "skus",
  "params": {
    "item_id": "https://item.m.jd.com/product/10232789210191.html"
  }
}
- Цена: $1.39 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Этот эндпоинт работает только синхронно; не добавляйте "mode": "async" в тело запроса.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.

Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.

Параметры запроса

ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаjdИдентификатор платформы, фиксированное значение.
actionbodystringДаskusИдентификатор возможности, фиксированное значение.
item_idbody.paramsstringДа-Определяет один товар JD.com для skus по любому из его SKU. Передайте строку цифр, ссылку на товар JD (https://item.jd.com/<digits>.html, https://item.m.jd.com/product/<digits>.html или страницу wqitem.jd.com, открытую в WeChat) либо текст, полученный через «Поделиться» и содержащий ровно одну такую ссылку; параметры отслеживания в ссылке не влияют на результат. Короткие ссылки вроде 3.cn или u.jd.com не принимаются: сначала откройте их в браузере и скопируйте ссылку на страницу товара.
limitbody.paramsinteger (1–100)Нет100Максимальное число записей в этом вызове, целое число от 1 до 100. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. При значениях выше максимума эндпоинт возвращает ошибку 422 до списания средств.

Примеры кода

bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "jd",
  "action": "skus",
  "params": {
    "item_id": "https://item.m.jd.com/product/10232789210191.html"
  }
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

Пример ответа

Реальный ответ

Получено October 24, 2026 at 18:28 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты); в списке оставлены первые 2. id, billing и quota меняются при каждом вызове, поэтому показана только их структура.

json
{
  "id": "req_…",
  "platform": "jd",
  "action": "skus",
  "results": [
    {
      "item_id": "10232789210191",
      "url": "https://item.jd.com/10232789210191.html",
      "product_id": "10035827040758",
      "is_requested": true,
      "title": "HUAWEI Pura X View 华为阔直屏手机 沉浸阔直板 超轻薄长续航 亚麻灰 12GB+512GB",
      "properties": {
        "外观": "亚麻灰",
        "存储容量": "12GB+512GB"
      },
      "color": "亚麻灰",
      "size": "12GB+512GB",
      "price": 6999,
      "currency": "CNY",
      "on_sale": true,
      "in_stock": false,
      "stock_state": "pre_order",
      "stock": 6,
      "purchase_limit": 2,
      "delivery_promise": "预计11月23日前发货",
      "is_presale": false,
      "is_government_subsidy": false,
      "upc": "•••",
      "brand": "华为",
      "image_url": "https://img14.360buyimg.com/n0/jfs/t1/536837/15/12542/70661/6ad028daF0fe35216/00835a05a00b835a.jpg",
      "shop_id": "16374386",
      "shop_name": "华为官方旗舰店",
      "is_jd_self": false,
      "variant_count": 12,
      "platform": "jd"
    },
    {
      "item_id": "10232789210185",
      "url": "https://item.jd.com/10232789210185.html",
      "product_id": "10035827040758",
      "is_requested": false,
      "title": "HUAWEI Pura X View 华为阔直屏手机 沉浸阔直板 超轻薄长续航 零度白 12GB+512GB",
      "properties": {
        "外观": "零度白",
        "存储容量": "12GB+512GB"
      },
      "color": "零度白",
      "size": "12GB+512GB",
      "price": 6999,
      "currency": "CNY",
      "on_sale": true,
      "in_stock": false,
      "stock_state": "pre_order",
      "stock": 6,
      "purchase_limit": 2,
      "delivery_promise": "预计11月23日前发货",
      "is_presale": false,
      "is_government_subsidy": false,
      "upc": "•••",
      "brand": "华为",
      "image_url": "https://img14.360buyimg.com/n0/jfs/t1/547139/32/2822/66014/6ad028e0F5afed3f9/00835a05a054f860.jpg",
      "shop_id": "16374386",
      "shop_name": "华为官方旗舰店",
      "is_jd_self": false,
      "variant_count": 12,
      "platform": "jd"
    }
  ],
  "count": 12,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Поля ответа

Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.

ПолеЗначение
item_idЧисловой ID товара JD. Из результатов поиска его можно сразу передать при запросе сведений о товаре, отзывов или цены.
urlСсылка на запись на платформе.
product_idID группы товара JD, общий для всех SKU товара (skus). Это не SKU: не передавайте его как item_id при запросе данных о товаре, отзывов или цены.
is_requestedСоответствует ли эта запись SKU, указанному в запросе (skus); для остальных SKU товара значение равно false.
titleЗаголовок. null, если на платформе нет заголовков (например, у текстовых постов).
propertiesАтрибуты продажи этого SKU в виде «название атрибута → значение» в формулировках JD, обычно на китайском (например, цвет и объём памяти этого SKU) (skus).
colorЦвет (или отделка) этого SKU, как указано на странице JD.
sizeРазмер, объём или значение характеристики этого SKU, как указано на странице JD.
priceЦена числом без символа валюты; см. currency.
currencyКод валюты цены (например, CNY, USD). Если price есть, а currency равно null, не делайте предположений о валюте.
on_saleВыставлен ли этот SKU на продажу (skus). Выставленный на продажу SKU не обязательно есть в наличии: проверяйте поля in_stock и stock_state.
in_stockМожно ли заказать этот SKU с немедленной доставкой (skus). Для SKU, доступных по предзаказу или бронированию, значение равно false; см. stock_state.
stock_stateКод статуса наличия, который показывает JD.
stockОстаток, который JD показывает публично; null означает, что на странице его нет, а не ноль.
purchase_limitМаксимальное количество на одного покупателя; null означает, что на странице ограничение не указано (skus).
delivery_promiseИнформация об условиях доставки или отправки в формулировке JD, например ожидаемая дата отправки (skus); без входа в аккаунт данные приводятся для региона JD по умолчанию и могут различаться в зависимости от региона.
is_presaleПродаётся ли товар по предзаказу (skus).
is_government_subsidyОтмечает ли JD этот SKU как участвующий в общенациональной государственной программе субсидирования (skus); сама отметка не показывает, уменьшено ли уже значение price на сумму субсидии. null означает, что отметку в этот раз получить не удалось.
is_billion_subsidyОтмечает ли JD этот SKU как участника программы Billion Subsidy (skus); null означает, что отметку в этот раз получить не удалось.
is_flash_saleУчаствует ли этот SKU во флеш-распродаже (skus); null означает, что отметку в этот раз получить не удалось.
promo_tagsПромо-метки, которые JD показывает для этого SKU, в формулировке JD (skus); null, если их нет или их не удалось получить.
upcШтрихкод товара (UPC/EAN). null, если на странице его нет.
brandБренд товара.
image_urlURL изображения: в search, product_detail, shop и skus это основное изображение (обложка) товара; в description_images это изображение описания из этой записи (полноразмерное изображение с HTTPS-адресом на хостинге изображений JD).
shop_idЧисловой ID магазина JD.
shop_nameПубличное название магазина.
is_jd_selfПродаётся ли товар непосредственно JD (розничным подразделением JD.com).
variant_countЧисло вариантов (SKU). null, если вариантов нет или значение не предоставлено. Во всех записях skus указано одно и то же значение: если оно превышает число возвращённых записей, список был сокращён из-за значения limit либо часть SKU в этот раз получить не удалось.
platformИдентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).

Ошибки и оплата

401
Ключ отсутствует или недействителен.
402
Недостаточно средств на балансе. Сначала пополните баланс.
422
Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429
Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503
Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто)
Нет данных. Без списания.

Ошибки

Официальные источники

Используются только для проверки объектов и терминов. Они не означают, что платформа разрешила или одобрила работу EveryInfra.

  • JD.com: обозначения отображаемой цены и цены покупки, зависящие от условий ↗

    JD.com отличает ценовую метку, отображаемую в реальном времени, от итоговой цены товара и специальных условий для участников программы, новых пользователей и отдельных регионов, а также персональных предложений. При этом часть сравнительной информации может поступать с задержкой или быть неполной. Возвращённую цену следует считать снимком отображаемой цены на момент запроса, а не персональной ценой сделки, суммой к оплате или гарантией абсолютной точности.

    Проверено 2026-09-11