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, отслеживайте асинхронную задачу и читайте нормализованные записи продавцов из постраничного результата задачи.
- Скопируйте один или несколько публичных URL профилей продавцов Amazon с поддерживаемого маркетплейса.
- Отправьте массив urls методом POST на /v1/amazon/seller-info и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте 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 или по публичному значению профиля.
Связанные API
Помимо 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 по ссылке на нее: профиль, связанные аккаунты в соцсетях, списки идей с числом товаров, подборки и популярные товары с ценами.