REST API v1

API Documentation

Public API for querying compared prices across 24 Amazon stores worldwide.

Base URL https://pangeaprice.com/api/v1

Rate limit: 30 requests per 10 minutes per IP address

API Key

AUTH Authorization: Bearer YOUR_API_KEY

All API requests must be authenticated with your personal API key.

Authorization Header

Authorization: Bearer YOUR_API_KEY

You can find your API key in your account page. Keep it secret — anyone with the key can make requests on your behalf.

curl example

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

Endpoints

GET /api/v1/search

Search for a product across all Amazon stores and return prices converted to your default currency.

Query Parameters

Parameters	Type		Description
`query`	string	Required	Product name or Amazon URL
`currency`	string	Optional	Target currency code (default: EUR)

Response

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

Try it

GET /api/v1/currencies

Returns all supported currencies and current exchange rates used for price conversion.

Response

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

Try it

GET /api/v1/providers

Returns the list of active price providers and their supported domains.

Response

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

Try it