BuyWhere

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.

BuyWhere publishes 1 API on the APIs.io network: Product Catalog API. Tagged areas include E-commerce, Shopping, Price Comparison, SEA, and Southeast Asia.

The BuyWhere catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

BuyWhere’s developer surface includes authentication, documentation, GitHub presence, and 16 more developer resources.

🌐 Visit website 📡 Source on GitHub

49.1/100 developing ▼ -7.2 Agent 32/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6

1 APIs

E-commerceShoppingPrice ComparisonSEASoutheast AsiaAI AgentsProduct Catalog

Kin Score

Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6

Composite quality — 49.1/100 · developing

Contract Quality 17.4 / 25

Developer Ergonomics 3.9 / 20

Commercial Clarity 7.9 / 20

Operational Transparency 4.8 / 13

Governance 8.3 / 12

Discoverability 6.9 / 10

Agent readiness — 32/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 8 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/buywhere: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 1

Individual APIs this provider publishes, each with its own machine-readable definition.

Rate Limits 1

Documented rate limits and quota policies.

Buywhere Rate Limits

4 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

JSON Schema 4

Standalone JSON Schema definitions for this provider's data models.

Examples 9

Example request and response payloads for these APIs.

Scroll for all 9

Documentation 3

Reference material describing how the API behaves

Documentation

Documentation

MCPDocumentation

MCPDocumentation

OpenAPI

OpenAPI

Agent Surfaces 3

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

MCPEndpoint

MCPEndpoint

LlmsText

LlmsText

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

Vocabulary

Vocabulary

JSONLD

JSONLD

Build 3

SDKs, sample code, and the tooling you integrate with

PluginManifest

PluginManifest

GitHub

GitHub

GitHub

GitHub

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Authentication

Authentication

Operate 1

Status, limits, changes, and where to get help

RateLimits

RateLimits

Commercial 2

Pricing, plans, and the legal terms of use

Plans

Plans

FinOps

FinOps

Company 2

The organization behind the API

Website

Website

Website

Website

Other 1

Properties that don't map to a standard resource type

AgentCard

AgentCard

Source (apis.yml)

aid: buywhere
url: https://raw.githubusercontent.com/api-evangelist/buywhere/refs/heads/main/apis.yml
name: BuyWhere
type: Index
image: https://kinlane-images.s3.amazonaws.com/shared/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-19'
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: LlmsText
  - 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: Examples
  - url: examples/buywhere-getDeals-example.json
    type: Examples
  - url: examples/buywhere-compareProducts-example.json
    type: Examples
  - url: examples/buywhere-getProduct-example.json
    type: Examples
  - url: examples/buywhere-getProductPrices-example.json
    type: Examples
  - url: examples/buywhere-listCategories-example.json
    type: Examples
  - url: examples/buywhere-getCategoryProducts-example.json
    type: Examples
  - url: examples/buywhere-registerAgent-example.json
    type: Examples
  - url: examples/buywhere-mcp-tools-call-example.json
    type: Examples
  contact:
  - FN: BuyWhere API
    email: api@buywhere.ai
sdks:
- name: BuyWhere MCP Server (Node)
  url: https://github.com/BuyWhere/buywhere-mcp
  type: SDKs
  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: SDKs
  language: JavaScript
  description: Published MCP STDIO server package — `npx -y @buywhere/mcp-server`.
- name: buywhere-py
  url: https://github.com/BuyWhere/buywhere-py
  type: SDKs
  language: Python
  description: Official Python SDK for the BuyWhere Product Catalog API.
- name: buywhere-llamaindex
  url: https://github.com/BuyWhere/buywhere-llamaindex
  type: SDKs
  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: SDKs
  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:
- type: AgentCard
  url: a2a/buywhere-a2a.yml
  name: A2A Agent Card
  description: Agent Card served at /.well-known/agent-card.json (flavored against A2A 1.0.0).
- type: AgenticAccess
  url: agentic-access/buywhere-agentic-access.yml
- type: DomainSecurity
  url: security/buywhere-domain-security.yml
- type: Authentication
  url: authentication/buywhere-authentication.yml
- 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: LlmsText
- 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: kin@apievangelist.com

BuyWhere

APIs 1

Open Collections 1

Pricing Plans 1