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

API 1688 Поиск товаров на платформе по изображению

POST

Состояние API

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

Сопоставьте одно фото товара из 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 время и повторите попытку.

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

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

ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаalibaba1688Идентификатор платформы, фиксированное значение.
actionbodystringДаimage_searchИдентификатор возможности, фиксированное значение.
image_urlbody.paramsstringДа-Для image_search укажите один публичный HTTPS-URL изображения товара. Действие отправляет одно изображение, возвращает не более пяти подходящих предложений 1688 и не добавляет сведения о товаре или SKU.
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": "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 меняются при каждом вызове, поэтому показана только их структура.

json
{
  "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