amazon/
product-detail

Собирайте публичные данные о товарах Amazon по известным URL: названия, описания, продавцы, цены, рейтинги, число отзывов и продаж и медиафайлы в виде нормализованных записей.

Amazon Product Details API

Известные URL товаров
Несколько маркетплейсов
Нормализованные записи товаров
0,15 кредита за результат
Готово
Готово

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

README

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

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 асинхронной задачи и после ее успешного завершения читайте нормализованные записи товаров.

  1. Отправьте массив urls методом POST на /v1/amazon/product-detail с Bearer-токеном или API-ключом.
  2. Сохраните возвращенный task_id и опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  3. После успешного завершения читайте 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.

Помимо 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 по ссылке на нее: профиль, связанные аккаунты в соцсетях, списки идей с числом товаров, подборки и популярные товары с ценами.

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

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

Amazon Product Details API — FAQ

Amazon Product Details API — это программный интерфейс для сбора публичных данных о товарах по известным ссылкам Amazon. Он возвращает нормализованные идентификаторы, названия, описания, объекты продавца и цены, рейтинги, число отзывов и продаж, медиафайлы и метаданные сбора.

Передайте непустой массив urls с URL товаров Amazon. Сервис принимает хосты Amazon для США, Великобритании, Германии, Франции, Испании, Италии, Канады, Австралии, Индии и Японии, включая поддомены.

Да. Добавьте несколько известных URL в массив urls. Лимит результатов поставщика равен числу отправленных URL, а некорректные, недоступные или ошибочные строки могут уменьшить число успешных результатов.

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

Пагинация применяется при чтении сохраненных результатов после успешного завершения задачи, а не при отправке URL товаров. Следуйте next_cursor в GET /v1/tasks/{task_id} только пока has_more равно true.

Запрос резервирует ориентировочно 0,15 кредита за каждый отправленный URL, а итоговый расчет идет по 0,15 кредита за каждую успешно возвращенную запись товара. При нулевой базовой ставке и политике пустых результатов, учитывающей только базовую ставку, задача без возвращенных записей обходится в ноль кредитов.