API 1688
На этой странице для 1688 разделены поиск по ключевым словам, подбор товаров по одному изображению и сведения об одном предложении: search, image_search и product_detail.
Используйте search для товарных запросов. image_search подбирает для одного публичного изображения до пяти похожих предложений на 1688. product_detail возвращает SKU и ценовые пороги по количеству для одного конкретного предложения.
Доступность платформы
- Состояние за 24 ч
- 99%
За последние 30 дней
Доступные возможности
Все действия 1688: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Получите оптовые предложения 1688 по ключевому слову товара с диапазоном цен, минимальным объёмом заказа, числом заказов, долей повторных покупок и данными продавца. | $2.78 за 1 000 запросов | Работает стабильно · состояние 99% |
Сведения о товареproduct_detail | Получите одно предложение 1688 по ссылке на товар или числовому offerId: ступенчатые цены, минимальный объём заказа, остатки, варианты, характеристики, изображения и сведения о продавце. | $1.39 за 1 000 запросов | Работает стабильно · состояние 99% |
Поиск товаров на платформе по изображениюimage_search | Сопоставьте одно фото товара из image_url с каталогом 1688 и получите до пяти похожих оптовых предложений с названием, ценой в CNY, минимальным заказом, продавцом и ссылкой. | $5.56 за 1 000 запросов | Работает стабильно · состояние 98% |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API 1688?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Получите оптовые предложения 1688 по ключевому слову товара с диапазоном цен, минимальным объёмом заказа, числом заказов, долей повторных покупок и данными продавца. Ни порядок сортировки, ни | keyword | city, max_price, min_price, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $2.78 за 1 000 запросов | id · url · title · text · price_min · price_max · currency · min_order_quantity · order_count · repurchase_rate · category · city · province · supplier_name · is_out_of_stock · supports_dropship · images · supplier_type · supplier_years · supplier_shop_url · supplier_composite_score · sold_count_text · service_tags · product_badges · rating · rating_scale · review_count · positive_rate · sold_count · sold_display · want_buy_count · stock · unit · category_path · video_url · winport_url · supplier_fans · supplier_founded_year · price_tiers · specs · description_images · coupons · promotion_details · service_details · purchase_limits · mix_wholesale · supports_mix · review_tags · refund_rate · review_negative_count · review_neutral_count · review_with_photo_count · review_with_text_count · supplier_stats · supplier_scores · supplier_metric_tags · supplier_rank · supplier_industry_belt · supplier_certification · supplier_verification_tags · supplier_inspection_report_url · supplier_videos · supplier_address · supplier_coordinates · supplier_main_category · customization · shipping · unit_weight_kg · platform |
product_detailСведения о товаре Получите одно предложение 1688 по ссылке на товар или числовому offerId: ступенчатые цены, минимальный объём заказа, остатки, варианты, характеристики, изображения и сведения о продавце. По | url | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · url · title · text · price_min · price_max · currency · price_tiers · min_order_quantity · 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 · images · description_images · video_url · specs · rating · rating_scale · review_count · positive_rate · sold_display · want_buy_count · category_path · services · promotions · customization_supported · winport_url · city · province · supplier_years · package_dimensions · coupons · promotion_details · service_details · purchase_limits · mix_wholesale · supports_mix · review_tags · refund_rate · review_negative_count · review_neutral_count · review_with_photo_count · review_with_text_count · supplier_stats · supplier_scores · supplier_metric_tags · supplier_rank · supplier_industry_belt · supplier_certification · supplier_verification_tags · supplier_inspection_report_url · supplier_videos · supplier_address · supplier_coordinates · supplier_main_category · customization · shipping · unit_weight_kg · platform |
image_searchПоиск товаров на платформе по изображению Сопоставьте одно фото товара из | image_url | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=5, maxLimit=5. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $5.56 за 1 000 запросов | id · url · title · price · currency · min_order_quantity · order_count · supplier_name · image_url · rank · platform |
Что означают параметры действия search в API 1688?
Получите оптовые предложения 1688 по ключевому слову товара с диапазоном цен, минимальным объёмом заказа, числом заказов, долей повторных покупок и данными продавца. Ни порядок сортировки, ни order_count не подтверждают точные продажи или окончательную цену.
keywordОбязательный- Задаёт поисковый запрос для оптовых товаров 1688 (например, термокружки или картонные коробки). Используйте названия товаров, а не названия магазинов или offerIds; минимальный объём заказа и цены по уровням возвращаются в сведениях о товаре.
cityНеобязательный- Фильтрует запросы оптовых товаров 1688 по названию города. Фильтр не связан с местоположением аккаунта, не меняет возвращаемые адреса продавцов и не гарантирует сохранения фильтрации в запросах сведений об отдельном товаре.
max_priceНеобязательный- Фильтрует оптовые товары по максимальной цене за единицу в виде числа. Допускаются дробные значения; если вызов переходит на фильтрацию по целым юаням, они округляются вверх (145.98 становится 146), поэтому диапазон только расширяется. Параметр работает вместе с min_price и ограничивает диапазон цен, а не объёмы заказа по ценовым уровням; он может не охватывать все варианты SKU и уровни оптовых скидок.
min_priceНеобязательный- Фильтрует оптовые товары по минимальной цене за единицу в виде числа. Допускаются дробные значения; если вызов переходит на фильтрацию по целым юаням, они округляются вниз (39.81 становится 39), поэтому диапазон только расширяется. Параметр задаёт критерии товара, а не минимальный объём заказа или лимит расходов на API; возвращаемые цены по уровням зависят от объёма заказа.
sortНеобязательный- Сортирует товары в поиске: relevance (по умолчанию для search), popular, price_asc или price_desc. Критерии сортировки не гарантируют наличия в ответе точных данных о продажах или общей сумме сделок.Допустимые значения:
popularprice_ascprice_descrelevance
Что означают параметры действия product_detail в API 1688?
Получите одно предложение 1688 по ссылке на товар или числовому offerId: ступенчатые цены, минимальный объём заказа, остатки, варианты, характеристики, изображения и сведения о продавце. По price_tiers видно, как цена за единицу снижается с ростом объёма, а отсутствие поля варианта не означает, что этого варианта нет в наличии.
urlОбязательный- Для product_detail используйте URL товара на detail.1688.com или m.1688.com, сообщение, сформированное функцией «Поделиться» и содержащее ровно один URL товара, или числовой offerId. Ссылка «Поделиться» вида qr.1688.com принимается, только если она безопасно ведёт на страницу товара. Страницы магазинов и поиска отклоняются.1688: товары, спецификации и минимальный объём заказа — Документация 1688 по закупкам разделяет offerId товара, specId спецификации и количество закупки, а минимальный объём заказа проверяет отдельно. Эти термины приведены здесь только для пояснения; этот эндпоинт не создаёт заказы на закупку и не показывает их предпросмотр. · Проверено
Что означают параметры действия image_search в API 1688?
Сопоставьте одно фото товара из image_url с каталогом 1688 и получите до пяти похожих оптовых предложений с названием, ценой в CNY, минимальным заказом, продавцом и ссылкой. rank показывает порядок совпадения для этого изображения, а не место в рейтинге продаж.
image_urlОбязательный- Для image_search укажите один публичный HTTPS-URL изображения товара. Действие отправляет одно изображение, возвращает не более пяти подходящих предложений 1688 и не добавляет сведения о товаре или SKU.Открытая платформа 1688: поиск похожих товаров по изображению — На открытой платформе 1688 описан официальный поиск похожих товаров, который принимает URL изображения или само изображение. Этот источник подтверждает только связь «изображение — товар» на уровне платформы; ограничение в одно изображение, максимум пять результатов, разрешённый набор полей ответа, тарификация и порядок выдачи результатов в EveryInfra определяются собственной опубликованной документацией EveryInfra. · Проверено
Как использовать API 1688
- 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":"alibaba1688","action":"search","params":{"keyword":"<keyword>"}}'
Руководства по API 1688
Практические примеры и методики на основе этих действий. Сначала сверьтесь с актуальными действиями, параметрами и полями на этой странице: примеры и ограничения из статьи не заменяют актуальный каталог.
Монетизация парсинга цен: как построить продукт мониторинга цен, который продавцы будут продлевать
Почему продавцы платят за мониторинг цен и почему отменяют подписку. Разбираем способы поставки ценовых данных, единицы тарификации и приёмку пилота через сопоставление товаров, списки исключений и процессы согласования цен.
Читать статьюБыстрый старт с единым API данных: от каталога возможностей к первому полученному результату
Получайте данные с разных платформ через platform, action и params: изучите каталог возможностей, выполните минимальные запросы, обработайте асинхронные задачи и частичные результаты, учтите оплату и обеспечьте прослеживаемость записей данных.
Читать статьюСбои API, возврат кредитов и сверка: как проверить чистое списание за запрос
Разделяйте задачи, попытки вызова, состояния доставки и события кошелька, чтобы без двойного учёта обрабатывать отказы до списания, пустые результаты и частичный возврат кредитов; офлайн-примеры построены на целых числах.
Читать статьюВопросы об API 1688
Какие данные можно получить через API 1688?
Укажите в platform значение alibaba1688. В текущем каталоге: поиск, сведения о товаре и поиск товаров на платформе по изображению. Эти названия действий соответствуют разным объектам или представлениям 1688; это не взаимозаменяемые режимы поиска.
Есть ли у 1688 официальный API?
1688 Open Platform от Alibaba предназначена для разработчиков ПО, которые создают инструменты для продавцов на 1688 и для покупателей, закупающих товары на 1688 или работающих с ним по дропшиппингу: например, для работы с карточками товаров, управления заказами и трансграничных закупок. В её каталоге более 1 600 партнёров-разработчиков.
Официальные источники: «1688 Open Platform» · Проверено
Нужен ли аккаунт разработчика 1688 или API-ключ?
Нет. Запросы идут через EveryInfra с API-ключом EveryInfra: зарегистрируйтесь, создайте ключ в консоли и передавайте его в заголовке Authorization: Bearer <API_KEY>. Вам не нужно регистрировать приложение разработчика 1688, запрашивать доступ к API 1688 или входить через аккаунт 1688. Действия возвращают только публичные данные 1688.
Сколько стоит 1688 API за 1 000 запросов?
От $1.39 за 1 000 запросов в зависимости от действия; цена каждого действия указана в таблице на этой странице и в публичном каталоге. Подписки нет: вы пополняете баланс в USD и платите за каждый вызов, а неудачные вызовы и пустые результаты не оплачиваются.
Какие входные данные нужны для запроса search к платформе 1688?
Задаёт поисковый запрос для оптовых товаров 1688 (например, термокружки или картонные коробки). Используйте названия товаров, а не названия магазинов или offerIds; минимальный объём заказа и цены по уровням возвращаются в сведениях о товаре. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе 1688?
Объявленная схема включает title, text, price_min и price_max. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия 1688 возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.