Наша собственная статистика посещений включена всегда. Google Analytics помогает нам понять, как пользуются нашими публичными страницами (но не вашим рабочим пространством после входа), и включается только с вашего разрешения. См. нашу политику конфиденциальности.

API Amazon Поиск

POST

Состояние API

Состояние за 24 ч
Норма
Среднее время за 24 ч
—
  • Стабильно / норма
  • Доступно
  • Ограничено
  • Почти недоступно
Норма

Ищите товары по ключевому слову на выбранном маркетплейсе 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 время и повторите попытку.

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

Параметры запроса

ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаamazonИдентификатор платформы, фиксированное значение.
actionbodystringДаsearchИдентификатор возможности, фиксированное значение.
keywordbody.paramsstringДа-Задаёт основную строку поиска в зависимости от запрошенного действия Amazon. В search передавайте поисковые слова для товаров. В bestsellers передавайте полный URL категории бестселлеров Amazon или краткое название категории, из которого строится путь. В sellers передавайте URL страницы товара или продавца; обычные поисковые слова формируют страницу поиска товаров, а не ищут ID продавца напрямую.
domainbody.paramsstringНет-Задаёт домен Amazon для страны без схемы и пути, например amazon.com, amazon.co.uk или amazon.co.jp. По умолчанию используется amazon.com; действие search строит по нему URL поиска в этом магазине.
langbody.paramsstring (enum)Нет-Задаёт язык страницы для поддерживаемых эндпоинтов Amazon с помощью допустимых кодов, например en или ja. Для упрощённого китайского используйте zhcn, для традиционного — zhtw, а не общий код zh. Запросы принимают только коды языков, перечисленные для действия. Выбор языка меняет отображаемый контент, но не выбранный региональный магазин Amazon.Допустимые значенияarbncsdadeenesfrhehijaknkomlmrtanlplptsvtatetrzhcnzhtw
limitbody.paramsinteger (1–50)Нет10Максимальное число записей в этом вызове, целое число от 1 до 50. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. При значениях выше максимума эндпоинт возвращает ошибку 422 до списания средств.

Примеры кода

bash
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 меняются при каждом вызове, поэтому показана только их структура.

json
{
  "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 (пусто)
Нет данных. Без списания.

Ошибки