API JD.com
Поиск товаров JD.com по ключевому слову: данные о товарах, публичные отзывы, цены и каталоги магазинов.
Получайте данные об одном товаре по его числовому ID. Все SKU товара можно получить с помощью skus, а изображения из его описания — с помощью description_images. Идентификаторы товара и магазина не взаимозаменяемы. Цены и наличие фиксируются на момент запроса и не являются персональными условиями оформления заказа или расчётов.
Доступность платформы
- Состояние за 24 ч
- 100%
За последние 30 дней
Доступные возможности
Все действия JD.com: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите товары JD.com по поисковой фразе и получайте до пяти результатов. | $2.47 за 1 000 запросов | Работает стабильно · состояние 99% |
Сведения о товареproduct_detail | Получите полную запись товара JD.com по одному item_id. | $1.39 за 1 000 запросов | Норма |
Отзывыreviews | Читайте до 10 отзывов покупателей о товаре JD.com. | $1.39 за 1 000 запросов | Норма |
Магазинshop | Просматривайте до 24 товаров одного магазина JD.com: ID товара, название, цена, валюта и наличие. | $28.81 за 1 000 запросов | Норма |
Цена товараproduct_price | Проверяйте текущую отображаемую цену и наличие одного товара JD.com по item_id. | $1.39 за 1 000 запросов | Норма |
Все SKU с ценамиskus | Получайте все SKU товара JD.com по любому из его SKU в item_id. | $1.39 за 1 000 запросовКаждая запись считается одним вызовом API | Работает стабильно · состояние 100% |
Изображения из описанияdescription_images | Получайте все изображения из раздела описания товара JD.com сверху вниз. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API JD.com?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите товары JD.com по поисковой фразе и получайте до пяти результатов. В каждом результате есть цена, данные о продажах и отзывах в отображаемом виде, доля положительных оценок, магазин и промо-теги. Передавайте возвращённый | keyword | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=5, maxLimit=5. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $2.47 за 1 000 запросов | item_id · url · title · short_title · price · currency · sold_count · review_count · good_rate · shop_id · shop_name · shop_url · is_jd_self · promotion · sell_point · category_ids · image_url · platform |
product_detailСведения о товаре Получите полную запись товара JD.com по одному | item_id | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | item_id · url · title · price · price_display · price_masked · currency · available · unavailable_reason · shop_id · shop_name · shop_url · category_id · category · stock · stock_state · color · size · weight · image_url · image_urls · is_jd_self · brand · model · original_price · upc · warranty · product_area · is_jd_express · variant_count · variants · platform |
reviewsОтзывы Читайте до 10 отзывов покупателей о товаре JD.com. Получайте оценку, дополнение к отзыву, купленный вариант, голоса «полезно», фото, а также статус PLUS и число покупок автора отзыва. Никнеймы показаны так же, как на JD, и могут быть частично скрыты. Выборка не является полной историей, и разрешение на её повторную публикацию не предоставляется. | item_id | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=10. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · item_id · text · review_append · rating · rating_scale · posted_at · color · size · useful_count · images · author_name · author_avatar_url · author_is_plus · buy_count · platform |
shopМагазин Просматривайте до 24 товаров одного магазина JD.com: ID товара, название, цена, валюта и наличие. Передавайте числовой | shop_id | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=24, maxLimit=24. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $28.81 за 1 000 запросов | item_id · url · title · price · currency · shop_id · shop_name · shop_url · image_url · available · platform |
product_priceЦена товара Проверяйте текущую отображаемую цену и наличие одного товара JD.com по | item_id | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | item_id · url · price · currency · available · unavailable_reason · platform |
skusВсе SKU с ценами Получайте все SKU товара JD.com по любому из его SKU в | item_id | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=100, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросовКаждая запись считается одним вызовом API | item_id · url · product_id · is_requested · title · properties · color · size · price · currency · on_sale · in_stock · stock_state · stock · purchase_limit · delivery_promise · is_presale · is_government_subsidy · is_billion_subsidy · is_flash_sale · promo_tags · upc · brand · image_url · shop_id · shop_name · is_jd_self · variant_count · platform |
description_imagesИзображения из описания Получайте все изображения из раздела описания товара JD.com сверху вниз. Каждая ссылка на полноразмерное изображение пронумерована в | item_id | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | item_id · position · image_url · image_count · platform |
Что означают параметры действия search в API JD.com?
Ищите товары JD.com по поисковой фразе и получайте до пяти результатов. В каждом результате есть цена, данные о продажах и отзывах в отображаемом виде, доля положительных оценок, магазин и промо-теги. Передавайте возвращённый item_id в действия для получения данных о товаре, отзывов или цены. Порядок и охват относятся к одному ответу, а не ко всему каталогу.
keywordОбязательный- Поисковый запрос для
searchна JD.com. Это должна быть поисковая фраза, а не ID товара или селектор магазина; найденные результаты не означают полного охвата каталога.JD.com JOS и JD Union: объекты товара и SKU — Официальные материалы открытой платформы и партнёрской программы JD.com описывают такие объекты товаров и SKU, как названия, основные изображения, категории, отображаемые цены, сведения о логистике, признак продажи самим JD.com и показатели объёма заказов. Эта терминология не доказывает, что доступны все веб-страницы или поля, что у вызывающей стороны есть доступ или что EveryInfra реализует официальный интерфейс. · Проверено
Что означают параметры действия product_detail в API JD.com?
Получите полную запись товара JD.com по одному item_id. В ней есть бренд, модель, цена и исходная цена, статус наличия, варианты, штрихкод, гарантия и статус JD Logistics. Если price_masked равно true, отображаемая цена неточная. Значение null для наличия означает «не указано», а не ноль.
item_idОбязательный- Определяет один товар JD.com для
product_detail,reviewsилиproduct_price. Передайте строку цифр, которую возвращаетsearch, или канонический устаревший URLhttps://item.jd.com/<digits>.htmlбез строки запроса и фрагмента; произвольные, непрозрачные URL и URL с других хостов не считаются равнозначными идентификаторами товара.JD.com: обозначения отображаемой цены и цены покупки, зависящие от условий — JD.com отличает ценовую метку, отображаемую в реальном времени, от итоговой цены товара и специальных условий для участников программы, новых пользователей и отдельных регионов, а также персональных предложений. При этом часть сравнительной информации может поступать с задержкой или быть неполной. Возвращённую цену следует считать снимком отображаемой цены на момент запроса, а не персональной ценой сделки, суммой к оплате или гарантией абсолютной точности. · Проверено
Что означают параметры действия reviews в API JD.com?
Читайте до 10 отзывов покупателей о товаре JD.com. Получайте оценку, дополнение к отзыву, купленный вариант, голоса «полезно», фото, а также статус PLUS и число покупок автора отзыва. Никнеймы показаны так же, как на JD, и могут быть частично скрыты. Выборка не является полной историей, и разрешение на её повторную публикацию не предоставляется.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеitem_idОбязательный- Определяет один товар JD.com для
product_detail,reviewsилиproduct_price. Передайте строку цифр, которую возвращаетsearch, или канонический устаревший URLhttps://item.jd.com/<digits>.htmlбез строки запроса и фрагмента; произвольные, непрозрачные URL и URL с других хостов не считаются равнозначными идентификаторами товара.JD.com: правила отзывов и публикации фото — JD.com различает отзывы, дополнительные отзывы, изображения, ответы, модерацию, свёрнутый контент и маскированные никнеймы. Публичная видимость может зависеть от правил публикации отзывов и конфиденциальности, поэтому возвращённый набор нельзя называть полной историей отзывов или разрешением на распространение контента авторов отзывов. · ПровереноПользовательское соглашение JD.com (действует с 20 января 2026 г.): публичные отзывы и границы доступа — Пользовательское соглашение JD.com указывает, что информация в отзывах является публичной и JD.com может использовать её в соответствии с соглашением. Также в нём говорится, что личная информация, как правило, не раскрывается третьим лицам без разрешения, и запрещается похищать личную информацию или нарушать законные права. Это обосновывает только границы доступа и разрешений и не даёт EveryInfra или вызывающим сторонам права распространять, использовать для обучения или коммерчески повторно использовать тексты, изображения или информацию о пользователях. · Проверено
Что означают параметры действия shop в API JD.com?
Просматривайте до 24 товаров одного магазина JD.com: ID товара, название, цена, валюта и наличие. Передавайте числовой shop_id магазина или его ссылку mall.jd.com. Результаты не подтверждают полный ассортимент магазина.
shop_idОбязательный- Определяет магазин для действия
shop. Передайте строку цифр или канонический устаревший URLhttps://mall.jd.com/index-<digits>.htmlбез строки запроса и фрагмента; URL с других хостов отклоняются, аitem_idтовара этот параметр не принимает.JD.com JSSDK: SKU и магазин задаются отдельно — В документации JD.com по переадресации `skuId` используется для перехода на страницу товара, а `shopId` — для перехода на страницу магазина. Это подтверждает необходимость различать идентификаторы товара и магазина, но не подтверждает права на сбор данных с веб-страниц, поддержку разбора URL, полноту каталогов магазинов или поведение запросов EveryInfra. · Проверено
Что означают параметры действия product_price в API JD.com?
Проверяйте текущую отображаемую цену и наличие одного товара JD.com по item_id. Если товар нельзя купить, вы получите указанную причину. Это данные на момент запроса, а не персональная цена при оформлении заказа, скидка для участников или фактически списанная сумма.
item_idОбязательный- Определяет один товар JD.com для
product_detail,reviewsилиproduct_price. Передайте строку цифр, которую возвращаетsearch, или канонический устаревший URLhttps://item.jd.com/<digits>.htmlбез строки запроса и фрагмента; произвольные, непрозрачные URL и URL с других хостов не считаются равнозначными идентификаторами товара.JD.com: обозначения отображаемой цены и цены покупки, зависящие от условий — JD.com отличает ценовую метку, отображаемую в реальном времени, от итоговой цены товара и специальных условий для участников программы, новых пользователей и отдельных регионов, а также персональных предложений. При этом часть сравнительной информации может поступать с задержкой или быть неполной. Возвращённую цену следует считать снимком отображаемой цены на момент запроса, а не персональной ценой сделки, суммой к оплате или гарантией абсолютной точности. · Проверено
Что означают параметры действия skus в API JD.com?
Получайте все SKU товара JD.com по любому из его SKU в item_id. Вы получаете по одной записи на цвет, размер или объём с ценой, статусом наличия и лимитом покупки. Первая запись — отправленный вами SKU. price — цена, которую видит неавторизованный покупатель до применения купонов при оформлении заказа.
item_idОбязательный- Определяет один товар 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не принимаются: сначала откройте их в браузере и скопируйте ссылку на страницу товара.JD.com: обозначения отображаемой цены и цены покупки, зависящие от условий — JD.com отличает ценовую метку, отображаемую в реальном времени, от итоговой цены товара и специальных условий для участников программы, новых пользователей и отдельных регионов, а также персональных предложений. При этом часть сравнительной информации может поступать с задержкой или быть неполной. Возвращённую цену следует считать снимком отображаемой цены на момент запроса, а не персональной ценой сделки, суммой к оплате или гарантией абсолютной точности. · Проверено
Что означают параметры действия description_images в API JD.com?
Получайте все изображения из раздела описания товара JD.com сверху вниз. Каждая ссылка на полноразмерное изображение пронумерована в position, а общее количество указано в image_count. Передайте любой SKU товара или ссылку на товар в item_id. Галерея остаётся в product_detail. Если у товара нет изображений в описании, возвращается пустой результат без списания средств.
item_idОбязательный- Определяет товар JD.com, изображения описания которого нужно получить, по любому из его 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не принимаются: сначала откройте их в браузере и скопируйте ссылку на страницу товара.
Как использовать API JD.com
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"jd","action":"search","params":{"keyword":"<keyword>"}}'
Руководства по API JD.com
Практические примеры и методики на основе этих действий. Сначала сверьтесь с актуальными действиями, параметрами и полями на этой странице: примеры и ограничения из статьи не заменяют актуальный каталог.
Быстрый старт с единым API данных: от каталога возможностей к первому полученному результату
Получайте данные с разных платформ через platform, action и params: изучите каталог возможностей, выполните минимальные запросы, обработайте асинхронные задачи и частичные результаты, учтите оплату и обеспечьте прослеживаемость записей данных.
Читать статьюМонетизация парсинга цен: как построить продукт мониторинга цен, который продавцы будут продлевать
Почему продавцы платят за мониторинг цен и почему отменяют подписку. Разбираем способы поставки ценовых данных, единицы тарификации и приёмку пилота через сопоставление товаров, списки исключений и процессы согласования цен.
Читать статьюСбои API, возврат кредитов и сверка: как проверить чистое списание за запрос
Разделяйте задачи, попытки вызова, состояния доставки и события кошелька, чтобы без двойного учёта обрабатывать отказы до списания, пустые результаты и частичный возврат кредитов; офлайн-примеры построены на целых числах.
Читать статьюВопросы об API JD.com
Какие данные можно получить через API JD.com?
Укажите в platform значение jd. В текущем каталоге: поиск, сведения о товаре, отзывы, магазин, цена товара и more. Эти названия действий соответствуют разным объектам или представлениям JD.com; это не взаимозаменяемые режимы поиска.
Есть ли у JD.com официальный API?
Открытая платформа JD (JOS) даёт зарегистрированным разработчикам и партнёрам возможности для логистики, маркетинга, облачных сервисов и авторизованного входа через приложения, которые они создают и публикуют в центре разработчиков. Продвижение товаров для партнёров идёт через отдельную программу JD Union.
Официальные источники: «JD Open Platform (JOS) developer center» · «JD Union» · Проверено
Нужен ли аккаунт разработчика JD.com или API-ключ?
Нет. Запросы идут через EveryInfra с API-ключом EveryInfra: зарегистрируйтесь, создайте ключ в консоли и передавайте его в заголовке Authorization: Bearer <API_KEY>. Вам не нужно регистрировать приложение разработчика JD.com, запрашивать доступ к API JD.com или входить через аккаунт JD.com. Действия возвращают только публичные данные JD.com.
Сколько стоит JD.com API за 1 000 запросов?
От $1.39 за 1 000 запросов в зависимости от действия; цена каждого действия указана в таблице на этой странице и в публичном каталоге. Подписки нет: вы пополняете баланс в USD и платите за каждый вызов, а неудачные вызовы и пустые результаты не оплачиваются.
Какие входные данные нужны для запроса search к платформе JD.com?
Поисковый запрос для search на JD.com. Это должна быть поисковая фраза, а не ID товара или селектор магазина; найденные результаты не означают полного охвата каталога. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе JD.com?
Объявленная схема включает item_id, title, short_title и price. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия JD.com возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. skus runs только синхронно: оно получает все возвращаемые данные (по каждой цели пакета или каждому SKU товара) в рамках одного вызова API, а запрос с "mode": "async" получает ошибку 422 до какого-либо списания. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.