API Amazon Поиск
Состояние API
- Состояние за 24 ч
- Норма
- Среднее время за 24 ч
- —
- Стабильно / норма
- Доступно
- Ограничено
- Почти недоступно
Последние 24 часа
Последние 30 дней
Ищите товары по ключевому слову на выбранном маркетплейсе Amazon. Получите ASIN, бренд, цену и базовую цену, число оценок, наличие и продавца каждого товара. Задайте магазин через domain, например amazon.co.uk; цены указаны в рамках этого магазина. Один только lang страну не меняет.
Возможность «Поиск Amazon» находит товары по keyword и возвращает для каждого ASIN, название, бренд, цену и цену без скидки, рейтинг и число оценок, наличие, категорию, изображение, продавца и то, есть ли у товара значок Amazon's Choice. Используйте её, чтобы увидеть, какие товары появляются в выдаче по ключевому слову, по каким ценам и с какими оценками: для исследования товаров в трансграничной торговле, обзора цен конкурентов или анализа рынка по ключевому слову.
Выберите магазин страны через domain, например amazon.co.uk, а язык страницы через lang; упрощённый и традиционный китайский — это zhcn и zhtw. Выбор языка не меняет магазин. Чтобы узнать больше, сформируйте ссылки на товары на основе asin и передайте их в возможность «Сведения Amazon» или «Отзывы Amazon». Помните, что рейтинг с малым rating_count мало о чём говорит.
Цена: $2.24 за 1 000 запросов ($0.002236 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.
Промпт для ИИ
Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Amazon Поиск (amazon/search).
Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: amazon и action: search, а параметры передайте в params.
- Обязательные параметры:
- keyword: Задаёт основную строку поиска в зависимости от запрошенного действия Amazon. В search передавайте поисковые слова для товаров.
- Необязательные параметры:
- domain: Задаёт домен Amazon для страны без схемы и пути, например amazon.com, amazon.co.uk или amazon.co.jp. По умолчанию используется amazon.com; действие search строит по нему URL поиска в этом магазине.
- lang: Задаёт язык страницы для поддерживаемых эндпоинтов Amazon с помощью допустимых кодов, например en или ja. Для упрощённого китайского используйте zhcn, для традиционного — zhtw, а не общий код zh. (допустимые значения: ar / bn / cs / da / de / en / es / fr)
- limit: Максимальное число записей в этом вызове, целое число от 1 до 50. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. (по умолчанию: 10)
- Возвращает список записей. Основные поля каждой записи: asin (Стандартный идентификационный номер Ama…), title, url, brand (Бренд), price, list_price (Цена до скидки (зачёркнутая)), currency, rating, rating_scale, rating_count, in_stock (Есть ли товар в наличии), category; всего полей: 19, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=amazon.
- Пример тела запроса:
{
"platform": "amazon",
"action": "search",
"params": {
"keyword": "coffee grinder"
}
}
- Цена: $2.24 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.
Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.Параметры запроса
| Имя | Расположение | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|---|
Authorization | header | string | Да | - | Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода. |
platform | body | string | Да | amazon | Идентификатор платформы, фиксированное значение. |
action | body | string | Да | search | Идентификатор возможности, фиксированное значение. |
keyword | body.params | string | Да | - | Задаёт основную строку поиска в зависимости от запрошенного действия Amazon. В search передавайте поисковые слова для товаров. В bestsellers передавайте полный URL категории бестселлеров Amazon или краткое название категории, из которого строится путь. В sellers передавайте URL страницы товара или продавца; обычные поисковые слова формируют страницу поиска товаров, а не ищут ID продавца напрямую. |
domain | body.params | string | Нет | - | Задаёт домен Amazon для страны без схемы и пути, например amazon.com, amazon.co.uk или amazon.co.jp. По умолчанию используется amazon.com; действие search строит по нему URL поиска в этом магазине. |
lang | body.params | string (enum) | Нет | - | Задаёт язык страницы для поддерживаемых эндпоинтов Amazon с помощью допустимых кодов, например en или ja. Для упрощённого китайского используйте zhcn, для традиционного — zhtw, а не общий код zh. Запросы принимают только коды языков, перечисленные для действия. Выбор языка меняет отображаемый контент, но не выбранный региональный магазин Amazon.Допустимые значенияarbncsdadeenesfrhehijaknkomlmrtanlplptsvtatetrzhcnzhtw |
limit | body.params | integer (1–50) | Нет | 10 | Максимальное число записей в этом вызове, целое число от 1 до 50. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. При значениях выше максимума эндпоинт возвращает ошибку 422 до списания средств. |
Примеры кода
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "amazon",
"action": "search",
"params": {
"keyword": "coffee grinder"
}
}'Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.
Пример ответа
Получено September 26, 2026 at 08:56 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты); в списке оставлены первые 2. id, billing и quota меняются при каждом вызове, поэтому показана только их структура.
{
"id": "req_…",
"platform": "amazon",
"action": "search",
"results": [
{
"asin": "B0GWHGT8C6",
"title": "SHARDOR Burr Coffee Grinder Electric with 32 Grinding Sizes, 2026 Upgraded",
"url": "https://www.amazon.com/dp/B0GWHGT8C6",
"brand": "SHARDOR",
"price": 39.98,
"list_price": 49.99,
"currency": "$",
"rating": 4.4,
"rating_count": 23,
"in_stock": true,
"category": "Home & Kitchen > Kitchen & Dining > Coffee, Tea & Espresso > Coffee Grinders > Electric Burr Grinders",
"image_url": "https://m.media-amazon.com/images/I/71umDJaSBGL._AC_SY300_SX300_QL70_FMwebp_.jpg",
"is_amazon_choice": false,
"seller_name": "KDSXG",
"platform": "amazon",
"images": [
"https://m.media-amazon.com/images/I/71umDJaSBGL._AC_SL1500_.jpg",
"https://m.media-amazon.com/images/I/71WkUEs07pL._AC_SL1500_.jpg",
"https://m.media-amazon.com/images/I/71h+360x8gL._AC_SL1500_.jpg"
],
"features": [
"CONSISTENT DAILY GRINDING Designed for home coffee routines, this flat burr grinder helps prepare beans for drip, pour over, french press, cold brew, moka pot, and espresso style drinks. The compact body fits small counters, apartments, office corners, and coffee stations without…",
"SMALL BATCH CONTROL The adjustable time based grinding design lets users grind only what they need for fresh cups, single serve brewers, or family coffee prep. To help protect the motor, the built in safety program supports up to 120 seconds of continuous operation before a short…",
"32 SIZE OPTIONS Choose from 32 grind settings to match different brewing needs, from finer grounds for espresso style preparation to coarser grounds for french press and cold brew. The grinder includes a chamber, cleaning brush, and hopper for daily use and simple upkeep."
],
"bestseller_ranks": [
{
"rank": 19549,
"category": "Home & Kitchen"
},
{
"rank": 7,
"category": "Burr Coffee Grinders"
}
],
"rating_scale": 5
},
{
"asin": "B0HB98V4SP",
"title": "Flat Burr Coffee Grinder Electric, Adjustable Coffee Bean Grinder with 17 Grinding Sizes, Burr Mill for Espresso & French Press, 2-12 Cup, Silver",
"url": "https://www.amazon.com/dp/B0HB98V4SP",
"brand": "Rounexes",
"price": 39.99,
"currency": "$",
"rating": 5,
"rating_count": 17,
"in_stock": true,
"category": "Home & Kitchen > Kitchen & Dining > Coffee, Tea & Espresso > Coffee Grinders > Electric Burr Grinders",
"image_url": "https://m.media-amazon.com/images/I/81lB7SOI39L._AC_SY300_SX300_QL70_FMwebp_.jpg",
"is_amazon_choice": false,
"seller_name": "MeiDing",
"platform": "amazon",
"images": [
"https://m.media-amazon.com/images/I/81lB7SOI39L._AC_SL1500_.jpg",
"https://m.media-amazon.com/images/I/81khWIt-ThL._AC_SL1500_.jpg",
"https://m.media-amazon.com/images/I/712ulwCFZuL._AC_SL1500_.jpg"
],
"features": [
"[17 Precise Grind Settings] From fine espresso to coarse French press, dial in the perfect grind across 17 calibrated levels—ideal for drip, pour-over, or cold brew, and designed to unlock your beans’ full aroma every morning.",
"[Uniform Flat Burr & Anti-Overheating] Heavy-duty stainless steel flat burrs ensure even grinding for consistent extraction and richer flavor. Low-speed operation prevents overheating, preserving delicate oils and freshness.",
"[2–12 Cup Quantity Control] Set your desired yield (2–12 cups) with the intuitive cup selector knob and 7 oz. bean hopper—grind just what you need, with zero waste."
],
"bestseller_ranks": [
{
"rank": 68800,
"category": "Home & Kitchen"
},
{
"rank": 28,
"category": "Burr Coffee Grinders"
}
],
"rating_scale": 5
}
],
"count": 10,
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}Поля ответа
Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.
| Поле | Значение |
|---|---|
asin | Стандартный идентификационный номер Amazon — уникальный ID товара в пределах магазина. |
title | Заголовок. null, если на платформе нет заголовков (например, у текстовых постов). |
url | Ссылка на запись на платформе. |
brand | Бренд. |
price | Цена числом без символа валюты; см. currency. |
list_price | Цена до скидки (зачёркнутая). |
currency | Код валюты цены (например, CNY, USD). Если price есть, а currency равно null, не делайте предположений о валюте. |
rating | Рейтинг. Шкала зависит от платформы: rating_scale в той же записи задаёт максимум (обычно 5; у Booking, Douban, iQIYI и NAVER — 10). Перед сравнением между платформами пересчитайте значения с учётом rating_scale, иначе результат сравнения может оказаться обратным. |
rating_scale | Максимальное значение rating в той же записи: 5 для пятизвёздочных шкал, 10 для десятибалльных. Поле присутствует, только если у записи есть рейтинг. |
rating_count | Количество оценивших. null означает, что значение не раскрыто, а не 0. |
in_stock | Есть ли товар в наличии. |
category | Название категории во внутренней классификации платформы. Категории разных платформ не унифицированы. |
image_url | Ссылка на изображение. Возможности с несколькими изображениями могут возвращать массив image_urls. |
description | Краткое содержание или описание, обычно короче text. |
is_amazon_choice | Есть ли у товара значок Amazon's Choice. |
seller_name | Название продавца. |
platform | Идентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok). |
images | Массив ссылок на изображения в порядке показа на платформе; поле отсутствует, если изображений нет. |
features | Маркированный список характеристик со страницы товара (search, profile) в исходной формулировке; отсутствует, если списка нет. |
bestseller_ranks | Позиции в рейтинге Best Sellers (search, profile): у каждой записи есть rank и category, по одной записи на категорию; это позиция на момент получения данных, а не показатель продаж. |
FAQ
Как искать в магазинах других стран?
Передайте домен магазина в domain, например amazon.co.uk или amazon.co.jp, без https:// и пути; по умолчанию используется amazon.com. lang меняет только язык страницы и никогда не переключает магазин.
Какие значения принимает lang?
Только коды языков, указанные для этой возможности, например en, ja или de. Упрощённый китайский — zhcn, традиционный — zhtw; просто zh не принимается. Язык меняет текст страницы, а не магазин, в котором идёт поиск.
Как получить отзывы о найденном товаре?
Сформируйте ссылку на товар на основе asin, например https://www.amazon.com/dp/<ASIN>, и передайте её в возможность «Отзывы Amazon». Используйте домен того же магазина, в котором выполнялся поиск, а для магазина за пределами США передайте в «Отзывы Amazon» тот же domain. Без него отзывы будут получены с amazon.com и не будут соответствовать выбранному магазину.
Ошибки и оплата
- 401
- Ключ отсутствует или недействителен.
- 402
- Недостаточно средств на балансе. Сначала пополните баланс.
- 422
- Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
- 429
- Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
- 503
- Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
- 200 (пусто)
- Нет данных. Без списания.