amazon/
seller-info

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

Amazon Seller Info API

Данные профиля продавца
Поддерживаемые маркетплейсы
Одна запись на URL
0,15 кредита за результат
Готово
Готово

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

README

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

Amazon Seller Info

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

Возможности Amazon Seller Info API

  • Сбор по известным URL продавцовОтправляйте один или несколько публичных URL профилей продавцов с десяти поддерживаемых маркетплейсов Amazon, включая США, Великобританию, ЕС, Канаду, Австралию, Индию и Японию.
  • Стабильная идентификация продавцаПолучайте ID продавца, публичный URL, имя продавца или название компании, описание, связанный сайт и время сбора в одной фиксированной структуре результата.
  • Публичные показатели репутацииСохраняйте значения rating и feedback_count в том виде, в каком их сообщает источник, когда Amazon их показывает, без расчета или заполнения отсутствующих показателей.
  • Местоположение на маркетплейсеСохраняйте доступные поля названия местоположения, города, региона, страны, широты и долготы; любое необязательное поле местоположения может оставаться null.

Параметры Amazon Seller Info API

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

Как использовать Amazon Seller Info API

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

  1. Скопируйте один или несколько публичных URL профилей продавцов Amazon с поддерживаемого маркетплейса.
  2. Отправьте массив urls методом POST на /v1/amazon/seller-info и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте data.results.items и следуйте next_cursor, только если has_more равно true.
curl -X POST "https://api.socq.ai/v1/amazon/seller-info" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.amazon.com/sp?seller=A2L77EE7U53NWQ"]}'

# Poll GET /v1/tasks/{task_id}
# Read normalized sellers from data.results.items

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

  • Сопоставление данных продавцов: Превращайте подготовленный список URL профилей продавцов в единообразные ID продавцов, имена, публичные URL, сайты и сведения о маркетплейсе.
  • Снимки репутации: Фиксируйте публичный рейтинг, общее число отзывов и время collected_at для воспроизводимого сравнения во времени, не считая эти значения потоком данных в реальном времени.
  • Проверка поставщиков маркетплейса: Формируйте очередь проверки, в которой публичное описание продавца, сайт, местоположение и показатели отзывов привязаны к URL исходного профиля.

Практические советы по Amazon Seller Info API

  • Отправляйте канонические ссылки на профили продавцов вида /sp?seller={seller_id}; страницы товаров и поиска проходят проверку хоста, но не подходят как входные данные для получения сведений о продавце.
  • Не передавайте results_limit. Бэкенд создает по одному входу на каждый URL и ограничивает число сохраненных результатов количеством отправленных непустых URL.
  • Один принятый URL может вернуть ноль или одну запись продавца. Поэтому из-за отсутствующих или недоступных страниц result_count может оказаться меньше числа URL.
  • Считайте rating и feedback_count снимками данных, которые сообщает источник, и используйте collected_at при сравнении повторных сборов.
  • Поля местоположения и сайт необязательны. Не делайте выводов о юридическом присутствии, владельце или верификации по значению null или по публичному значению профиля.

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

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

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

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

Amazon Seller Info API — FAQ

Amazon Seller Info API — это интерфейс на основе URL, который собирает публично доступные поля профилей продавцов Amazon в нормализованную схему продавца. Он не обращается к закрытым данным аккаунтов Seller Central.

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

Нет. Каждый отправленный непустой URL становится одним входом и может дать не более одной сохраненной записи продавца, но недоступные, отклоненные поставщиком или пустые страницы могут не вернуть записи.

Нет. Поле results_limit в запросе не принимается, а поставщик получает по одной строке на каждый URL. При этом эндпоинт результатов задачи всё равно может разбивать сохраненные элементы на страницы с помощью limit и next_cursor.

Каждая успешно возвращенная запись продавца стоит 0,15 кредита SocQ. Запрос резервирует 0,15 кредита за каждый отправленный URL, затем рассчитывается по фактическому result_count. Для успешного пустого результата действует нулевая базовая плата, а неиспользованный резерв возвращается.