API de Radar Buy

Documentación de la API REST para integrar Radar Buy en tus aplicaciones

Inicio Rápido

1. Obtén tu API Key

Ve a la sección de Acceso API en tu dashboard para crear una clave de acceso.

2. Haz tu primera petición

curl -X GET "https://escotoken-uzco2ihn.manus.space/api/radar-buy/v1/search?q=auriculares+bluetooth&marketplace=es" \
  -H "X-API-Key: tu_api_key_aqui"

3. Ejemplo con JavaScript/Node.js

const response = await fetch(
  "https://escotoken-uzco2ihn.manus.space/api/radar-buy/v1/search?q=auriculares+bluetooth&marketplace=es",
  {
    headers: {
      "X-API-Key": "tu_api_key_aqui"
    }
  }
);

const data = await response.json();
console.log(data.data.products);

4. Ejemplo con Python

import requests

response = requests.get(
    "https://escotoken-uzco2ihn.manus.space/api/radar-buy/v1/search",
    params={"q": "auriculares bluetooth", "marketplace": "es"},
    headers={"X-API-Key": "tu_api_key_aqui"}
)

data = response.json()
for product in data["data"]["products"]:
    print(f"{product['title']} - €{product['price']}")

Autenticación

Todas las peticiones a la API requieren autenticación mediante una API Key. Incluye tu clave en el header X-API-Key de cada petición.

Seguridad: Nunca expongas tu API key en código frontend o repositorios públicos. Usa variables de entorno en el servidor.

Códigos de Error de Autenticación

401 — API key no proporcionada o inválida

403 — API key revocada o sin permisos

429 — Límite de búsquedas diarias excedido

Endpoints

GET/api/radar-buy/v1/search

Busca productos en Amazon por palabra clave y marketplace.

Parámetros

qstringrequeridoTérmino de búsqueda (ej: 'auriculares bluetooth')

marketplacestringCódigo del marketplace (es, de, fr, it, nl, pl, se). Default: es

sort_bystringOrdenar por: relevance, price_low, price_high, rating, sales

min_pricenumberPrecio mínimo en EUR

max_pricenumberPrecio máximo en EUR

min_ratingnumberValoración mínima (1-5)

Ejemplo de Respuesta

{
  "success": true,
  "data": {
    "products": [
      {
        "asin": "B09XYZ1234",
        "title": "Auriculares Bluetooth 5.3...",
        "price": 29.99,
        "currency": "EUR",
        "rating": 4.5,
        "reviewCount": 1250,
        "imageUrl": "https://...",
        "category": "Electrónica",
        "salesRank": 15,
        "trendData": [28.5, 29.0, 29.99, ...]
      }
    ],
    "query": "auriculares bluetooth",
    "marketplace": "es",
    "from_cache": false,
    "searches_remaining": 45
  }
}

GET/api/radar-buy/v1/trending

Obtiene los productos en tendencia en un marketplace específico.

Parámetros

marketplacestringCódigo del marketplace. Default: es

limitnumberNúmero de productos (1-20). Default: 6

Ejemplo de Respuesta

{
  "success": true,
  "data": {
    "products": [
      {
        "asin": "B09ABC5678",
        "title": "Robot Aspirador Inteligente...",
        "price": 199.99,
        "currency": "EUR",
        "rating": 4.7,
        "reviewCount": 3420,
        "salesRank": 1,
        "trendData": [189.0, 195.0, 199.99, ...]
      }
    ],
    "marketplace": "es"
  }
}

GET/api/radar-buy/v1/account

Obtiene información de tu cuenta y uso actual de la API.

Ejemplo de Respuesta

{
  "success": true,
  "data": {
    "plan": "pro",
    "searches_today": 45,
    "searches_limit": 200,
    "searches_remaining": 155,
    "marketplaces": ["es", "de", "fr", "it", "nl", "pl", "se"]
  }
}

Límites de Uso

Plan	Búsquedas/día	Marketplaces	API Keys
Starter	50	3 (ES, DE, FR)	2
Pro	200	7 (todos CE)	5
Business	Ilimitadas	7 (todos CE)	20

El plan Free no incluye acceso a la API. Los límites de búsqueda se reinician diariamente a las 00:00 UTC.

Soporte

Si tienes problemas con la API o necesitas ayuda con la integración, contacta con nuestro equipo de soporte a través de la sección de Tickets de Soporte en tu dashboard.