Keepa API: Guía Completa para Vendedores y Desarrolladores de Amazon (2026)

## Índice

1. [¿Qué es Keepa?](#qué-es-keepa)
2. [¿Qué es la API de Keepa?](#qué-es-la-api-de-keepa)
3. [Desglose de precios de la API de Keepa](#desglose-de-precios-de-la-api-de-keepa)
4. [Endpoints principales de la API](#endpoints-principales-de-la-api)
5. [Empezando con Python](#empezando-con-python)
6. [Casos de uso reales](#casos-de-uso-reales)
7. [Límites de tasa, tokens y peculiaridades](#límites-de-tasa-tokens-y-peculiaridades)
8. [Alternativas a la API de Keepa](#alternativas-a-la-api-de-keepa)
9. [Preguntas frecuentes](#preguntas-frecuentes)

---

Si vendes en Amazon — o desarrollas herramientas para quienes lo hacen — probablemente hayas oído hablar de Keepa. La extensión del navegador que muestra gráficos de historial de precios en las páginas de productos de Amazon se ha convertido en el compañero de investigación predeterminado para millones de vendedores en todo el mundo. Pero Keepa es más que una extensión de navegador. Detrás de escena, existe una potente API que rastrea precios, ranking de ventas (BSR), ofertas y datos de categorías en todos los principales mercados de Amazon.

Esta guía cubre todo lo que necesitas saber sobre la API de Keepa en 2026: cuánto cuesta, qué endpoints están disponibles, cómo escribir tu primera integración en Python y dónde falla la API. Ya seas un vendedor de Amazon FBA automatizando tu flujo de trabajo de investigación o un desarrollador construyendo la próxima herramienta de investigación de productos, este es tu punto de partida.

## ¿Qué es Keepa?

Keepa es un servicio de seguimiento de precios de Amazon fundado en Alemania. Monitorea los precios de productos, el ranking de ventas (BSR), el número de ofertas, el número de reseñas y el historial de calificaciones en todos los principales mercados de Amazon, incluidos EE. UU., Reino Unido, Alemania, Francia, Italia, España y Japón.

La mayoría de los vendedores de Amazon conocen Keepa a través de su extensión de navegador, que incrusta gráficos interactivos de historial de precios directamente en las páginas de productos de Amazon. Estos gráficos muestran cómo han cambiado el precio, el BSR y el Buy Box de un producto a lo largo de días, semanas, meses o años.

Más allá de la extensión, Keepa ofrece un conjunto de herramientas basadas en la web:

- **Buscador de productos** — filtra el catálogo de Amazon por precio, BSR, categoría, número de reseñas y docenas de otros criterios
- **Visor de productos** — importa ASINs en masa y recupera datos actuales
- **Listas de Best Sellers** — sigue a los líderes de categoría en tiempo real
- **Seguimiento y alertas** — recibe notificaciones cuando un producto alcanza tu precio objetivo

Estas herramientas son útiles por sí solas, pero el verdadero poder para vendedores y desarrolladores orientados a la automatización es la **API de Keepa**.

## ¿Qué es la API de Keepa?

La API de Keepa es una interfaz HTTP RESTful que expone prácticamente todo lo que Keepa rastrea sobre los productos de Amazon. En lugar de navegar manualmente por el sitio web o la extensión de Keepa, puedes consultar datos de productos, árboles de categorías, perfiles de vendedores, ofertas y listas de best sellers de manera programática.

La API devuelve respuestas en JSON y utiliza un sistema de autenticación basado en tokens. Pasas tu clave de acceso API como parámetro de consulta, y Keepa deduce tokens de tu saldo según los datos que solicites.

Las capacidades clave incluyen:

- **Datos de productos** — precio actual, BSR, número de ofertas, calificación, número de reseñas, dimensiones, peso e historial completo de precios/BSR que se remonta a años
- **Análisis del Buy Box** — quién tiene el Buy Box, por cuánto tiempo y a qué precio
- **Seguimiento de ofertas** — ofertas de terceros en vivo con precios, condición e información del vendedor
- **Navegación por categorías** — árbol completo de categorías de Amazon con IDs de nodos
- **Best sellers** — productos más vendidos en tiempo real por categoría
- **Búsqueda de vendedores** — detalles del vendedor, ASINs de la tienda y datos de inventario
- **Búsqueda de productos** — búsqueda basada en palabras clave en el catálogo de Amazon
- **Ofertas** — productos con recientes caídas de precios que coinciden con criterios configurables
- **Seguimiento** — alertas de precios programáticas con soporte para webhooks

Si Amazon tiene datos sobre algo, Keepa probablemente los rastree — y la API te permite acceder a ellos a escala.

## Desglose de precios de la API de Keepa

Keepa utiliza un sistema de precios basado en tokens. Cada nivel de suscripción API genera un cierto número de tokens por minuto. Cada token te permite solicitar datos de un producto, un vendedor o una categoría. Los tokens no utilizados caducan después de 60 minutos.

### Requisito previo: Suscripción a Keepa

Antes de poder usar la API, necesitas una suscripción base a Keepa:

- **Gratis** — €0/mes. Solo extensión del navegador y seguimiento básico. Sin acceso a la API.
- **De pago** — €19/mes (o €189/año). Desbloquea el Buscador de Productos, el Visor de Productos, Best Sellers y acceso básico a la API con 1 token/minuto.

El plan de €19/mes te da acceso a la API, pero con 1 token por minuto solo puedes consultar alrededor de 60 productos por hora — útil para pruebas, pero no para cargas de trabajo de producción.

### Planes adicionales de API

Para un uso serio, compras un plan API además de tu suscripción base:

| Tokens/Minuto | Costo Mensual | Productos/Hora (aprox.) |
|---------------|-------------|------------------------|
| 20 | €49 | ~1,200 |
| 60 | €129 | ~3,600 |
| 250 | €459 | ~15,000 |
| 500 | €879 | ~30,000 |
| 1,000 | €1,499 | ~60,000 |
| 2,000 | €2,499 | ~120,000 |
| 3,000 | €3,499 | ~180,000 |
| 4,000 | €4,499 | ~240,000 |

La columna "Productos/Hora" asume 1 token por solicitud de producto. En la práctica, habilitar funciones como datos del Buy Box (5 tokens por solicitud) o historial de ofertas reduce el rendimiento proporcionalmente.

### ¿Qué compra un token?

- **1 token** — consulta estándar de producto (historial de precios, BSR, metadatos básicos)
- **~2 tokens** — consulta de producto con datos de ofertas
- **~5 tokens** — consulta de producto con estadísticas del Buy Box
- **1 token** — búsqueda de categoría o lista de best sellers
- **1 token** — perfil de vendedor

Todos los planes son mensuales, prepagos y se pueden cancelar en cualquier momento. Puedes apilar varios planes en una cuenta, y las actualizaciones tienen efecto inmediato. Las degradaciones están limitadas a una vez al mes.

## Endpoints principales de la API

La API de Keepa expone más de 16 endpoints. Aquí están los más relevantes para vendedores de Amazon y desarrolladores de herramientas:

### Solicitud de producto

El endpoint más utilizado. Recupera datos detallados de productos para hasta 100 ASINs por solicitud.

```
GET https://api.keepa.com/product?key=YOUR_KEY&domain=1&asin=B0088PUEPK
```

Devuelve: precio actual (Amazon, marketplace, usado), ranking de ventas, número de reseñas, calificación, dimensiones, peso, categoría y matrices completas de historial de precios/BSR. Agrega `&buybox=1` para estadísticas del Buy Box (cuesta 5 tokens en lugar de 1).

### Best Sellers

Recupera los ASINs más vendidos para cualquier categoría de Amazon.

```
GET https://api.keepa.com/bestsellers?key=YOUR_KEY&domain=3&category=340846031
```

Devuelve una lista de ASINs clasificados por el ranking de ventas actual. Necesitas el ID de nodo de categoría, que puedes encontrar a través del endpoint de Búsqueda de Categorías.

### Búsqueda y consulta de categorías

Encuentra IDs de nodos de categoría de Amazon por palabra clave o recorre el árbol de categorías.

```
GET https://api.keepa.com/search?key=YOUR_KEY&domain=3&type=category&term=kitchen
```

### Vendedor

Recupera detalles del vendedor y, opcionalmente, toda su tienda (todos los ASINs listados).

```
GET https://api.keepa.com/seller?key=YOUR_KEY&domain=1&seller=A2R2RITDJNW1Q6
```

### Buscador de productos

El equivalente en API de la herramienta Buscador de Productos de Keepa. Filtra el catálogo de Amazon por docenas de criterios: rango de precios, rango de BSR, número de reseñas, calificación, categoría y más.

### Seguimiento

Agrega productos a tu lista de seguimiento y configura alertas de manera programática. Soporta entrega por webhook — Keepa envía un HTTP POST a tu URL cuando el precio de un producto seguido cruza tu umbral.

```
POST https://api.keepa.com/tracking?key=YOUR_KEY&type=add
```

### Ofertas

Encuentra productos con recientes caídas de precios, cambios en el BSR u otros criterios que califiquen como oferta. Útil para vendedores de arbitraje y mayoristas que buscan oportunidades.

## Empezando con Python

La forma más fácil de interactuar con la API de Keepa desde Python es el paquete `keepa`, mantenido por Alex Kaszynski.

### Instalación

```bash
pip install keepa
```

Requiere Python 3.10+. Las dependencias incluyen `numpy`, `aiohttp` y `matplotlib`.

### Ejemplo 1: Consultar un solo producto

```python
import keepa

api = keepa.Keepa("YOUR_API_KEY")

# Consultar un producto en Amazon.de (domain=3)
products = api.query("B0088PUEPK", domain="DE")
product = products[0]

print(f"Título: {product['title']}")
print(f"Ranking de ventas: {product['salesRankReference']}")
print(f"Calificación: {product['csv'][16][-1] / 10 if product['csv'][16] else 'N/A'}")
print(f"Número de ofertas: {product['csv'][11][-1] if product['csv'][11] else 'N/A'}")

# El historial de precios está en las matrices product['csv']
# Índice 0 = precio de Amazon, 1 = Marketplace Nuevo, 2 = Usado, etc.
amazon_prices = product['csv'][0]  # [tiempo, precio, tiempo, precio, ...]
if amazon_prices is not None:
    último_precio = amazon_prices[-1] / 100  # Los precios están en céntimos
    print(f"Precio actual de Amazon: €{último_precio:.2f}")
```

### Ejemplo 2: Encontrar Best Sellers en una categoría

```python
import keepa

api = keepa.Keepa("YOUR_API_KEY")

# Primero, encuentra el ID de categoría para "Cocina" en Amazon.de
categories = api.search_for_categories("kitchen", domain="DE")
for cat_id, cat_data in list(categories.items())[:3]:
    print(f"Categoría: {cat_data['name']} (ID: {cat_id})")

# Obtén los best sellers para una categoría específica
best_sellers = api.best_sellers_query(domain="DE", category="340846031")
print(f"\nTop 5 ASINs en la categoría:")
for asin in best_sellers[:5]:
    print(f"  {asin}")

# Ahora consulta esos ASINs en masa para obtener detalles
products = api.query(best_sellers[:5], domain="DE")
for p in products:
    print(f"  {p['asin']}: {p['title'][:60]}...")
```

### Ejemplo 3: Consulta masiva asíncrona con límite de tasa

Para cargas de trabajo de producción que consultan miles de productos, usa la API asíncrona:

```python
import asyncio
import keepa

async def analyze_asins(asin_list: list[str]):
    api = await keepa.AsyncKeepa().create("YOUR_API_KEY")

    # La biblioteca maneja el límite de tokens automáticamente
    # Consulta en lotes de 100 (el máximo de Keepa por solicitud)
    all_products = []
    for i in range(0, len(asin_list), 100):
        batch = asin_list[i:i+100]
        products = await api.query(batch, domain="DE")
        all_products.extend(products)
        print(f"Consultados {len(all_products)}/{len(asin_list)} productos")

    # Analiza los resultados
    for p in all_products:
        título = p.get("title", "N/A")
        bsr = p.get("salesRankReference", -1)
        print(f"{p['asin']} | BSR: {bsr:>8} | {título[:50]}")

    return all_products

# Ejecuta con una lista de ASINs
asins = ["B0088PUEPK", "B07XJ8C8F5", "B09V3KXJPB"]
results = asyncio.run(analyze_asins(asins))
```

La biblioteca `keepa` de Python maneja la gestión de tokens internamente — pausará las solicitudes automáticamente cuando tu saldo de tokens sea bajo y las reanudará cuando los tokens se regeneren.

## Casos de uso reales

### Seguimiento de BSR para investigación de productos

El caso de uso más común. Consulta productos diariamente y almacena el historial de BSR en tu propia base de datos. Graficar el BSR a lo largo del tiempo revela estacionalidad, trayectorias de lanzamiento y dinámicas competitivas que una sola instantánea nunca muestra. Los vendedores que investigan productos para private label usan esto para validar la demanda antes de comprometerse con un proveedor.

### Monitoreo de precios y reajuste de precios

Rastrea los precios de los competidores en diferentes mercados. Cuando un competidor baja su precio, tu sistema recibe una notificación (a través de webhooks de seguimiento o sondeo) y puede ajustar tu propio precio a través de la SP-API de Amazon. Los vendedores de mayoristas y arbitraje dependen de esto para mantener una posición competitiva.

### Inteligencia competitiva

Usa el endpoint de Vendedor para monitorear la tienda de un competidor. Rastrea cuántos ASINs listan, en qué categorías se expanden y cómo cambia su estrategia de precios con el tiempo. Combina esto con consultas de productos para construir un panorama competitivo completo.

### Escaneo automatizado de ofertas

El endpoint de Ofertas muestra productos con recientes caídas de precios o mejoras en el BSR. Los vendedores de arbitraje construyen scripts que escanean ofertas que coinciden con criterios específicos — categoría, rango de precios, umbral de ROI — y envían alertas a Slack, Telegram o correo electrónico minutos después de que aparece una oferta.

### Análisis de categorías

Consulta los best sellers en múltiples categorías para identificar brechas en el mercado. Compara precios promedio, número de reseñas y distribuciones de BSR entre categorías para encontrar nichos donde la demanda es alta pero la competencia es manejable.

## Límites de tasa, tokens y peculiaridades

### Caducidad de tokens

Los tokens caducan 60 minutos después de su generación, los uses o no. No puedes acumular tokens. Si tu aplicación es de ráfagas — por ejemplo, ejecutando un trabajo por lotes diario — estás pagando por tokens generados durante las 23 horas que tu sistema está inactivo. Para cargas de trabajo de ráfagas, considera hacer cola de solicitudes y distribuirlas en tu ventana de generación de tokens.

### Los datos del Buy Box son caros

Habilitar `buybox=True` en una consulta de producto cuesta 5 tokens en lugar de 1. Si necesitas datos del Buy Box para 10,000 productos, eso son 50,000 tokens — lo que en el plan de 250 tokens/minuto toma más de 3 horas. Planifica tu canalización de datos en consecuencia.

### Formato de datos de precios

Keepa almacena los precios en céntimos (enteros) y las marcas de tiempo en "tiempo Keepa" — minutos desde el 1 de enero de 2011. Necesitas convertir ambos a formatos estándar. La biblioteca de Python maneja la mayor parte de esto, pero si usas la API HTTP cruda, ten en cuenta estas conversiones:

```python
from datetime import datetime, timedelta

KEEPA_EPOCH = datetime(2011, 1, 1)

def keepa_time_to_datetime(keepa_minutes: int) -> datetime:
    return KEEPA_EPOCH + timedelta(minutes=keepa_minutes)

def keepa_price_to_float(price_cents: int) -> float:
    if price_cents < 0:
        return None  # -1 significa "no disponible"
    return price_cents / 100
```

### Frescura de los datos

Keepa no rastrea cada producto continuamente. Los productos populares (BSR bajo) se actualizan con más frecuencia — a veces cada hora. Los productos de larga cola podrían actualizarse solo cada pocos días. Si necesitas frescura garantizada, puedes pasar el parámetro `update` en tu consulta para activar un rastreo en vivo, pero esto cuesta tokens adicionales.

### Cobertura de mercados de la UE

Keepa cubre Amazon.de, .fr, .it, .es, .co.uk, .nl, .pl, .se y .be. La profundidad de la cobertura varía — Alemania y Reino Unido tienen los datos históricos más completos, mientras que mercados más nuevos como Suecia y Bélgica tienen historiales más cortos. Para vendedores enfocados en la UE, Keepa es actualmente la mejor fuente única para datos de precios entre mercados.

## Alternativas a la API de Keepa

Keepa es el líder del mercado en el seguimiento de precios de Amazon, pero no es la única opción. Aquí hay alternativas que vale la pena considerar según tus necesidades:

### Rainforest API

Una API más amplia de datos de Amazon que cubre detalles de productos, resultados de búsqueda, reseñas y más. Rainforest rastrea Amazon directamente en lugar de mantener su propia base de datos histórica, por lo que te da instantáneas en tiempo real pero carece del historial profundo de precios que ofrece Keepa. Los precios comienzan en $75/mes por 500 solicitudes.

### Pangolin API

Diseñada como un competidor directo de Keepa con un enfoque en precios flexibles. Ofrece facturación por solicitud en lugar de planes de tokens por minuto, lo que puede ser más rentable para cargas de trabajo de ráfagas o de bajo volumen. La cobertura es más estrecha que la de Keepa.

### SP-API (API de Socio de Venta de Amazon)

La propia API de Amazon para vendedores. Te da acceso a tus propios datos de ventas, inventario, pedidos e información del catálogo. No proporciona precios de competidores ni historial de BSR — solo puedes ver datos relacionados con tu propia cuenta de vendedor. Es gratis de usar pero complejo de configurar y limitado en alcance.

### AgentXray

Si eres un vendedor de Amazon en la UE que quiere las ideas que proporcionan los datos de Keepa pero no quiere construir y mantener tu propia canalización de datos, [AgentXray](https://agentxray.ai) toma un enfoque diferente. Ingiere datos de Keepa junto con otras fuentes y utiliza agentes de IA para destacar oportunidades de productos, generar informes de mercado y automatizar flujos de trabajo de investigación — para que obtengas el análisis sin escribir código. Vale la pena explorar si tu objetivo es inteligencia procesable en lugar de acceso crudo a la API.

### Construir tu propio scraper

Algunos desarrolladores omiten las API de terceros por completo y construyen sus propios rastreadores de Amazon. Esto te da el máximo control y cero costos continuos de API, pero Amazon bloquea activamente los rastreadores, y mantener uno es una inversión de ingeniería significativa. Para la mayoría de los equipos, la API de Keepa es más rentable que mantener una infraestructura de rastreo.

## Preguntas frecuentes

### ¿Es gratuita la API de Keepa?

La API de Keepa no es gratuita. Necesitas al menos una suscripción de pago a Keepa (€19/mes) que te da acceso básico a la API con 1 token por minuto. Para un uso práctico, los planes dedicados de API comienzan en €49/mes por 20 tokens por minuto. No hay una prueba gratuita específica para la API.

### ¿Cuántos productos puedo consultar por día con la API de Keepa?

Depende de tu plan y opciones de consulta. Con el plan de €49/mes (20 tokens/minuto), puedes consultar aproximadamente 28,800 productos por día usando solicitudes estándar (1 token cada una). El plan de €459/mes (250 tokens/minuto) permite aproximadamente 360,000 consultas estándar de productos por día. Habilitar opciones como datos del Buy Box reduce el rendimiento proporcionalmente.

### ¿La API de Keepa soporta todos los mercados de Amazon?

Keepa soporta 13 mercados de Amazon: EE. UU., Reino Unido, Alemania, Francia, Italia, España, Canadá, Japón, India, México, Brasil, Australia y Países Bajos. También se cubren mercados adicionales de la UE, incluidos Polonia, Suecia y Bélgica. Cada mercado se identifica con un ID de dominio numérico en las solicitudes de API.

### ¿Puedo usar la API de Keepa para proyectos comerciales?

Sí. Los términos de la API de Keepa permiten el uso comercial. Muchas herramientas SaaS, servicios de reajuste de precios y plataformas de investigación de productos se construyen sobre la API de Keepa. Debes revisar los términos de servicio actuales de Keepa para cualquier restricción específica sobre la redistribución de datos.

### ¿Cuál es la diferencia entre la API de Keepa y la biblioteca de Python keepa?

La API de Keepa es la interfaz HTTP REST proporcionada por Keepa.com. La biblioteca `keepa` de Python (instalable via `pip install keepa`) es un envoltorio mantenido por la comunidad que simplifica la interacción con la API desde Python. La biblioteca maneja la autenticación, el límite de tasa, el análisis de datos y la conversión de tiempo Keepa automáticamente. Aún necesitas una clave API de Keepa para usar la biblioteca de Python.

---

*Esta guía se basa en la documentación y precios de la API de Keepa a principios de 2026. Keepa puede actualizar sus niveles de precios o especificaciones de endpoints — siempre consulta [keepa.com](https://keepa.com) para obtener la información más reciente.*

## Lecturas relacionadas

- [Datos de Keepa explicados para vendedores de la UE](https://agentxray.ai/es/blog/keepa-data-explained-eu-sellers)