Amazon Product Details
Товары Amazon — это публичные позиции каталога, которые описываются идентификаторами, названиями, описаниями, сведениями о продавце, ценами, рейтингами, числом отзывов и продаж, а также медиафайлами. Эти поля помогают обогащать каталоги, сравнивать товары, проверять источники и готовить отчеты о состоянии товаров на определенный момент.
Возможности Amazon Product Details API
- Пакетный поиск по известным URL товаровОтправляйте один или несколько URL Amazon в одной задаче и получайте не больше нормализованных записей товаров, чем передано корректных URL.
- Идентификация, описание и медиафайлы товараКаждая запись может содержать идентификатор и URL товара, название, описание, время сбора и доступные ссылки на изображения или видео.
- Продавец, цена и видимые показатели товараВложенные объекты продавца и цены идут рядом с полями рейтинга, числа отзывов и заявленного числа продаж, что упрощает единообразную обработку по полям.
- Поддерживаемые хосты маркетплейсов AmazonВалидатор URL принимает хосты Amazon для США, Великобритании, Германии, Франции, Испании, Италии, Канады, Австралии, Индии и Японии, включая их поддомены.
Параметры Amazon Product Details API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательный непустой массив известных ссылок на товары Amazon. Распознанное имя хоста должно быть amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in, amazon.co.jp или их поддоменом. Принимаются любые схемы с именем хоста и ссылки относительно протокола. |
Как использовать Amazon Product Details API
Отправьте известные URL товаров, сохраните ID асинхронной задачи и после ее успешного завершения читайте нормализованные записи товаров.
- Отправьте массив urls методом POST на /v1/amazon/product-detail с Bearer-токеном или API-ключом.
- Сохраните возвращенный task_id и опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- После успешного завершения читайте data.results.items; если has_more равно true, запрашивайте следующую страницу результатов с next_cursor, не создавая новую задачу по товарам.
curl -X POST "https://api.socq.ai/v1/amazon/product-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.amazon.com/dp/B0CHHSFMRL"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; follow next_cursor only while has_more is trueСценарии использования Amazon Product Details API
- Обогащение каталога известными товарами: Добавляйте названия товаров, описания, сведения о продавце, цены, медиафайлы, рейтинги и счетчики к уже имеющемуся набору URL Amazon.
- Сравнение товаров на определенный момент: Сравнивайте нормализованные поля цены, валюты, рейтинга, числа отзывов, числа продаж и продавца у выбранных записей товаров, собранных в одно и то же время.
- Проверка источников товаров: Используйте идентификаторы, канонические URL, названия, описания, ссылки на медиафайлы и время сбора, чтобы сверять сохраненные ссылки каталога с публичными страницами товаров.
Практические советы по Amazon Product Details API
- Используйте ссылки на товары, у которых распознанное имя хоста относится к поддерживаемому маркетплейсу Amazon; корректный хост сам по себе не гарантирует, что по ссылке найдется публичная запись товара.
- Не передавайте results_limit: этот эндпоинт приравнивает лимит результатов поставщика к числу отправленных URL.
- Считайте поля продавца, цены, рейтинга, числа отзывов, числа продаж, медиафайлов, URL и времени публикации допускающими null и сохраняйте успешную задачу с нулем элементов, не создавая данные-заглушки.
- Используйте next_cursor только для постраничного чтения сохраненных результатов задачи; продолжайте GET-запросы по той же задаче, а не повторяйте платный POST.
Связанные API
Помимо Amazon Product Details API, используйте эти API, когда нужен другой тип публичных данных Amazon.
- Amazon Best Sellers API — Собирайте товары по публичным URL категорий Amazon Best Sellers: нормализованные поля продавца, цены, репутации, числа продаж, медиа, источника и метки времени.
- Amazon Product Search API — Ищите товары в поддерживаемой витрине Amazon по фразе и получайте нормализованные поля товара, продавца, цены, рейтинга, отзывов, числа продаж, медиа и источника, если они доступны.
- Amazon Reviews API — Собирайте публичные отзывы о товарах по поддерживаемым URL Amazon: текст, оценки, данные автора, ссылки на товар, метки времени и медиа.
- Amazon Seller Info API — Собирайте по известным URL продавцов публичные данные профиля продавца Amazon: название, описание, сайт, рейтинг, отзывы покупателей, местоположение, источник и время сбора.
- Amazon Storefront API — Читайте витрину автора на Amazon по ссылке на нее: профиль, связанные аккаунты в соцсетях, списки идей с числом товаров, подборки и популярные товары с ценами.