API Amazon Ключевые слова с позициями

POST

Состояние API

Состояние за 24 ч: Норма
Среднее время за 24 ч: —

Стабильно / норма
Доступно
Ограничено
Почти недоступно

Норма

Последние 24 часа

Последние 30 дней

Получите поисковые ключевые слова Amazon US, по которым ранжируется один товар, по asin. Для каждого ключевого слова указаны месячный объём поиска, позиция товара на этой странице выдачи, органическая это позиция или рекламная, а также цена, рейтинг и значки, показанные там. Данные доступны только для маркетплейса Amazon в США, до 100 ключевых слов за вызов. Данные о ключевых словах есть не для каждого ASIN; если их нет, возвращается пустой результат и списание не производится.

Цена: $280 за 1 000 запросов ($0.28 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Amazon Ключевые слова с позициями (amazon/ranked_keywords).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: amazon и action: ranked_keywords, а параметры передайте в params.
- Обязательные параметры:
  - asin: Один ASIN Amazon для ranked_keywords или product_competitors: 10 заглавных букв или цифр, например B0C2JXSHSK. Списки и ASIN через запятую отклоняются.
- Необязательные параметры:
  - limit: Максимальное число записей в этом вызове, целое число от 1 до 100. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. (по умолчанию: 20)
- Возвращает список записей. Основные поля каждой записи: asin (Стандартный идентификационный номер Ama…), keyword (Ключевое слово: в ranked_keywords это с…), search_volume (Оценка числа поисковых запросов по ключ…), search_rank (Позиция товара на странице результатов…), result_type (К какому типу результатов относится поз…), result_type_rank (Позиция среди результатов того же типа,…), search_result_count (Общее число результатов на Amazon US по…), ranked_at (Время фиксации позиции в формате ISO 86…), title, url, image_url, price; всего полей: 20, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=amazon.
- Пример тела запроса:
{
  "platform": "amazon",
  "action": "ranked_keywords",
  "params": {
    "asin": "B0C2JXSHSK"
  }
}
- Цена: $280 за 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`	Да	`ranked_keywords`	Идентификатор возможности, фиксированное значение.
`asin`	body.params	`string`	Да	-	Один ASIN Amazon для `ranked_keywords` или `product_competitors`: 10 заглавных букв или цифр, например `B0C2JXSHSK`. Списки и ASIN через запятую отклоняются. Поддерживается только маркетплейс США (amazon.com), поэтому для ASIN из другого магазина данных не будет.
`limit`	body.params	`integer (1–100)`	Нет	`20`	Максимальное число записей в этом вызове, целое число от 1 до 100. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. При значениях выше максимума эндпоинт возвращает ошибку 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": "ranked_keywords",
  "params": {
    "asin": "B0C2JXSHSK"
  }
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

Пример ответа

Предпросмотр полей

Для этих параметров пока нет примера ответа. Здесь показаны структура ответа и поля из описания API, а … служит заполнителем; это не результат реального вызова.

json

{
  "id": "req_…",
  "platform": "amazon",
  "action": "ranked_keywords",
  "results": [
    {
      "asin": …,
      "keyword": …,
      "search_volume": …,
      "search_rank": …,
      "result_type": …,
      "result_type_rank": …,
      "search_result_count": …,
      "ranked_at": …,
      "title": …,
      "url": …,
      "image_url": …,
      "price": …,
      "currency": …,
      "rating": …,
      "rating_scale": …,
      "rating_count": …,
      "is_amazon_choice": …,
      "is_bestseller": …,
      "bought_past_month": …,
      "total_keywords": …,
      "platform": …
    }
  ],
  "count": …,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Поля ответа

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

Поле	Значение
`asin`	Стандартный идентификационный номер Amazon — уникальный ID товара в пределах магазина.
`keyword`	Ключевое слово: в ranked_keywords это слово, по которому ранжируется товар, в bulk_search_volume это слово, которое вы запросили.
`search_volume`	Оценка числа поисковых запросов по ключевому слову в месяц на Amazon US (ranked_keywords, bulk_search_volume). Это спрос на ключевое слово в целом, а не трафик на конкретный товар; 0 означает, что объём слишком мал для измерения, а в bulk_search_volume для ключевого слова со слишком малым числом запросов запись не возвращается.
`search_rank`	Позиция товара на странице результатов по этому ключевому слову, считая с 1, среди органических и спонсорских результатов (ranked_keywords).
`result_type`	К какому типу результатов относится позиция (ranked_keywords): organic или sponsored.
`result_type_rank`	Позиция среди результатов того же типа, органических или спонсорских (ranked_keywords).
`search_result_count`	Общее число результатов на Amazon US по ключевому слову (ranked_keywords), приблизительный показатель конкуренции.
`ranked_at`	Время фиксации позиции в формате ISO 8601 по UTC (ranked_keywords). Для разных ключевых слов оно различается; позиция могла быть зафиксирована несколько недель назад.
`title`	Заголовок. null, если на платформе нет заголовков (например, у текстовых постов).
`url`	Ссылка на запись на платформе.
`image_url`	Ссылка на изображение. Возможности с несколькими изображениями могут возвращать массив image_urls.
`price`	Цена числом без символа валюты; см. currency.
`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.
`is_amazon_choice`	Есть ли у товара значок Amazon's Choice.
`is_bestseller`	Был ли у товара значок Best Seller на момент фиксации позиции (ranked_keywords).
`bought_past_month`	Показатель «куплено за последний месяц» со страницы результатов (ranked_keywords): оценочный диапазон платформы, например 1000 для 1K+, а не точное число продаж.
`total_keywords`	Общее число ключевых слов, по которым ранжируется товар (ranked_keywords), одинаково во всех записях; один вызов возвращает не более 100.
`platform`	Идентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).

Ошибки и оплата

401: Ключ отсутствует или недействителен.
402: Недостаточно средств на балансе. Сначала пополните баланс.
422: Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429: Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503: Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто): Нет данных. Без списания.

Ошибки