API JD.com Все SKU с ценами
Состояние API
- Состояние за 24 ч
- 100%
- Среднее время за 24 ч
- 19.03 s
- Стабильно / норма
- Доступно
- Ограничено
- Почти недоступно
Последние 24 часа
Последние 30 дней
Получайте все 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 время и повторите попытку.
Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.Параметры запроса
| Имя | Расположение | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|---|
Authorization | header | string | Да | - | Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода. |
platform | body | string | Да | jd | Идентификатор платформы, фиксированное значение. |
action | body | string | Да | skus | Идентификатор возможности, фиксированное значение. |
item_id | body.params | string | Да | - | Определяет один товар 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 не принимаются: сначала откройте их в браузере и скопируйте ссылку на страницу товара. |
limit | body.params | integer (1–100) | Нет | 100 | Максимальное число записей в этом вызове, целое число от 1 до 100. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. При значениях выше максимума эндпоинт возвращает ошибку 422 до списания средств. |
Примеры кода
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 меняются при каждом вызове, поэтому показана только их структура.
{
"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_id | ID группы товара 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_url | URL изображения: в 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