← Back to documentation

api_v1_launch_announcement

Subject: 🚀 BuyWhere API v1.0 is Live - Powering AI Agent Commerce

Hi [First Name],

We're excited to announce the general availability of BuyWhere API v1.0 — the product catalog infrastructure built specifically for AI agents doing commerce in Singapore and globally.

If you're building AI shopping agents, price comparison tools, deal-finding bots, or any product discovery experience, BuyWhere gives you instant access to real-time product data from major e-commerce platforms.

What's New in v1.0

🔍 Intelligent Search

  • BM25-ranked results for relevance (not just keyword matching)
  • Filter by category, price range, platform, and availability
  • Powered by PostgreSQL FTS5 with ts_rank_cd

💰 Price Comparison

  • Find the lowest price across all platforms for any product
  • Compare 2-5 products side-by-side with detailed field-level diffs
  • See price spread and ranking instantly

🏷️ Deal Discovery

  • Automatically surface products priced below their original price
  • Filter by minimum discount percentage
  • Sort by discount depth for biggest savings first

🤖 AI Agent First-Class Support

  • MCP Server: Connect to Claude Desktop, Cursor, or any MCP client in 5 minutes
    • Tools: search_products, get_product, compare_prices, get_deals
  • Python SDK: Full type safety with Pydantic v2
    • Install: pip install buywhere-sdk
    • LangChain & CrewAI integrations included

📥 Scraping Pipeline Integration

  • Push model: /v1/ingest/products for batch product uploads
  • Pull/track model: /v1/ingestion for run tracking and progress updates
  • Automatic cache invalidation for fresh search results

Get Started in 3 Steps

  1. Get your API key: Sign up at buywhere.ai/api
  2. Read the documentation: api.buywhere.ai/docs
  3. Try it out:
    curl "https://api.buywhere.ai/v1/search?q=laptop&platform=shopee_sg&max_price=1000" \
      -H "X-API-Key: YOUR_KEY"
    

What's Coming Next

We're already working on:

  • Price history (30-day trends for every product)
  • Wishlist alerts (price drop notifications)
  • Additional platforms (Qoo10, Carousell, regional SEA platforms)
  • Streaming search (SSE-based real-time results)

Ready to build? Get your API key now

Best regards, The BuyWhere Team eng@buywhere.com