# BuyWhere

BuyWhere is an agent-native product catalog and price comparison API for AI agents and LLM applications. We provide real-time pricing, availability, and product data from major e-commerce platforms across Southeast Asia and the United States.

## Catalog Coverage
- **9.08M+ active products** (verified live at GET /v1/catalog/stats)
- **14,501+ merchants** across Shopee, Lazada, Amazon SG, Amazon US, Walmart, FairPrice, Carousell, and more
- 2 countries: Singapore (SG) and United States (US)
- Currencies: SGD, USD

## REST API Endpoints

### Products
- GET /v1/products/search — Full-text product search with filters (keyword, merchant, price, category, country, currency, availability)
- GET /v1/products/deals — Products on sale, sorted by discount percentage
- GET /v1/products/compare?ids=id1,id2,... — Side-by-side product comparison (2-10 products)
- GET /v1/products/:id — Get full product details by ID
- GET /v1/products/:id/similar — Find similar products
- GET /v1/products/:id/price-history — Historical price chart data
- GET /v1/products/:id/prices — Price snapshots from merchant feeds

### Categories
- GET /v1/categories — List all top-level categories
- GET /v1/categories/:slug — Get category details with subcategories and sample products

### Catalog
- GET /v1/catalog/stats — Aggregate statistics (total products, merchants, countries, recent additions) — unauthenticated

## MCP Server
MCP endpoint: https://api.buywhere.ai/mcp
Authentication: Bearer token (get free key at https://api.buywhere.ai/v1/auth/register)

### MCP Tools
1. **search_products** — Full-text search with merchant, price, category, and country filters.
2. **get_product** — Get full product details by BuyWhere product ID.
3. **get_price** — Get current prices for a product across all available merchants.
4. **compare_prices** — Compare 2–5 products side-by-side with price range, pros/cons, and best-value recommendation.
5. **get_affiliate_link** — Get the click-tracked BuyWhere affiliate link for a product.
6. **get_catalog** — List available product categories in the BuyWhere catalog.

## Authentication

All API endpoints (except /v1/catalog/stats) require a Bearer token:

```
Authorization: Bearer bw_live_YOUR_API_KEY
```

Get a free API key at: https://api.buywhere.ai/v1/auth/register

Free tier: 1,000 calls/month. No credit card required.

## Use Cases
- AI shopping agents and price comparison assistants
- Product discovery and deal alerts
- Cross-merchant price intelligence
- Market research and retail analytics

## Documentation
- API docs: https://api.buywhere.ai/docs
- MCP guide: https://api.buywhere.ai/docs/guides/mcp
- Pricing: https://buywhere.ai/pricing
- GitHub: https://github.com/BuyWhere/buywhere
- npm: https://www.npmjs.com/package/@buywhere/mcp-server

## Rate Limits
- Free: 1,000 calls/month
- Starter: 50,000 calls/month — $9/month
- Pro: 500,000 calls/month — $49/month
- Enterprise: Custom limits

## Company
BuyWhere Pte. Ltd. — Singapore
Contact: api@buywhere.ai
Website: https://buywhere.ai