BuyWhere

aid: buywhere
url: https://raw.githubusercontent.com/api-evangelist/buywhere/refs/heads/main/apis.yml
name: BuyWhere
type: Index
image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
description: >-
  Agent-native, MCP-native product catalog and price comparison API for Southeast
  Asia and US e-commerce. Search 1.5M+ products across Shopee, Lazada, Carousell,
  FairPrice, Best Denki, Amazon, Walmart, Best Buy, and 20+ retailers. AI agents
  and MCP clients discover and route purchases to local merchants through a hosted
  MCP HTTP endpoint at api.buywhere.ai/mcp or via the @buywhere/mcp-server STDIO
  package.
created: '2026-05-16'
modified: '2026-05-16'
specificationVersion: '0.19'
position: Consumer
access: 3rd-Party
tags:
  - E-commerce
  - Shopping
  - Price Comparison
  - SEA
  - Southeast Asia
  - AI Agents
  - Product Catalog
apis:
  - aid: buywhere:product-catalog-api
    name: BuyWhere Product Catalog API
    description: >-
      Agent-native REST and MCP product catalog covering 1.5M+ products across
      Southeast Asian and US e-commerce platforms. Operations include keyword
      search, side-by-side comparison, deals discovery, price history, and
      category browsing. Responses are Schema.org-compatible (Product, Offer,
      ItemList) and include normalized structured_specs and comparison_attributes
      so LLMs can rank and reason without scraping. Same operations are exposed
      to MCP clients at api.buywhere.ai/mcp.
    humanURL: https://api.buywhere.ai/
    baseURL: https://api.buywhere.ai/v1
    tags:
      - E-commerce
      - Shopping
      - Price Comparison
      - SEA
      - Southeast Asia
      - AI Agents
      - Product Catalog
      - MCP
    properties:
      - url: openapi/buywhere-openapi.yml
        type: OpenAPI
      - url: https://api.buywhere.ai/openapi.json
        type: OpenAPI
      - url: https://api.buywhere.ai/
        type: Documentation
      - url: https://api.buywhere.ai/docs/guides/mcp
        type: MCPDocumentation
      - url: https://api.buywhere.ai/mcp
        type: MCPEndpoint
      - url: https://api.buywhere.ai/.well-known/ai-plugin.json
        type: PluginManifest
      - url: https://api.buywhere.ai/llms.txt
        type: LLMsTxt
      - url: capabilities/shared/buywhere-product-catalog-api.yaml
        type: NaftikoCapability
      - url: capabilities/price-comparison-shopping-agent.yaml
        type: NaftikoCapability
      - url: json-schema/buywhere-product-schema.json
        type: JSONSchema
      - url: json-schema/buywhere-offer-schema.json
        type: JSONSchema
      - url: json-schema/buywhere-price-history-schema.json
        type: JSONSchema
      - url: json-schema/buywhere-category-schema.json
        type: JSONSchema
      - url: json-structure/buywhere-product-structure.json
        type: JSONStructure
      - url: json-structure/buywhere-offer-structure.json
        type: JSONStructure
      - url: rules/buywhere-rules.yml
        type: SpectralRules
      - url: examples/buywhere-searchProducts-example.json
        type: Example
      - url: examples/buywhere-getDeals-example.json
        type: Example
      - url: examples/buywhere-compareProducts-example.json
        type: Example
      - url: examples/buywhere-getProduct-example.json
        type: Example
      - url: examples/buywhere-getProductPrices-example.json
        type: Example
      - url: examples/buywhere-listCategories-example.json
        type: Example
      - url: examples/buywhere-getCategoryProducts-example.json
        type: Example
      - url: examples/buywhere-registerAgent-example.json
        type: Example
      - url: examples/buywhere-mcp-tools-call-example.json
        type: Example
    contact:
      - FN: BuyWhere API
        email: [email protected]
