REST API v1

API-Dokumentation

Öffentliche API zum Abfragen vergleichener Preise auf 24 Amazon-Shops weltweit.

Basis-URL https://pangeaprice.com/api/v1
Rate-Limit: 30 Anfragen pro 10 Minuten pro IP-Adresse

API-Schlüssel

AUTH Authorization: Bearer YOUR_API_KEY

Alle API-Anfragen müssen mit Ihrem persönlichen API-Schlüssel authentifiziert werden.

Authorization-Header

Authorization: Bearer IHR_API_SCHLUESSEL

Ihren API-Schlüssel finden Sie auf Ihrer Konto-Seite. Behalten Sie ihn geheim — jeder mit dem Schlüssel kann Anfragen in Ihrem Namen stellen.

curl-Beispiel

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

Endpunkte

GET /api/v1/search

Sucht ein Produkt auf allen Amazon-Shops und gibt Preise in der Standardwährung zurück.

Query-Parameter

Parameter Type Description
query string Erforderlich Product name or Amazon URL
currency string Optional Target currency code (default: EUR)

Antwort

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

Gibt alle unterstützten Währungen und aktuelle Wechselkurse zurück.

Antwort

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

Gibt die Liste der aktiven Preisprovider und ihrer unterstützten Domains zurück.

Antwort

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