REST API v1

Documentación de la API

API pública para consultar precios comparados en 24 tiendas Amazon en todo el mundo.

URL base https://pangeaprice.com/api/v1
Límite: 30 solicitudes por 10 minutos por dirección IP

Clave API

AUTH Authorization: Bearer YOUR_API_KEY

Todas las solicitudes a la API deben autenticarse con tu clave API personal.

Encabezado Authorization

Authorization: Bearer TU_CLAVE_API

Puedes encontrar tu clave API en la página de tu cuenta. Mantenla en secreto: cualquiera con la clave puede hacer solicitudes en tu nombre.

Ejemplo curl

curl -H "Authorization: Bearer TU_CLAVE_API" "https://pangeaprice.com/api/v1/search?query=iPhone+15"

Endpoints

GET /api/v1/search

Busca un producto en todas las tiendas Amazon y devuelve precios convertidos a tu moneda predeterminada.

Parámetros de consulta

Parámetros Type Description
query string Requerido Product name or Amazon URL
currency string Opcional Target currency code (default: EUR)

Respuesta

{
  "success": true,
  "data": {
    "query": "iPhone 15",
    "results": [
      {
        "provider": "amazon",
        "country": "US",
        "currency": "USD",
        "price": 799.00,
        "priceFormatted": "$799.00",
        "convertedPrice": 734.86,
        "convertedCurrency": "EUR",
        "url": "https://www.amazon.com/dp/B0...",
        "availability": "in_stock",
        "title": "Apple iPhone 15 (128 GB) - Black",
        "image": "https://m.media-amazon.com/images/I/...",
        "rating": 4.5,
        "reviewCount": 12345,
        "flag": "us"
      }
    ]
  },
  "error": null,
  "meta": {
    "cached": false,
    "timestamp": "2025-01-15T10:30:00.000Z"
  }
}
Probar
GET /api/v1/currencies

Devuelve todas las monedas soportadas y los tipos de cambio actuales utilizados para la conversión.

Respuesta

{
  "success": true,
  "data": {
    "default": "EUR",
    "rates": {
      "EUR": 1,
      "USD": 1.09,
      "GBP": 0.86,
      "JPY": 161.5,
      "CAD": 1.47,
      "AUD": 1.66
    }
  },
  "error": null,
  "meta": {
    "cached": false,
    "timestamp": "2025-01-15T10:30:00.000Z"
  }
}
Probar
GET /api/v1/providers

Devuelve la lista de proveedores de precios activos y sus dominios soportados.

Respuesta

{
  "success": true,
  "data": [
    {
      "name": "amazon",
      "enabled": true,
      "domains": [
        { "domain": "amazon.com", "country": "US", "currency": "USD" },
        { "domain": "amazon.fr", "country": "FR", "currency": "EUR" },
        { "domain": "amazon.de", "country": "DE", "currency": "EUR" }
      ]
    }
  ],
  "error": null,
  "meta": {
    "cached": false,
    "timestamp": "2025-01-15T10:30:00.000Z"
  }
}
Probar