DEV Community

BuyWhere
BuyWhere

Posted on

Add Real-Time Singapore Product Search to Any AI Agent (5-Minute Integration)

#aiagents #api #tutorial #singapore

Add Real-Time Singapore Product Search to Any AI Agent (5-Minute Integration)

Building an AI agent that needs to search for products in Singapore? Here is the quickest path to live pricing data.

BuyWhere (https://buywhere.ai) is a product catalog API purpose-built for AI agents. One API call, real pricing from Harvey Norman, Shopee, Lazada, and 10+ other Singapore retailers.

Step 1: Get your API key

Sign up at buywhere.ai/developers — takes about 60 seconds.

Step 2: Test the API 

curl "https://api.buywhere.ai/search?q=Samsung+TV" \
  -H "Authorization: Bearer YOUR_API_KEY"
Enter fullscreen mode Exit fullscreen mode

Response:

{
  "query": "Samsung TV",
  "products": [
    {
      "name": "Samsung 55\" 4K Smart TV",
      "price": 899.00,
      "currency": "SGD",
      "retailer": "Harvey Norman",
      "url": "https://...",
      "in_stock": true
    },
    {
      "name": "Samsung Crystal 4K UHD TV 55-inch",
      "price": 849.00,
      "currency": "SGD",
      "retailer": "Shopee",
      "url": "https://...",
      "in_stock": true
    }
  ]
}
Enter fullscreen mode Exit fullscreen mode

Step 3: Add to your agent

OpenAI Agents SDK 

from agents import Agent, function_tool
import requests

API_KEY = "your_buywhere_key"

@function_tool
def search_singapore_products(query: str) -> str:
    """Search for products with live prices from Singapore retailers."""
    r = requests.get(
        "https://api.buywhere.ai/search",
        params={"q": query, "limit": 5},
        headers={"Authorization": f"Bearer {API_KEY}"}
    )
    products = r.json().get("products", [])
    if not products:
        return "No products found."
    return "\n".join([
        f"{p['name']}: S${p['price']:.2f} at {p['retailer']}"
        for p in products
    ])

shopping_agent = Agent(
    name="Singapore Shopping Assistant",
    instructions="""You help users find products in Singapore at the best prices. 
    Use search_singapore_products to get live pricing data.""",
    tools=[search_singapore_products]
)
Enter fullscreen mode Exit fullscreen mode

LangChain 

from langchain.tools import tool

@tool
def search_sg_products(query: str) -> str:
    """Search for products with live Singapore pricing."""
    import requests
    r = requests.get(
        "https://api.buywhere.ai/search",
        params={"q": query},
        headers={"Authorization": "Bearer YOUR_KEY"}
    )
    products = r.json().get("products", [])[:5]
    return "\n".join([f"{p['name']}: S${p['price']} ({p['retailer']})" for p in products])
Enter fullscreen mode Exit fullscreen mode

Claude MCP (Claude Desktop / Continue.dev)

BuyWhere is also available as an MCP server. Add it to your MCP config and any Claude agent can search Singapore products natively.

What it covers

  • 1,000+ products across electronics, home appliances, furniture
  • Major retailers: Harvey Norman, Shopee, Lazada, Courts, Best Denki
  • Updated daily: prices are current
  • Singapore only (for now)

Why not scrape?

Scrapers break constantly. Retailers update their HTML, add bot protection, and change URLs. BuyWhere maintains the data pipeline so you do not have to.

API docs: buywhere.ai/developers

Top comments (0)