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

API JD.com Поиск

POST

Состояние API

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

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

Возможность «Поиск JD.com» находит товары JD по keyword и возвращает для каждого ID товара, название и краткое название, цену, число отзывов, долю положительных оценок, магазин, продаёт ли товар JD напрямую, промо-метки и ключевые преимущества. Используйте её, чтобы увидеть, какие товары JD показывает первыми по запросу, кто их продаёт и как их оценивают покупатели: для первичного исследования товаров, первого знакомства с ценовыми диапазонами или сравнения собственных карточек товаров JD с карточками сторонних магазинов.

Ключевые слова на китайском обычно точнее совпадают с названиями товаров JD. Чтобы узнать подробности, передайте item_id из результата в возможность «Сведения о товаре JD» или «Отзывы JD». good_rate — процент положительных оценок, который публикует JD; он имеет смысл только вместе с числом отзывов. review_count и sold_count — отображаемый текст вроде 100k+, а не точные числа.

Цена: $2.47 за 1 000 запросов ($0.002472 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

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

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: jd и action: search, а параметры передайте в params.
- Обязательные параметры:
  - keyword: Поисковый запрос для search на JD.com. Это должна быть поисковая фраза, а не ID товара или селектор магазина; найденные результаты не означают полного охвата каталога.
- Необязательные параметры:
  - limit: Максимальное число записей в этом вызове, целое число от 1 до 5. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. (по умолчанию: 5)
- Возвращает список записей. Основные поля каждой записи: item_id (Числовой ID товара JD), url, title, short_title (Короткое название товара в том виде, ка…), price, currency, sold_count (Число продаж в том виде, как оно показа…), review_count (Число отзывов в том виде, как оно показ…), good_rate (Отображаемый JD процент положительных о…), shop_id (Числовой ID магазина JD), shop_name (Публичное название магазина), shop_url (Публичная страница магазина JD); всего полей: 17, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=jd.
- Пример тела запроса:
{
  "platform": "jd",
  "action": "search",
  "params": {
    "keyword": "华为手机"
  }
}
- Цена: $2.47 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.

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

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

ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаjdИдентификатор платформы, фиксированное значение.
actionbodystringДаsearchИдентификатор возможности, фиксированное значение.
keywordbody.paramsstringДа-Поисковый запрос для search на JD.com. Это должна быть поисковая фраза, а не ID товара или селектор магазина; найденные результаты не означают полного охвата каталога.
limitbody.paramsinteger (1–5)Нет5Максимальное число записей в этом вызове, целое число от 1 до 5. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. При значениях выше максимума эндпоинт возвращает ошибку 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": "search",
  "params": {
    "keyword": "华为手机"
  }
}'

Спецификация 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": "search",
  "results": [
    {
      "item_id": "10237497167004",
      "url": "https://item.jd.com/10237497167004.html",
      "title": "华为手机2026热销新机上市畅享 90 Plus 麒麟8系芯片丝滑超好用鸿蒙AI防诈6620mAh巨鲸大电池柔光护眼 星空黑【128GB】 官方标配【365天延保+蓝牙耳机+运费险】",
      "price": 1999,
      "currency": "CNY",
      "shop_id": "219104371",
      "shop_name": "迪旺手机专营店",
      "shop_url": "https://mall.jd.com/index-219104371.html",
      "category_ids": [
        "9987",
        "653",
        "655"
      ],
      "image_url": "https://img14.360buyimg.com/n0/jfs/t1/547105/14/3627/77818/6ad1919eFd3fb2338/0083320320125c52.png",
      "platform": "jd"
    },
    {
      "item_id": "10230554159591",
      "url": "https://item.jd.com/10230554159591.html",
      "title": "华为mate60pro手机智能手机鸿蒙智能AI手机麒麟芯片正品国行mate60赠手机壳 Mate60Pro【雅川青】 12GB+256GB 7天试用(送手机壳88W充电器)",
      "price": 2837,
      "currency": "CNY",
      "shop_id": "169276555",
      "shop_name": "尊享数码手机拼购店",
      "shop_url": "https://mall.jd.com/index-169276555.html",
      "category_ids": [
        "9987",
        "653",
        "655"
      ],
      "image_url": "https://img14.360buyimg.com/n0/jfs/t1/483100/15/10357/93091/6a647f40Ff1f84472/008332032085260d.jpg",
      "platform": "jd"
    }
  ],
  "count": 5,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Поля ответа

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

ПолеЗначение
item_idЧисловой ID товара JD. Из результатов поиска его можно сразу передать при запросе сведений о товаре, отзывов или цены.
urlСсылка на запись на платформе.
titleЗаголовок. null, если на платформе нет заголовков (например, у текстовых постов).
short_titleКороткое название товара в том виде, как его возвращает JD.
priceЦена числом без символа валюты; см. currency.
currencyКод валюты цены (например, CNY, USD). Если price есть, а currency равно null, не делайте предположений о валюте.
sold_countЧисло продаж в том виде, как оно показано в результатах поиска (search): отображаемый текст, например 100k+, а не точное число единиц.
review_countЧисло отзывов в том виде, как оно показано в результатах поиска (search): отображаемый текст, который может быть округлён, а не точное число.
good_rateОтображаемый JD процент положительных отзывов.
shop_idЧисловой ID магазина JD.
shop_nameПубличное название магазина.
shop_urlПубличная страница магазина JD.
is_jd_selfПродаётся ли товар непосредственно JD (розничным подразделением JD.com).
promotionМетка промоакции из списка товаров.
sell_pointПреимущества товара, указанные в списке товаров.
category_idsПуть по категориям JD в виде последовательности ID.
image_urlURL изображения: в search, product_detail, shop и skus это основное изображение (обложка) товара; в description_images это изображение описания из этой записи (полноразмерное изображение с HTTPS-адресом на хостинге изображений JD).
platformИдентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).

FAQ

Можно ли искать на английском?

Да, но китайские ключевые слова обычно точнее совпадают с названиями товаров на JD и дают более точные результаты. Если ищете бренд и модель, пишите их так, как они обычно указываются в названиях товаров JD.

Как получить сведения и отзывы по результату?

item_id каждого результата — числовой ID товара JD. Передавайте его сразу в возможность «Сведения о товаре JD», «Отзывы JD» или «Цена товара JD»; собирать ссылку на товар не нужно.

Как отличить собственные карточки товаров JD от сторонних магазинов?

Проверьте is_jd_self: true означает, что товар продаёт сам JD. Сведения о магазине находятся в shop_name, shop_id и shop_url. Сравнивать цены и оценки внутри каждой группы корректнее, чем смешивать их.

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

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

Ошибки

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

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

  • JD.com JOS и JD Union: объекты товара и SKU ↗

    Официальные материалы открытой платформы и партнёрской программы JD.com описывают такие объекты товаров и SKU, как названия, основные изображения, категории, отображаемые цены, сведения о логистике, признак продажи самим JD.com и показатели объёма заказов. Эта терминология не доказывает, что доступны все веб-страницы или поля, что у вызывающей стороны есть доступ или что EveryInfra реализует официальный интерфейс.

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