API de Palabras clave posicionadas de Amazon

POST

Salud de la API

Salud 24 h: Normal
Tiempo medio 24 h: —

Saludable / normal
Disponible
Limitada
Casi sin servicio

Normal

Últimas 24 horas

Últimos 30 días

Envía un solo asin y recibe las palabras clave de búsqueda de Amazon Estados Unidos en las que aparece ese producto: volumen mensual de búsqueda, posición en la página de resultados, si el hueco es «organic» o «sponsored», y el precio, la valoración y las insignias que se vieron allí. Solo cubre el marketplace de Estados Unidos, hasta 100 palabras por llamada. No todos los ASIN tienen datos de posicionamiento; si no hay ninguno, el resultado llega vacío y no se cobra.

Precio $280 por 1.000 solicitudes ($0.28 por llamada). Las llamadas fallidas y los resultados vacíos no se cobran. Síncrona. Para tareas lentas añade "mode": "async" al cuerpo, recibe un job_id y consúltalo.

Prompt para IA

Pégalo en tu asistente de IA. Ya incluye los parámetros, los campos de respuesta y una solicitud de ejemplo de este endpoint, así que el asistente puede preguntarte qué necesitas y luego escribir el script.

Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Amazon: Palabras clave posicionadas (amazon/ranked_keywords).

Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en amazon y action en ranked_keywords, y los parámetros dentro de params.
- Parámetros obligatorios:
  - asin: Un solo ASIN de Amazon para ranked_keywords: 10 letras mayúsculas o dígitos, como B0C2JXSHSK. No se aceptan listas ni varios ASIN separados por comas. Solo cubre el marketplace de Estados Unidos (amazon.com).
- Parámetros opcionales:
  - limit: Número máximo de filas que devuelve esta llamada, un entero de 1 a 100. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas. (por defecto: 20)
- Devuelve una lista de registros. Campos principales de cada registro: asin (Número estándar de identificación de Am…), keyword (Palabra clave de búsqueda en la que se…), search_volume (Búsquedas mensuales estimadas de la pal…), search_rank (Posición del producto en la página de r…), result_type (Tipo de resultado de esa posición (rank…), result_type_rank (Posición entre los resultados del mismo…), search_result_count (Total de resultados de Amazon Estados U…), ranked_at (Momento en que se observó la posición,…), title, url, image_url, price; 20 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=amazon.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "amazon",
  "action": "ranked_keywords",
  "params": {
    "asin": "B0C2JXSHSK"
  }
}
- Precio: $280 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.

Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.

Parámetros de la solicitud

Nombre	Ubicación	Tipo	Obligatorio	Por defecto	Descripción
`Authorization`	header	`string`	Sí	-	Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código.
`platform`	body	`string`	Sí	`amazon`	Identificador de la plataforma, valor fijo.
`action`	body	`string`	Sí	`ranked_keywords`	Identificador de la capacidad, valor fijo.
`asin`	body.params	`string`	Sí	-	Un solo ASIN de Amazon para `ranked_keywords`: 10 letras mayúsculas o dígitos, como `B0C2JXSHSK`. No se aceptan listas ni varios ASIN separados por comas. Solo cubre el marketplace de Estados Unidos (amazon.com); un ASIN de otra tienda no devuelve datos.
`limit`	body.params	`integer (1–100)`	No	`20`	Número máximo de filas que devuelve esta llamada, un entero de 1 a 100. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas. Los valores mayores devuelven 422 antes de cualquier cobro.

Ejemplos de código

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"
  }
}'

Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.

Ejemplo de respuesta

Vista previa de campos

Todavía no hay una muestra real para estos parámetros de ejemplo: se muestra la estructura de la respuesta y sus campos según la definición de la API, con … como marcadores. No es el resultado de una llamada real.

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": { … }
}

Campos de la respuesta

Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.

Campo	Significado
`asin`	Número estándar de identificación de Amazon, el ID único del producto dentro de una tienda.
`keyword`	Palabra clave de búsqueda en la que se posiciona el producto (ranked_keywords).
`search_volume`	Búsquedas mensuales estimadas de la palabra clave en Amazon Estados Unidos (ranked_keywords). Es la demanda de toda la palabra, no el tráfico de este producto; 0 significa demasiado poco para medirlo.
`search_rank`	Posición del producto en la página de resultados de esa palabra, contando desde 1 entre resultados orgánicos y patrocinados (ranked_keywords).
`result_type`	Tipo de resultado de esa posición (ranked_keywords): organic (orgánico) o sponsored (patrocinado).
`result_type_rank`	Posición entre los resultados del mismo tipo, orgánico o patrocinado (ranked_keywords).
`search_result_count`	Total de resultados de Amazon Estados Unidos para la palabra clave (ranked_keywords), una medida aproximada de la competencia.
`ranked_at`	Momento en que se observó la posición, en ISO 8601 y UTC (ranked_keywords). Cambia según la palabra y puede tener semanas.
`title`	Título. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto).
`url`	Enlace al registro en la plataforma.
`image_url`	Enlace de imagen. Las capacidades con varias imágenes pueden devolver una lista image_urls.
`price`	Precio como número, sin símbolo de moneda; ver currency.
`currency`	Código de moneda del precio (por ejemplo CNY, USD). Si hay price pero currency es null, no supongas una moneda.
`rating`	Valoración. La escala depende de la plataforma: rating_scale en la misma fila indica el máximo (normalmente 5; Booking, Douban, iQIYI y NAVER usan 10). Convierte con rating_scale antes de comparar entre plataformas o la comparación puede salir al revés.
`rating_scale`	Máximo de rating en la misma fila: 5 en escalas de cinco estrellas y 10 en escalas de diez puntos. Solo aparece si la fila tiene rating.
`rating_count`	Número de personas que valoraron. null significa no publicado, no 0.
`is_amazon_choice`	Indica si el producto lleva la insignia Amazon's Choice.
`is_bestseller`	Si el producto llevaba la insignia Best Seller cuando se observó la posición (ranked_keywords).
`bought_past_month`	Cifra de «comprado el mes pasado» que muestra la página de resultados (ranked_keywords): un tramo estimado por la plataforma, como 1000 para 1K+, no una cifra exacta de ventas.
`total_keywords`	Cuántas palabras clave posicionan el producto en total (ranked_keywords), igual en todas las filas; cada llamada devuelve como máximo 100.
`platform`	Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).

Errores y facturación

401: Falta la clave o no es válida.
402: Saldo insuficiente. Recarga primero.
422: Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
429: Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
503: No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
200 vacío: Sin datos. Sin cargo.

Errores