Developer API

# Search for products
curl -H "x-api-key: YOUR_API_KEY" \
  "https://pricemirage.com/api/v1/products?q=airpods&pageSize=5"

# Get product details
curl -H "x-api-key: YOUR_API_KEY" \
  "https://pricemirage.com/api/v1/products/42"

# Compare prices by UPC
curl -H "x-api-key: YOUR_API_KEY" \
  "https://pricemirage.com/api/v1/prices?upc=190199882775"

# Get top deals in electronics
curl -H "x-api-key: YOUR_API_KEY" \
  "https://pricemirage.com/api/v1/deals?category=electronics&minScore=60"

const API_KEY = 'YOUR_API_KEY';
const BASE = 'https://pricemirage.com/api/v1';

// Search products
async function searchProducts(query, options = {}) {
  const params = new URLSearchParams({
    q: query,
    page: options.page || 1,
    pageSize: options.pageSize || 20,
    ...(options.category && { category: options.category }),
    ...(options.minPrice && { minPrice: options.minPrice }),
    ...(options.maxPrice && { maxPrice: options.maxPrice }),
  });

  const res = await fetch(`${BASE}/products?${params}`, {
    headers: { 'x-api-key': API_KEY },
  });

  if (!res.ok) throw new Error(`API error: ${res.status}`);
  return res.json();
}

// Get product with prices
async function getProduct(id) {
  const res = await fetch(`${BASE}/products/${id}`, {
    headers: { 'x-api-key': API_KEY },
  });
  return res.json();
}

// Usage
const results = await searchProducts('airpods', { maxPrice: 25000 });
console.log(results.data);

import requests

API_KEY = "YOUR_API_KEY"
BASE = "https://pricemirage.com/api/v1"
HEADERS = {"x-api-key": API_KEY}


def search_products(query, **kwargs):
    params = {"q": query, **kwargs}
    resp = requests.get(f"{BASE}/products", headers=HEADERS, params=params)
    resp.raise_for_status()
    return resp.json()


def get_product(product_id):
    resp = requests.get(f"{BASE}/products/{product_id}", headers=HEADERS)
    resp.raise_for_status()
    return resp.json()


def compare_prices(product_id=None, upc=None, asin=None):
    params = {}
    if product_id:
        params["productId"] = product_id
    if upc:
        params["upc"] = upc
    if asin:
        params["asin"] = asin
    resp = requests.get(f"{BASE}/prices", headers=HEADERS, params=params)
    resp.raise_for_status()
    return resp.json()


def get_deals(category=None, min_score=0, limit=20):
    params = {"minScore": min_score, "limit": limit}
    if category:
        params["category"] = category
    resp = requests.get(f"{BASE}/deals", headers=HEADERS, params=params)
    resp.raise_for_status()
    return resp.json()


# Usage
results = search_products("airpods", category="electronics")
for product in results["data"]:
    print(f"{product['name']} — {product['lowest_price']}")

deals = get_deals(min_score=70, limit=10)
for deal in deals["data"]:
    print(f"[{deal['deal']['score']}] {deal['name']} — {deal['lowest_price']}")