API 1688 Поиск
Состояние API
- Состояние за 24 ч
- 99%
- Среднее время за 24 ч
- 21.41 s
- Стабильно / норма
- Доступно
- Ограничено
- Почти недоступно
Последние 24 часа
Последние 30 дней
Получите оптовые предложения 1688 по ключевому слову товара с диапазоном цен, минимальным объёмом заказа, числом заказов, долей повторных покупок и данными продавца. Ни порядок сортировки, ни order_count не подтверждают точные продажи или окончательную цену.
Возможность «Поиск 1688» находит оптовые товары по keyword и возвращает для каждого название, диапазон цен, минимальный объём заказа, число продаж, долю повторных покупок, название поставщика, местоположение, тип бизнеса и срок работы на платформе, наличие и поддержку дропшиппинга. Используйте её, чтобы понять, какие поставщики предлагают товар и каковы примерные условия заказа и цены. Это первый шаг при поиске поставщиков, их сравнении или подборе товаров для дропшиппинг-магазина.
Ограничьте цену параметрами min_price и max_price, отфильтруйте по городу через city и задайте порядок через sort (по релевантности, продажам или цене по возрастанию или убыванию). Сначала смотрите min_order_quantity: это первый порог при оптовой закупке. repurchase_rate и supplier_composite_score позволяют отсеять поставщиков, не открывая карточки товаров. Фильтры по цене не гарантируют, что все варианты и ценовые уровни по объёму попадут в диапазон; значение имеют ступенчатые цены в сведениях о товаре.
Цена: $2.78 за 1 000 запросов ($0.002778 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.
Промпт для ИИ
Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra 1688 Поиск (alibaba1688/search).
Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: alibaba1688 и action: search, а параметры передайте в params.
- Обязательные параметры:
- keyword: Задаёт поисковый запрос для оптовых товаров 1688 (например, термокружки или картонные коробки). Используйте названия товаров, а не названия магазинов или offerIds.
- Необязательные параметры:
- city: Фильтрует запросы оптовых товаров 1688 по названию города. Фильтр не связан с местоположением аккаунта, не меняет возвращаемые адреса продавцов и не гарантирует сохранения фильтрации в запросах сведений об отдельном това…
- max_price: Фильтрует оптовые товары по максимальной цене за единицу в виде числа. Допускаются дробные значения.
- min_price: Фильтрует оптовые товары по минимальной цене за единицу в виде числа. Допускаются дробные значения.
- sort: Сортирует товары в поиске: relevance (по умолчанию для search), popular, price_asc или price_desc. Критерии сортировки не гарантируют наличия в ответе точных данных о продажах или общей сумме сделок. (допустимые значения: popular / price_asc / price_desc / relevance)
- limit: Максимальное число записей в этом вызове, целое число от 1 до 100. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. (по умолчанию: 20)
- Возвращает список записей. Основные поля каждой записи: id, url, title, text, price_min (Нижняя граница диапазона цен), price_max (Верхняя граница диапазона цен), currency, min_order_quantity (Минимальный объём заказа (MOQ)), order_count (Число заказов), repurchase_rate (Доля повторных покупок), category (Название категории в собственной таксон…), city (Название города на языке платформы, без…); всего полей: 68, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=alibaba1688.
- Пример тела запроса:
{
"platform": "alibaba1688",
"action": "search",
"params": {
"keyword": "不锈钢保温杯"
}
}
- Цена: $2.78 за 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 | Да | search | Идентификатор возможности, фиксированное значение. |
keyword | body.params | string | Да | - | Задаёт поисковый запрос для оптовых товаров 1688 (например, термокружки или картонные коробки). Используйте названия товаров, а не названия магазинов или offerIds; минимальный объём заказа и цены по уровням возвращаются в сведениях о товаре. |
city | body.params | string | Нет | - | Фильтрует запросы оптовых товаров 1688 по названию города. Фильтр не связан с местоположением аккаунта, не меняет возвращаемые адреса продавцов и не гарантирует сохранения фильтрации в запросах сведений об отдельном товаре. |
max_price | body.params | number | Нет | - | Фильтрует оптовые товары по максимальной цене за единицу в виде числа. Допускаются дробные значения; если вызов переходит на фильтрацию по целым юаням, они округляются вверх (145.98 становится 146), поэтому диапазон только расширяется. Параметр работает вместе с min_price и ограничивает диапазон цен, а не объёмы заказа по ценовым уровням; он может не охватывать все варианты SKU и уровни оптовых скидок. |
min_price | body.params | number | Нет | - | Фильтрует оптовые товары по минимальной цене за единицу в виде числа. Допускаются дробные значения; если вызов переходит на фильтрацию по целым юаням, они округляются вниз (39.81 становится 39), поэтому диапазон только расширяется. Параметр задаёт критерии товара, а не минимальный объём заказа или лимит расходов на API; возвращаемые цены по уровням зависят от объёма заказа. |
sort | body.params | string (enum) | Нет | - | Сортирует товары в поиске: relevance (по умолчанию для search), popular, price_asc или price_desc. Критерии сортировки не гарантируют наличия в ответе точных данных о продажах или общей сумме сделок.Допустимые значенияpopularprice_ascprice_descrelevance |
limit | body.params | integer (1–100) | Нет | 20 | Максимальное число записей в этом вызове, целое число от 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": "alibaba1688",
"action": "search",
"params": {
"keyword": "不锈钢保温杯"
}
}'Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.
Пример ответа
Получено October 13, 2026 at 04:57 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты); в списке оставлены первые 2. id, billing и quota меняются при каждом вызове, поэтому показана только их структура.
{
"id": "req_…",
"platform": "alibaba1688",
"action": "search",
"results": [
{
"id": "•••",
"url": "https://detail.1688.com/offer/901095512547.html",
"title": "跨境美式太空壶304不锈钢双层真空保温杯大容量运动水壶登山水壶",
"price_min": 12.5,
"currency": "CNY",
"order_count": 33,
"repurchase_rate": 20,
"city": "永康市",
"province": "浙江",
"supplier_name": "永康市钛霖杯业有限公司",
"images": [
"https://cbu01.alicdn.com/img/ibank/O1CN01LbpPbm2B0StIPXCWn_!!2219521848276-0-cib.jpg"
],
"supplier_type": "生产加工",
"supplier_years": 2,
"supplier_shop_url": "https://shop81l5635to8463.1688.com",
"sold_count_text": "已售1200+件",
"service_tags": [
"退货包运费",
"先采后付",
"回头率54%"
],
"product_badges": [
"先采后付"
],
"platform": "1688"
},
{
"id": "•••",
"url": "https://detail.1688.com/offer/1080785307425.html",
"title": "新款彩色304不锈钢保温杯 便携手提弹跳盖户外便携运动水杯定 制",
"price_min": 24,
"currency": "CNY",
"min_order_quantity": 1,
"order_count": 49,
"repurchase_rate": 14,
"city": "金华市",
"province": "浙江",
"supplier_name": "永康市大表哥工贸有限公司",
"images": [
"https://cbu01.alicdn.com/img/ibank/O1CN01NbBs3QLcV7L3thOC_!!2217763939489-0-cib.jpg"
],
"supplier_type": "生产加工",
"supplier_years": 3,
"supplier_shop_url": "https://15727971454.1688.com",
"sold_count_text": "已售500+件",
"service_tags": [
"退货包运费",
"先采后付",
"回头率67%"
],
"product_badges": [
"7×24H响应",
"先采后付"
],
"platform": "1688"
}
],
"count": 20,
"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, не делайте предположений о валюте. |
min_order_quantity | Минимальный объём заказа (MOQ). Первый порог при оптовых закупках на 1688: проверяйте его в первую очередь. |
order_count | Число заказов. |
repurchase_rate | Доля повторных покупок. Один из самых надёжных сигналов качества поставщика на 1688. |
category | Название категории в собственной таксономии платформы, без приведения к единому виду между платформами. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
city | Название города на языке платформы, без нормализации. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
province | Провинция, где находится поставщик. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
supplier_name | Название поставщика. |
is_out_of_stock | Закончился ли товар на складе. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
supports_dropship | Отправляет ли поставщик товары поштучно от вашего имени (дропшиппинг). Ключевой фильтр для продаж без собственного склада. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
images | Ссылки на основные изображения товара в порядке на странице; в product_detail у некоторых карточек товара сюда также входят изображения вариантов (SKU), а изображения из блока описания находятся в description_images. Отсутствует, если изображений нет. |
supplier_type | Тип деятельности поставщика (например, производитель или оптовик). |
supplier_years | Сколько лет поставщик работает на платформе 1688. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
supplier_shop_url | Ссылка на магазин поставщика. |
supplier_composite_score | Комплексная оценка сервиса поставщика (1–5). |
sold_count_text | Продажи в исходном виде в записях поиска (текст на китайском, например 100+ sold network-wide). |
service_tags | Список сервисных меток в записях поиска. |
product_badges | Список значков товара в записях поиска (например, 7×24H response). |
rating | Общий рейтинг товара (1–5). В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
rating_scale | Максимальное значение шкалы поля rating в той же записи: 5 для пятизвёздочной шкалы, 10 для десятибалльной. Присутствует, только если в записи есть оценка. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
review_count | Общее число отзывов. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
positive_rate | Доля положительных отзывов, от 0 до 1 (0.999 соответствует 99,9%). В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
sold_count | Продано единиц. |
sold_display | Продажи в исходном виде (текст на китайском, например 100k+ sold); числовое значение есть в sold_count. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
want_buy_count | Число покупателей, отметивших, что хотят приобрести товар (сигнал спроса со стороны закупщиков). В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
stock | Остаток на складе. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
unit | Единица товара, за которую указана цена (штука, изделие, коробка и т. д.). |
category_path | Полный путь категории с названиями уровней на китайском (например, Digital > Phone accessories > Phone case, на языке источника). В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
video_url | URL видео товара, если оно есть в карточке товара. |
winport_url | Ссылка на витрину поставщика на 1688. |
supplier_fans | Число подписчиков поставщика. В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
supplier_founded_year | Год основания поставщика. |
price_tiers | Ступенчатые цены: цена за единицу снижается с ростом объёма заказа. Рассматривайте каждый уровень вместе с указанным для него минимальным количеством. |
specs | Таблица характеристик товара: список пар {name, value} (например, Material: TPU). В данных о товаре при синхронном вызове поле может быть пустым; если оно нужно, используйте асинхронный вызов. |
description_images | Список URL изображений из подробного описания в том же порядке, что и в карточке товара; null, если таких изображений нет. |
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
Почему отфильтрованные цены не совпадают со страницей товара?
Цены на 1688 ступенчатые: цена за единицу зависит от объёма покупки. min_price и max_price фильтруют по цене, показанной в поиске, и не гарантируют, что каждый вариант или ценовой уровень попадёт в диапазон. Итоговое ценовое предложение определяется ступенчатыми ценами в сведениях о товаре.
По чему фильтрует city?
Он фильтрует товары по тексту названия города. Это не местоположение вашего аккаунта, и он не меняет возвращаемые адреса поставщиков. Откуда отправляется товар, смотрите в city и province каждого результата.
Как найти поставщиков с дропшиппингом?
Оставьте результаты, где supports_dropship равно true, затем проверьте min_order_quantity и is_out_of_stock, чтобы понять, можно ли заказывать небольшими партиями и есть ли товар в наличии. Высокое значение repurchase_rate и большое значение supplier_years — хорошие признаки того, что поставщик стабильно выполняет заказы.
Ошибки и оплата
- 401
- Ключ отсутствует или недействителен.
- 402
- Недостаточно средств на балансе. Сначала пополните баланс.
- 422
- Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
- 429
- Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
- 503
- Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
- 200 (пусто)
- Нет данных. Без списания.