Amazon Storefront
Amazon storefront — это витрина, которую участник программы Amazon Influencer ведет под собственным названием магазина: товары в ней сгруппированы в списки идей и подборки, а рядом размещены описание, фото профиля, ссылки на соцсети и ряд популярных товаров. По витрине видно, кто автор, где еще он публикуется, как устроены его рекомендации и какие товары он продвигает прямо сейчас и по какой цене.
Возможности Amazon Storefront API
- Профиль и отметка топ-автораname, text и avatar_url дают отображаемое имя, описание витрины и фото профиля, а is_top_creator показывает, отмечает ли Amazon автора как топового.
- Связанные аккаунты в соцсетяхsocial_urls содержит ссылки на профили в TikTok, YouTube, Pinterest и других сетях, размещенные в шапке витрины.
- Списки идей с числом товаровlists возвращает каждый список идей с первой страницы витрины с названием, ссылкой, обложкой и items_count — количеством товаров в нем.
- Подборкиcurations возвращает подборки автора с названием, ссылкой, обложкой и posts_count — числом товаров, собранных в каждой.
- Популярные товары с ценамиtrending_picks возвращает товары, которые витрина сейчас выделяет, и для каждого дает ссылку в витрине, изображение, текущую цену в валюте площадки и показанную скидку.
Параметры Amazon Storefront API
| Параметры | Обязательный | Описание |
|---|---|---|
url | Обязательный | Ссылка на витрину автора на Amazon в формате https://www.amazon.com/shop/<name>; ссылки на витрины других площадок Amazon работают так же. |
Как использовать Amazon Storefront API
Отправьте ссылку на витрину и прочитайте ее как одну строку результата.
- Отправьте POST-запрос на /v1/amazon/shop, передав в поле url ссылку на витрину, например https://www.amazon.com/shop/sydneydelrey.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Прочитайте витрину из results.items; has_more и results.next_cursor работают по обычным правилам пагинации и для этой единственной строки остаются пустыми.
curl -X POST "https://api.socq.ai/v1/amazon/shop" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.amazon.com/shop/sydneydelrey"}'Сценарии использования Amazon Storefront API
- Поиск авторов для партнерской программы: Сравнивайте is_top_creator, число списков идей и их items_count по нескольким витринам, чтобы отобрать авторов, которые постоянно собирают товары вашей категории.
- Отслеживание рекомендаций автора: Перечитывайте витрину раз в неделю и сравнивайте названия списков, items_count и trending_picks, чтобы видеть, какие сезонные списки растут и какие товары выходят на первый план.
- Связь витрины с соцсетями: Через social_urls привязывайте каждую витрину к профилям автора в TikTok, YouTube или Pinterest, чтобы продажи и охват в соцсетях хранились в одной записи.
Практические советы по Amazon Storefront API
- Сохраняйте домен площадки вместе с каждым результатом: trending_picks.price указан в валюте этой площадки.
- Используйте id — название витрины из ссылки — как ключ, чтобы повторные чтения одного автора совпадали.
- Чтобы получить товары по отдельности, откройте список или подборку по их url; items_count и posts_count заранее покажут их размер.
Связанные API
Помимо Amazon Storefront 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 Seller Info API — Собирайте по известным URL продавцов публичные данные профиля продавца Amazon: название, описание, сайт, рейтинг, отзывы покупателей, местоположение, источник и время сбора.