API 1688 Поиск товаров на платформе по изображению
Состояние API
- Состояние за 24 ч
- 98%
- Среднее время за 24 ч
- 43.51 s
- Стабильно / норма
- Доступно
- Ограничено
- Почти недоступно
Последние 24 часа
Последние 30 дней
Сопоставьте одно фото товара из image_url с каталогом 1688 и получите до пяти похожих оптовых предложений с названием, ценой в CNY, минимальным заказом, продавцом и ссылкой. rank показывает порядок совпадения для этого изображения, а не место в рейтинге продаж.
Возможность «Поиск по изображению 1688» ищет на 1688 похожие товары по одному изображению товара и возвращает для каждого совпадения название, цену, минимальный объём заказа, число заказов, название поставщика, изображение и позицию в списке совпадений. Используйте её, чтобы узнать, есть ли товар на 1688, кто его продаёт и по какой цене. С её помощью можно найти первоисточник готового товара или фотографии конкурента, сравнить цены на разных маркетплейсах либо подобрать альтернативных поставщиков.
Передайте в image_url одну общедоступную HTTPS-ссылку на изображение. В одном вызове можно выполнить поиск только по одному изображению. В результатах возвращаются внешне похожие варианты, но совпадение товара не гарантируется, поэтому перед заказом проверьте сведения о нём. rank указывает только позицию в списке совпадений, а не место в рейтинге продаж. Чтобы получить полные данные о вариантах, остатках и поставщике, используйте url из результата в запросе к возможности «Сведения о товаре 1688».
Цена: $5.56 за 1 000 запросов ($0.005556 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.
Промпт для ИИ
Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra 1688 Поиск товаров на платформе по изображению (alibaba1688/image_search).
Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: alibaba1688 и action: image_search, а параметры передайте в params.
- Обязательные параметры:
- image_url: Для image_search укажите один публичный HTTPS-URL изображения товара. Действие отправляет одно изображение, возвращает не более пяти подходящих предложений 1688 и не добавляет сведения о товаре или SKU.
- Необязательные параметры:
- limit: Максимальное число записей в этом вызове, целое число от 1 до 5. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. (по умолчанию: 5)
- Возвращает список записей. Основные поля каждой записи: id, url, title, price, currency, min_order_quantity (Минимальный объём заказа (MOQ)), order_count (Число заказов), supplier_name (Название поставщика), image_url, rank (Позиция предложения в списке совпадений…).
- Пример тела запроса:
{
"platform": "alibaba1688",
"action": "image_search",
"params": {
"image_url": "https://cbu01.alicdn.com/img/ibank/15418323391_1847764777.jpg"
}
}
- Цена: $5.56 за 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 | Да | image_search | Идентификатор возможности, фиксированное значение. |
image_url | body.params | string | Да | - | Для image_search укажите один публичный HTTPS-URL изображения товара. Действие отправляет одно изображение, возвращает не более пяти подходящих предложений 1688 и не добавляет сведения о товаре или SKU. |
limit | body.params | integer (1–5) | Нет | 5 | Максимальное число записей в этом вызове, целое число от 1 до 5. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. При значениях выше максимума эндпоинт возвращает ошибку 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": "image_search",
"params": {
"image_url": "https://cbu01.alicdn.com/img/ibank/15418323391_1847764777.jpg"
}
}'Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.
Пример ответа
Получено October 13, 2026 at 04:57 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты); в списке оставлены первые 2. id, billing и quota меняются при каждом вызове, поэтому показана только их структура.
{
"id": "req_…",
"platform": "alibaba1688",
"action": "image_search",
"results": [
{
"id": "•••",
"url": "https://detail.1688.com/offer/1087685101407.html",
"title": "pet toy Five pointed star toy TPR Star Relief Molar ring",
"price": 1.5,
"currency": "CNY",
"min_order_quantity": 50,
"order_count": 0,
"supplier_name": "徐州经济技术开发区俊飒宠物用品经营部",
"image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01YZTAXwRx8CF1chua_!!2223051725283-0-cib.jpg",
"rank": 1,
"platform": "1688"
},
{
"id": "•••",
"url": "https://detail.1688.com/offer/1006441717931.html",
"title": "狗狗玩具宠物发声玩具耐咬小狗幼犬狗狗磨牙洁齿训练搪胶玩具批发",
"price": 1.5,
"currency": "CNY",
"min_order_quantity": 2,
"order_count": 6771,
"supplier_name": "东阳市嘉瑞宝宠物用品有限公司",
"image_url": "https://cbu01.alicdn.com/O1CN01ltOurZ202KnOTWxaR_!!2216996446791-0-cib.jpg",
"rank": 2,
"platform": "1688"
}
],
"count": 5,
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}Поля ответа
Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.
| Поле | Значение |
|---|---|
id | Уникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться. |
url | Ссылка на запись на платформе. |
title | Заголовок. null, если на платформе нет заголовков (например, у текстовых постов). |
price | Цена числом без символа валюты; см. currency. |
currency | Код валюты цены (например, CNY, USD). Если price есть, а currency равно null, не делайте предположений о валюте. |
min_order_quantity | Минимальный объём заказа (MOQ). Первый порог при оптовых закупках на 1688: проверяйте его в первую очередь. |
order_count | Число заказов. |
supplier_name | Название поставщика. |
image_url | Ссылка на изображение. Возможности с несколькими изображениями могут возвращать массив image_urls. |
rank | Позиция предложения в списке совпадений для этого изображения; отражает только порядок в этом результате, а не рейтинг продаж. |
platform | Идентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok). |
FAQ
Какие изображения подходят?
Одна общедоступная HTTPS-ссылка, ведущая прямо на изображение товара; каждый вызов ищет по одному изображению. Изображения, доступные только после входа, адреса веб-страниц и локальные файлы не подходят. Чёткое фото товара на однотонном фоне обычно даёт более точные совпадения.
rank — это рейтинг продаж?
Нет. rank отражает только порядок результатов поиска по этому изображению: это не место в рейтинге продаж и не гарантия того, что первый результат — тот же товар. Оценивайте продажи товара по order_count.
Как получить данные о поставщике найденного товара?
В результатах поиска по изображению нет полных данных о вариантах, остатках и поставщике. Передайте url результата в «Сведения о товаре 1688», чтобы получить ступенчатые цены, минимальный заказ, сведения о вариантах и профиль поставщика.
Ошибки и оплата
- 401
- Ключ отсутствует или недействителен.
- 402
- Недостаточно средств на балансе. Сначала пополните баланс.
- 422
- Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
- 429
- Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
- 503
- Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
- 200 (пусто)
- Нет данных. Без списания.
Официальные источники
Используются только для проверки объектов и терминов. Они не означают, что платформа разрешила или одобрила работу EveryInfra.
- Открытая платформа 1688: поиск похожих товаров по изображению ↗
На открытой платформе 1688 описан официальный поиск похожих товаров, который принимает URL изображения или само изображение. Этот источник подтверждает только связь «изображение — товар» на уровне платформы; ограничение в одно изображение, максимум пять результатов, разрешённый набор полей ответа, тарификация и порядок выдачи результатов в EveryInfra определяются собственной опубликованной документацией EveryInfra.
Проверено 2026-09-21