Getting Started

BuyWhere is a product catalog API built for AI agents and developers. Search 5M+ products from 40+ retailers across Southeast Asia and the US, compare prices, track deals, and integrate product data into any application or AI workflow.

Get Your API Key

Register for a free API key:

curl -X POST https://api.buywhere.ai/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "agent_name": "my-shopping-agent",
    "email": "you@example.com",
    "use_case": "price comparison agent"
  }'

{
  "api_key": "bw_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "tier": "unverified",
  "message": "Check your email to verify and unlock 60 req/min."
}

Save your key — it is shown only once. Verify your email to upgrade from 5 req/min to 60 req/min (free tier).

Or sign up at buywhere.ai/api-keys.

Your First API Call

curl

export BUYWHERE_API_KEY="bw_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

curl -s "https://api.buywhere.ai/v1/products/search?q=wireless+headphones&limit=3" \
  -H "Authorization: Bearer $BUYWHERE_API_KEY" | jq .

Python

import httpx

API_KEY = "bw_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

resp = httpx.get(
    "https://api.buywhere.ai/v1/products/search",
    params={"q": "wireless headphones", "limit": 3},
    headers={"Authorization": f"Bearer {API_KEY}"},
)
data = resp.json()

for product in data["results"]:
    print(f"{product['title']} — {product['price']['currency']} {product['price']['amount']}")

Node.js

const API_KEY = "bw_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";

const res = await fetch(
  "https://api.buywhere.ai/v1/products/search?q=wireless+headphones&limit=3",
  { headers: { Authorization: `Bearer ${API_KEY}` } }
);
const data = await res.json();

data.results.forEach((p) =>
  console.log(`${p.title} — ${p.price.currency} ${p.price.amount}`)
);

Example Response

{
  "results": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "title": "Sony WH-1000XM5 Wireless Headphones",
      "price": { "amount": 349.00, "currency": "SGD" },
      "merchant": "amazon.sg",
      "url": "https://www.amazon.sg/dp/B09XS7JWHH",
      "image_url": "https://m.media-amazon.com/images/I/51aXvjzcukL.jpg",
      "region": "SG",
      "country_code": "SG",
      "original_price": 549.00,
      "discount_pct": 36
    }
  ],
  "total": 1842,
  "page": { "limit": 3, "offset": 0 },
  "response_time_ms": 145,
  "cached": false
}

Pricing Tiers

See Pricing for full details.

What's Next

• Authentication — API key usage, rate limits, and headers
• API Reference — full endpoint documentation
• Error Reference — all error codes and responses
• Build a Price Comparison Tool — Python quickstart guide
• MCP Integration — connect BuyWhere to Claude Desktop, Cursor, and other AI tools