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
Выберите нужный магазин и конкретную фразу для поиска товара, затем отправьте один асинхронный запрос.
- Задайте непустой query, укажите URL поддерживаемого домена Amazon и выберите results_limit от 1 до 2 000.
- Отправьте запрос методом POST на /v1/amazon/product-search и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в состояние succeeded или failed.
- После успешного завершения читайте 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, если успешная задача содержит больше одной сохраненной страницы результатов.
- Считайте отсутствующие значения продавца, цены, рейтинга, числа отзывов, числа продаж или медиафайлов недоступными, а не нулем или пустыми данными.
Связанные API
Помимо 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 по ссылке на нее: профиль, связанные аккаунты в соцсетях, списки идей с числом товаров, подборки и популярные товары с ценами.