API 1688 Сведения о товаре
Состояние API
- Состояние за 24 ч
- 99%
- Среднее время за 24 ч
- 37.80 s
- Стабильно / норма
- Доступно
- Ограничено
- Почти недоступно
Последние 24 часа
Последние 30 дней
Получите одно предложение 1688 по ссылке на товар или числовому offerId: ступенчатые цены, минимальный объём заказа, остатки, варианты, характеристики, изображения и сведения о продавце. По price_tiers видно, как цена за единицу снижается с ростом объёма, а отсутствие поля варианта не означает, что этого варианта нет в наличии.
Возможность «Сведения о товаре 1688» возвращает полную публичную информацию об одном оптовом товаре: диапазон цен и ступенчатые цены, минимальный объём заказа и единицу измерения, для которой указана цена, остатки и продажи, сведения о вариантах, рейтинг и долю положительных отзывов, изображения. Также возвращаются название, тип и год основания поставщика, число его подписчиков и добавлений в избранное и то, предлагает ли он образцы и дропшиппинг. Используйте её, чтобы решить, стоит ли закупаться у этого поставщика: для оценки закупки и сравнения поставщиков.
url принимает ссылку на товар 1688, текст из меню «Поделиться» ровно с одной ссылкой на товар или числовой ID предложения; главные страницы магазинов и страницы поиска отклоняются. Цены смотрите в price_tiers, где цена за единицу снижается с ростом объёма. positive_rate — доля от 0 до 1, а не процент. Опции, цены и остатки в skus появляются, только если их указывает платформа, поэтому отсутствие значения не означает, что товара нет в наличии.
Цена: $1.39 за 1 000 запросов ($0.001389 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.
Промпт для ИИ
Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra 1688 Сведения о товаре (alibaba1688/product_detail).
Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: alibaba1688 и action: product_detail, а параметры передайте в params.
- Обязательные параметры:
- url: Для product_detail используйте URL товара на detail.1688.com или m.1688.com, сообщение, сформированное функцией «Поделиться» и содержащее ровно один URL товара, или числовой offerId.
- Возвращает один объект. Основные поля: id, url, title, text, price_min (Нижняя граница диапазона цен), price_max (Верхняя граница диапазона цен), currency, price_tiers (Ступенчатые цены: цена за единицу снижа…), min_order_quantity (Минимальный объём заказа (MOQ)), stock (Остаток на складе), sold_count (Продано единиц), category (Название категории в собственной таксон…); всего полей: 68, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=alibaba1688.
- Пример тела запроса:
{
"platform": "alibaba1688",
"action": "product_detail",
"params": {
"url": "https://detail.1688.com/offer/873514490218.html"
}
}
- Цена: $1.39 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.
Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.Параметры запроса
| Имя | Расположение | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|---|
Authorization | header | string | Да | - | Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода. |
platform | body | string | Да | alibaba1688 | Идентификатор платформы, фиксированное значение. |
action | body | string | Да | product_detail | Идентификатор возможности, фиксированное значение. |
url | body.params | string | Да | - | Для product_detail используйте URL товара на detail.1688.com или m.1688.com, сообщение, сформированное функцией «Поделиться» и содержащее ровно один URL товара, или числовой offerId. Ссылка «Поделиться» вида qr.1688.com принимается, только если она безопасно ведёт на страницу товара. Страницы магазинов и поиска отклоняются. |
Примеры кода
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "alibaba1688",
"action": "product_detail",
"params": {
"url": "https://detail.1688.com/offer/873514490218.html"
}
}'Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.
Пример ответа
Получено October 13, 2026 at 04:57 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты). id, billing и quota меняются при каждом вызове, поэтому показана только их структура.
{
"id": "req_…",
"platform": "alibaba1688",
"action": "product_detail",
"results": {
"id": "•••",
"url": "https://detail.1688.com/offer/873514490218.html",
"title": "跨境专供Pro6蓝牙耳机真无线入耳式超长续航tws运动无线蓝牙耳机",
"price_min": 7.1,
"price_max": 13.8,
"currency": "CNY",
"min_order_quantity": 2,
"stock": 7682692,
"sold_count": 16813,
"category": "蓝牙耳机",
"unit": "条",
"supplier_name": "深圳高耳基科技有限公司",
"supplier_fans": "582",
"supplier_type": "normal_factory",
"supplier_favorited_count": 582,
"supports_dropship": {
"enabled": false,
"consignPrice": null,
"consignPriceTiers": [],
"channels": [],
"channelDetails": [],
"protections": [],
"downstreamPerformance": null,
"metrics": {
"orders30d": null,
"orders7d": null,
"pickupRate48h": null,
"pickupRate24h": null,
"distributorCount": null,
"downstreamStoreCount": null,
"publishDate": null
}
},
"supports_sampling": false,
"is_out_of_stock": false,
"skus": [
{
"id": "•••",
"name": "Pro6蓝牙耳机 紫色",
"options": {
"颜色": "Pro6蓝牙耳机 紫色"
},
"price": 7.6,
"original_price": 7.6,
"stock": 665434,
"available": true,
"image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01ngwdIg1fNlJ87ZHWL_!!2218564053995-0-cib.jpg"
},
{
"id": "•••",
"name": "八代蓝牙耳机简配",
"options": {
"颜色": "八代蓝牙耳机简配"
},
"price": 9.6,
"original_price": 9.6,
"stock": 666024,
"available": true
},
{
"id": "•••",
"name": "Pro6蓝牙耳机 粉色",
"options": {
"颜色": "Pro6蓝牙耳机 粉色"
},
"price": 7.6,
"original_price": 7.6,
"stock": 664567,
"available": true,
"image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01VHBm431fNlJGJw3Jm_!!2218564053995-0-cib.jpg"
}
],
"images": [
"https://cbu01.alicdn.com/img/ibank/O1CN01RrMK531fNlLKVri2p_!!2218564053995-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01oiS7FO1fNlJFcPVcJ_!!2218564053995-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN019hrirk1fNlJGpWQke_!!2218564053995-0-cib.jpg"
],
"description_images": [
"https://cbu01.alicdn.com/img/ibank/O1CN01xDu8VE1fNlOMt4i8Z_!!2218564053995-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01mTmUSS1fNlONCMZWr_!!2218564053995-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01myoX5I1fNlONcSew0_!!2218564053995-0-cib.jpg"
],
"video_url": "https://cloud.video.taobao.com/play/u/2218564053995/p/2/e/6/t/1/482069395965.mp4",
"specs": [
{
"name": "芯片类型",
"value": "中科蓝讯"
},
{
"name": "功能",
"value": "防水,降噪,呼吸灯,超长续航,通话功能,语音控制,支持音乐,数显屏幕,电竞低延迟"
},
{
"name": "续航时间",
"value": "0-4小时"
}
],
"rating": 4.7,
"review_count": 20,
"positive_rate": 0.95,
"sold_display": "已售2.2万+件",
"want_buy_count": 127,
"category_path": "数码、电脑 > 手机配件 > 蓝牙耳机",
"services": [
"7天无理由退货",
"晚发必赔"
],
"winport_url": "https://winport.1688.com/page/index.html?memberId=b2b-2218564053995870c8&_tabId_=index&upstreamSource=od&offerId=873514490218",
"platform": "1688",
"rating_scale": 5
},
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}Поля ответа
Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.
| Поле | Значение |
|---|---|
id | Уникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться. |
url | Ссылка на запись на платформе. |
title | Заголовок. null, если на платформе нет заголовков (например, у текстовых постов). |
text | Основной текст без HTML возвращается полностью и никогда не обрезается (на нескольких платформах результаты списковых запросов содержат только фрагмент; это указано в примечаниях к полям платформы). |
price_min | Нижняя граница диапазона цен. |
price_max | Верхняя граница диапазона цен. |
currency | Код валюты цены (например, CNY, USD). Если price есть, а currency равно null, не делайте предположений о валюте. |
price_tiers | Ступенчатые цены: цена за единицу снижается с ростом объёма заказа. Рассматривайте каждый уровень вместе с указанным для него минимальным количеством. |
min_order_quantity | Минимальный объём заказа (MOQ). Первый порог при оптовых закупках на 1688: проверяйте его в первую очередь. |
stock | Остаток на складе. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
sold_count | Продано единиц. |
category | Название категории в собственной таксономии платформы, без приведения к единому виду между платформами. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
unit | Единица товара, за которую указана цена (штука, изделие, коробка и т. д.). |
supplier_name | Название поставщика. |
supplier_fans | Число подписчиков поставщика. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
supplier_founded_year | Год основания поставщика. |
supplier_type | Тип деятельности поставщика (например, производитель или оптовик). |
supplier_favorited_count | Сколько раз поставщика добавили в избранное. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
supports_dropship | Отправляет ли поставщик товары поштучно от вашего имени (дропшиппинг). Ключевой фильтр для продаж без собственного склада. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
supports_sampling | Предоставляет ли поставщик образцы. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
is_out_of_stock | Закончился ли товар на складе. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
skus | Сведения о вариантах, если они есть. Опции, цена, остаток и доступность в каждой записи возвращаются, только если они указаны в данных платформы; отсутствие значения не означает, что товара нет в наличии. В данных о товаре при синхронном вызове эти поля вариантов могут быть пустыми: weight_g, length_cm, width_cm, height_cm, volume_cm3, image_url, original_price; если они нужны, используйте асинхронный вызов. |
images | Ссылки на основные изображения товара в порядке на странице; в product_detail у некоторых карточек товара сюда также входят изображения вариантов (SKU), а изображения из блока описания находятся в description_images. Отсутствует, если изображений нет. |
description_images | Список URL изображений из подробного описания в том же порядке, что и в карточке товара; null, если таких изображений нет. |
video_url | URL видео товара, если оно есть в карточке товара. |
specs | Таблица характеристик товара: список пар {name, value} (например, Material: TPU). В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
rating | Общий рейтинг товара (1–5). В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
rating_scale | Максимальное значение шкалы поля rating в той же записи: 5 для пятизвёздочной шкалы, 10 для десятибалльной. Присутствует, только если в записи есть оценка. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
review_count | Общее число отзывов. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
positive_rate | Доля положительных отзывов, от 0 до 1 (0.999 соответствует 99,9%). В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
sold_display | Продажи в исходном виде (текст на китайском, например 100k+ sold); числовое значение есть в sold_count. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
want_buy_count | Число покупателей, отметивших, что хотят приобрести товар (сигнал спроса со стороны закупщиков). В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
category_path | Полный путь категории с названиями уровней на китайском (например, Digital > Phone accessories > Phone case, на языке источника). В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
services | Сервисные метки карточки товара (например, бесплатная доставка при возврате, компенсация за задержку доставки). В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
promotions | Названия действующих акций. |
customization_supported | Поддерживает ли поставщик кастомизацию (нанесение собственного дизайна, изготовление образцов). В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
winport_url | Ссылка на витрину поставщика на 1688. |
city | Название города на языке платформы, без нормализации. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
province | Провинция, где находится поставщик. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
supplier_years | Сколько лет поставщик работает на платформе 1688. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
package_dimensions | Трактуется так же, как на самой платформе |
coupons | Трактуется так же, как на самой платформе |
promotion_details | Трактуется так же, как на самой платформе |
service_details | Подробности сервисных гарантий: code (код услуги), name, description (правило), rule_url (страница правила). services / service_tags содержат только названия. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
purchase_limits | Трактуется так же, как на самой платформе |
mix_wholesale | Трактуется так же, как на самой платформе |
supports_mix | Трактуется так же, как на самой платформе |
review_tags | Теги впечатлений покупателей: [{tag, count}], например «мягкая ткань» ×2. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
refund_rate | Трактуется так же, как на самой платформе |
review_negative_count | Трактуется так же, как на самой платформе |
review_neutral_count | Трактуется так же, как на самой платформе |
review_with_photo_count | Число отзывов с фото; null означает, что значение не предоставлено, а не 0. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
review_with_text_count | Число отзывов с текстом; null означает, что значение не предоставлено, а не 0. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
supplier_stats | Профиль поставщика (только ключи со значениями): employee_count, plant_area_sqm (площадь фабрики в м²), plant_type (например, собственная фабрика), equipment_count (основное оборудование), product_count (товары в продаже), repeat_rate (доля повторных покупателей, 0–1), repeat_buyer_count_text / cross_border_buyer_count_text (повторные и трансграничные покупатели в отображаемом виде, например 300+), response_rate (0–1), positive_review_rate (0–1), fulfillment_rate (0–1), certificate_count / certificates / management_certificates (число сертификатов, их названия и сертификаты систем менеджмента), patent_count, oem_mode (OEM/ODM), own_brands (собственные бренды в отображаемом виде), brand_count, partner_brand, is_major_brand_partner (поставляет крупным брендам), scale_tier (категория по размеру), honors. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
supplier_scores | Трактуется так же, как на самой платформе |
supplier_metric_tags | Трактуется так же, как на самой платформе |
supplier_rank | Трактуется так же, как на самой платформе |
supplier_industry_belt | Сертификация поставщика в рамках промышленного кластера: description (например, флагманский продавец регионального швейного кластера, сертифицированный платформой 1688), link_url (страница сертификации). В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
supplier_certification | Сторонний аудит фабрики или компании: agency (код аудитора, например sgs или tuv), report_number (номер отчёта в том виде, в каком он указан), report_url (страница отчёта). В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
supplier_verification_tags | Трактуется так же, как на самой платформе |
supplier_inspection_report_url | Трактуется так же, как на самой платформе |
supplier_videos | Трактуется так же, как на самой платформе |
supplier_address | Адрес поставщика в том виде, в каком он указан. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
supplier_coordinates | Местоположение поставщика: {longitude, latitude}. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
supplier_main_category | Основная категория поставщика. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
customization | Трактуется так же, как на самой платформе |
shipping | Трактуется так же, как на самой платформе |
unit_weight_kg | Трактуется так же, как на самой платформе |
platform | Идентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok). |
FAQ
Как читать ступенчатые цены?
price_tiers перечисляет цену за единицу для каждого диапазона объёма: чем больше покупка, тем ниже цена. min_order_quantity — минимальный заказ, unit — единица измерения, для которой указана цена. Чтобы оценить стоимость, найдите диапазон, в который попадает планируемый объём.
Как отличить фабрику от торговой компании?
supplier_type показывает, является ли поставщик производителем или торговой компанией. Смотрите его вместе с supplier_founded_year, supplier_fans и supplier_favorited_count, чтобы оценить, как давно работает поставщик и насколько он популярен.
Если у варианта нет данных об остатках, он распродан?
Не обязательно. Опции, цены, остатки и доступность в skus возвращаются, только если их указывает платформа, поэтому отсутствие значения не означает, что вариант распродан. Наличие товара в целом проверяйте по is_out_of_stock. При синхронном вызове API поля stock, positive_rate, supports_dropship и другие поля (категория, отзывы, услуги, профиль поставщика, размер и вес вариантов; все они названы в списке полей) могут быть пустыми. Если они нужны, используйте асинхронный вызов API.
Ошибки и оплата
- 401
- Ключ отсутствует или недействителен.
- 402
- Недостаточно средств на балансе. Сначала пополните баланс.
- 422
- Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
- 429
- Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
- 503
- Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
- 200 (пусто)
- Нет данных. Без списания.
Официальные источники
Используются только для проверки объектов и терминов. Они не означают, что платформа разрешила или одобрила работу EveryInfra.
- 1688: товары, спецификации и минимальный объём заказа ↗
Документация 1688 по закупкам разделяет offerId товара, specId спецификации и количество закупки, а минимальный объём заказа проверяет отдельно. Эти термины приведены здесь только для пояснения; этот эндпоинт не создаёт заказы на закупку и не показывает их предпросмотр.
Проверено 2026-09-04