sdks:
  - name: BuyWhere MCP Server (Node)
    url: https://github.com/BuyWhere/buywhere-mcp
    type: SDK
    language: JavaScript
    description: BuyWhere MCP server — search and compare products from SG, SEA, and US markets via Model Context Protocol.
  - name: '@buywhere/mcp-server (npm)'
    url: https://www.npmjs.com/package/@buywhere/mcp-server
    type: SDK
    language: JavaScript
    description: Published MCP STDIO server package — `npx -y @buywhere/mcp-server`.
  - name: buywhere-py
    url: https://github.com/BuyWhere/buywhere-py
    type: SDK
    language: Python
    description: Official Python SDK for the BuyWhere Product Catalog API.
  - name: buywhere-llamaindex
    url: https://github.com/BuyWhere/buywhere-llamaindex
    type: SDK
    language: Python
    description: LlamaIndex FunctionTool wrappers for the BuyWhere product catalog API.
  - name: buywhere-cursor-plugin
    url: https://github.com/BuyWhere/buywhere-cursor-plugin
    type: SDK
    language: Python
    description: BuyWhere MCP Tools for Cursor AI — product search, price comparison, and deals.
  - name: buywhere-mcp-action
    url: https://github.com/BuyWhere/buywhere-mcp-action
    type: GitHubAction
    description: BuyWhere MCP Server packaged as a GitHub Action for product catalog access in workflows.
integrations:
  - name: Claude Desktop
    type: MCPClient
    description: Configure under `mcpServers.buywhere` via STDIO (`npx -y @buywhere/mcp-server`) or hosted HTTP (`https://api.buywhere.ai/mcp`).
    url: https://api.buywhere.ai/docs/guides/mcp
  - name: Cursor
    type: MCPClient
    description: Configure in `.cursor/mcp.json` with the BuyWhere MCP package and BUYWHERE_API_KEY env var.
    url: https://api.buywhere.ai/docs/guides/mcp
  - name: LlamaIndex
    type: AIFramework
    description: FunctionTool wrappers via the buywhere-llamaindex package.
    url: https://github.com/BuyWhere/buywhere-llamaindex
  - name: LangChain
    type: AIFramework
    description: BuyWhere MCP server docs proposed for LangChain documentation (PR in flight).
    url: https://github.com/BuyWhere/langchain-docs-pr
  - name: Custom MCP HTTP clients
    type: MCPClient
    description: Any MCP-compatible client can call `POST https://api.buywhere.ai/mcp` with a Bearer token.
    url: https://api.buywhere.ai/mcp
solutions:
  - name: Price Comparison Agents
    description: Search and compare prices across Southeast Asian and US merchants in a single agent turn.
  - name: Deal Alert Bots
    description: Poll /products/deals with country and discount filters; match against keyword watchlists.
  - name: Shopping Assistants
    description: Conversational shopping helpers that route to local merchants in SG, US, VN, TH, MY.
  - name: Market Research Tools
    description: Cross-merchant price and availability snapshots, plus 90-day price history.
  - name: Cross-Border Commerce
    description: Normalized USD pricing and country-aware filtering for cross-border buying agents.
useCases:
  - find_best_value: Search and side-by-side compare top candidates by normalized USD price.
  - deal_alert: Poll active discounts in a target country and filter by keyword.
  - product_research: Discover categories and pull structured specs to feed an LLM buying guide.
common:
  - url: https://api.buywhere.ai/
    name: Website
    type: Website
  - url: https://api.buywhere.ai/
    name: API Documentation
    type: Documentation
  - url: https://api.buywhere.ai/docs/guides/mcp
    name: MCP Integration Guide
    type: MCPDocumentation
  - url: https://api.buywhere.ai/mcp
    name: MCP Endpoint
    type: MCPEndpoint
  - url: https://api.buywhere.ai/openapi.json
    name: OpenAPI Specification (Upstream)
    type: OpenAPI
  - url: https://api.buywhere.ai/.well-known/ai-plugin.json
    name: AI Plugin Manifest
    type: PluginManifest
  - url: https://api.buywhere.ai/llms.txt
    name: LLMs.txt
    type: LLMsTxt
  - url: https://api.buywhere.ai/us/
    name: BuyWhere US Edition
    type: Website
  - url: https://github.com/BuyWhere
    name: GitHub Organization
    type: GitHub
  - url: https://github.com/BuyWhere/buywhere
    name: Primary GitHub Repository
    type: GitHub
  - url: plans/buywhere-plans-pricing.yml
    name: Plans and Pricing
    type: Plans
  - url: rate-limits/buywhere-rate-limits.yml
    name: Rate Limits
    type: RateLimits
  - url: finops/buywhere-finops.yml
    name: FinOps
    type: FinOps
  - url: vocabulary/buywhere-vocabulary.yml
    name: Vocabulary
    type: Vocabulary
  - url: json-ld/buywhere-context.jsonld
    name: JSON-LD Context
    type: JSONLD
url-source: https://api.buywhere.ai/
maintainers:
  - FN: Kin Lane
    email: [email protected]