PricesAPI Documentation

curl -G "https://api.pricesapi.io/api/v1/products/search" \
  -H "Authorization: Bearer your_api_key" \
  --data-urlencode "q=https://www.jbhifi.com.au/products/apple-macbook-neo-13-inch-with-a18-pro-chip-512gb-8gb-silver" \
  --data-urlencode "country=us"

const apiKey = 'your_api_key';

const params = new URLSearchParams({
  q: 'https://www.jbhifi.com.au/products/apple-macbook-neo-13-inch-with-a18-pro-chip-512gb-8gb-silver',
  country: 'us',
  limit: '3',
});

// Cold calls can take 30-90s — set a long read timeout.
const controller = new AbortController();
const timeout = setTimeout(() => controller.abort(), 95_000);
const response = await fetch(
  `https://api.pricesapi.io/api/v1/products/search?${params}`,
  { headers: { Authorization: `Bearer ${apiKey}` }, signal: controller.signal }
);
clearTimeout(timeout);

const { data: { products }, meta } = await response.json();
console.log(`${products.length} matches (cache: ${meta.cache_source}); ` +
  `top: ${products[0].title} @ ${products[0].price} ${products[0].currency}`);

# One call returns candidates with offers[] inline. --max-time covers cold (30-90s) calls.
curl -G "https://api.pricesapi.io/api/v1/products/search" \
  -H "Authorization: Bearer your_api_key" \
  --max-time 95 \
  --data-urlencode "q=macbook pro" \
  --data-urlencode "limit=3" \
  --data-urlencode "offers_limit=3"

{
  "success": true,
  "data": {
    "query": "Sony WH-1000XM5",
    "country": "us",
    "products": [
      {
        "position": 1,
        "pid": 100569554,
        "gpcid": "11795796123145720151",
        "gid": "17755277695162489284",
        "title": "Sony WH-1000XM5 Wireless Noise Cancelling Headphones",
        "image": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:...",
        "price": 329.99,
        "currency": "USD",
        "condition": null,
        "source": "Best Buy",
        "multi_store": true,
        "rating": 4.8,
        "reviews": 12400,
        "delivery": "Free delivery",
        "tags": [],
        "nearby_distance_km": null,
        "offerCount": 3,
        "offers": [
          {
            "seller": "Best Buy",
            "seller_url": "https://www.bestbuy.com",
            "price": 248,
            "currency": "USD",
            "shipping": 0,
            "condition": "New",
            "url": "https://www.bestbuy.com/product/.../sku/6505727"
          },
          {
            "seller": "Sony",
            "seller_url": "https://electronics.sony.com",
            "price": 249.99,
            "currency": "USD",
            "shipping": 0,
            "condition": "New",
            "url": "https://electronics.sony.com/.../p/wh1000xm5-b"
          },
          {
            "seller": "Target",
            "seller_url": "https://www.target.com",
            "price": 249.99,
            "currency": "USD",
            "shipping": null,
            "condition": "New",
            "url": "https://www.target.com/p/sony-wh-1000xm5-.../A-86314264"
          }
        ]
      }
    ]
  },
  "meta": {
    "latency_ms": 41822,
    "raw_count": 38,
    "gid_bearing_count": 33,
    "cache_source": "miss",
    "discover_ms": 12640,
    "products_ms": 29182
  }
}

{
  "success": true,
  "data": { "query": "asdfghjkl", "country": "au", "products": [] },
  "meta": { "latency_ms": 31204, "raw_count": 0, "gid_bearing_count": 0, "cache_source": "miss" }
}

{
  "success": true,
  "data": {
    "query": "Sony WH-1000XM5",
    "country": "au",
    "products": [
      { "position": 1, "pid": 100569554, "title": "Sony WH-1000XM5", "price": 399,
        "currency": "AUD", "source": "JB Hi-Fi", "offerCount": 0, "offers": [] }
    ]
  },
  "meta": { "latency_ms": 38110, "raw_count": 21, "gid_bearing_count": 18,
            "cache_source": "miss", "degraded": true }
}

# Search by product name, get US results
curl -G "https://api.pricesapi.io/api/v1/products/search" \
  -H "Authorization: Bearer your_api_key" \
  --max-time 95 \
  --data-urlencode "q=MacBook Pro M5 14-inch" \
  --data-urlencode "country=us"

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "API key is invalid",
    "details": "The provided API key was not found"
  }
}

const API_KEY = 'your_api_key';
const BASE_URL = 'https://api.pricesapi.io/api/v1';

async function searchProducts(query) {
  const params = new URLSearchParams({ q: query, limit: '5' }); // max 5
  // Cold calls run the live pipeline (30-90s) — set a long read timeout.
  const controller = new AbortController();
  const timer = setTimeout(() => controller.abort(), 95_000);
  const response = await fetch(
    `${BASE_URL}/products/search?${params}`,
    {
      headers: { Authorization: `Bearer ${API_KEY}` },
      signal: controller.signal,
    }
  );
  clearTimeout(timer);

  if (response.status === 503) {
    const wait = Number(response.headers.get('Retry-After') ?? 5);
    throw new Error(`Scraper busy — retry after ${wait}s`);
  }
  return response.json();
}

// One call returns candidates WITH offers inline — there is no second /offers call.
searchProducts('laptop').then(({ data, meta }) => {
  const products = data.products;
  console.log(`Found ${products.length} products (cache: ${meta.cache_source})`);

  if (products.length > 0) {
    const top = products[0];
    console.log(`Top match: ${top.title} @ ${top.price} ${top.currency}`);
    console.log(`${top.offerCount} merchant offers:`);
    for (const offer of top.offers) {
      console.log(`  ${offer.seller} — ${offer.price} ${offer.currency} (+${offer.shipping} ship)`);
    }
  }
});

// OLD — no longer works. The 2nd call now returns 410 ENDPOINT_GONE.
const search = await fetch(
  `${BASE_URL}/search?q=${encodeURIComponent(query)}`,
  { headers: { 'x-api-key': API_KEY } }
).then(r => r.json());

const top = search.data.products[0];

// 2nd round-trip per product — REMOVED
const offers = await fetch(
  `${BASE_URL}/products/${top.id}/offers`,   // -> 410 ENDPOINT_GONE
  { headers: { 'x-api-key': API_KEY } }
).then(r => r.json());

console.log(offers.data);

// NEW — one call, offers inline. limit max is 5. Set a long timeout (cold = 30-90s).
const { data, meta } = await fetch(
  `${BASE_URL}/products/search?q=${encodeURIComponent(query)}&limit=5`,
  { headers: { Authorization: `Bearer ${API_KEY}` } }
).then(r => r.json());

const top = data.products[0];

// No 2nd request — offers are already here (7 fields each).
for (const offer of top.offers) {
  console.log(offer.seller, offer.price, offer.currency, offer.shipping);
}
console.log('cache:', meta.cache_source);