REST API v1

Documentation API

API publique pour interroger les prix comparés sur 24 boutiques Amazon dans le monde.

URL de base https://pangeaprice.com/api/v1
Limite : 30 requêtes par 10 minutes par adresse IP

Clé API

AUTH Authorization: Bearer YOUR_API_KEY

Toutes les requêtes API doivent être authentifiées avec votre clé API personnelle.

En-tête Authorization

Authorization: Bearer VOTRE_CLE_API

Vous trouverez votre clé API sur la page de votre compte. Gardez-la secrète — quiconque la possède peut faire des requêtes en votre nom.

Exemple curl

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

Endpoints

GET /api/v1/search

Recherche un produit sur toutes les boutiques Amazon et retourne les prix convertis dans votre devise.

Paramètres de requête

Paramètres Type Description
query string Obligatoire Product name or Amazon URL
currency string Optionnel Target currency code (default: EUR)

Réponse

{
  "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"
  }
}
Tester
GET /api/v1/currencies

Retourne toutes les devises supportées et les taux de change utilisés pour la conversion.

Réponse

{
  "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"
  }
}
Tester
GET /api/v1/providers

Retourne la liste des fournisseurs de prix actifs et leurs domaines supportés.

Réponse

{
  "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"
  }
}
Tester