amazon/
product-search

Ищите товары по фразе в поддерживаемом магазине Amazon и получайте нормализованные поля товара, продавца, цены, рейтинга, отзывов, числа продаж и медиафайлов.

Amazon Product Search API

Поиск товаров
Выбор магазина
Нормализованные записи
0,15 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Amazon Product Search

Amazon Product Search превращает поисковую фразу и URL магазина в нормализованные записи публичных товаров. Каждый элемент может содержать URL источника, название, описание, продавца, цену, рейтинг, число отзывов и продаж, медиафайлы, время публикации и время сбора, если эти значения доступны.

Возможности Amazon Product Search API

  • Запросы в рамках одного магазинаСочетайте непустой поисковый запрос с одним поддерживаемым доменом Amazon, чтобы нужный магазин был указан явно.
  • Контроль объема результатовЗадайте целое значение results_limit от 1 до 2 000; сбор останавливается на заданном лимите или когда в источнике больше нет записей.
  • Нормализованная идентификация товараПолучайте стабильные поля товара: ID, тип, URL источника, название, описание, время публикации и время сбора.
  • Коммерческий контекстИспользуйте доступные поля продавца, цены, рейтинга, числа отзывов, числа продаж и медиафайлов, не разбирая форматы результатов конкретных магазинов.

Параметры Amazon Product Search API

ПараметрыОбязательныйОписание
queryОбязательныйОбязательное непустое ключевое слово или фраза для поиска товара.
domainОбязательныйОбязательная ссылка на магазин Amazon. Распознанное имя хоста должно быть amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in, amazon.co.jp или их поддоменом. Принимаются любые схемы с именем хоста и ссылки относительно протокола.
results_limitНеобязательныйЗапрошенный лимит результатов от 1 до 2 000. Если не указан, по умолчанию 100.

Как использовать Amazon Product Search API

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

  1. Задайте непустой query, укажите URL поддерживаемого домена Amazon и выберите results_limit от 1 до 2 000.
  2. Отправьте запрос методом POST на /v1/amazon/product-search и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в состояние succeeded или failed.
  4. После успешного завершения читайте data.results.items и передавайте next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/amazon/product-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"wireless earbuds","domain":"https://www.amazon.com","results_limit":3}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Сценарии использования Amazon Product Search API

  • Поиск товаров в магазине: Находите публичные товары по категории, характеристике, бренду или фразе с покупательским намерением в одном поддерживаемом магазине Amazon.
  • Сравнение предложений: Сравнивайте доступные суммы цен, валюты, форматированные цены и данные продавцов у возвращенных товаров.
  • Оценка репутации: Изучайте доступные рейтинги, число отзывов и продаж, сохраняя отсутствующие показатели как недоступные.
  • Обогащение каталога: Дополняйте товары-кандидаты нормализованными названиями, описаниями, URL источника, медиафайлами, продавцами и временем сбора.

Практические советы по Amazon Product Search API

  • Сохраняйте отправленные query и domain с каждой задачей: одна и та же фраза может давать разные результаты в разных магазинах.
  • Выбирайте results_limit под нужный объем: от него зависит резерв на ожидаемые результаты, а итоговая оплата рассчитывается по возвращенным записям.
  • Следуйте next_cursor, пока has_more не станет false, если успешная задача содержит больше одной сохраненной страницы результатов.
  • Считайте отсутствующие значения продавца, цены, рейтинга, числа отзывов, числа продаж или медиафайлов недоступными, а не нулем или пустыми данными.

Помимо Amazon Product Search API, используйте эти API, когда нужен другой тип публичных данных Amazon.

  • Amazon Best Sellers API — Собирайте товары по публичным URL категорий Amazon Best Sellers: нормализованные поля продавца, цены, репутации, числа продаж, медиа, источника и метки времени.
  • Amazon Product Details API — Собирайте данные о товарах по известным URL Amazon: название, описание, продавец, цена, рейтинг, число отзывов, число продаж и медиа.
  • Amazon Reviews API — Собирайте публичные отзывы о товарах по поддерживаемым URL Amazon: текст, оценки, данные автора, ссылки на товар, метки времени и медиа.
  • Amazon Seller Info API — Собирайте по известным URL продавцов публичные данные профиля продавца Amazon: название, описание, сайт, рейтинг, отзывы покупателей, местоположение, источник и время сбора.
  • Amazon Storefront API — Читайте витрину автора на Amazon по ссылке на нее: профиль, связанные аккаунты в соцсетях, списки идей с числом товаров, подборки и популярные товары с ценами.

Другие платформы

Объединяйте данные Amazon с публичными данными других поддерживаемых соцсетей.

Amazon Product Search API — FAQ

Amazon Product Search API ищет товары по запросу в одном поддерживаемом магазине Amazon и возвращает нормализованные записи публичных товаров через асинхронную задачу.

Сервис проверяет распознанное имя хоста и принимает amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in и amazon.co.jp, включая поддомены. Принимаются любые схемы с именем хоста и ссылки относительно протокола.

query и domain — обязательные непустые строки. results_limit необязателен, по умолчанию равен 100 и должен быть целым числом от 1 до 2 000.

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

results_limit — это максимум. Сбор может завершиться раньше, если в публичном источнике больше нет подходящих записей, поэтому успешная задача может содержать меньше товаров или не содержать их вовсе.

Опрашивайте /v1/tasks/{task_id}, после успешного завершения читайте data.results.items и запрашивайте следующую страницу результатов задачи с next_cursor, пока has_more равно true.

Каждый успешно возвращенный нормализованный товар стоит 0,15 кредита SocQ. Запрос резервирует кредиты по results_limit (или по 100, если он не указан), затем рассчитывается по фактическому числу результатов и возвращает неиспользованные кредиты; за пустой результат плата не взимается.