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 3 APIs on the APIs.io network: Authentication API, Categories API, and Products 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

46.1/100 developing ▬ flat Agent 37/100 agent ready Full breakdown ↓
scored 2026-08-20 · rubric v0.12.0

3 APIs

E-CommerceShoppingPrice ComparisonSEASoutheast AsiaAI AgentsProduct Catalog

Kin Score

Kin Score How this is scored →
scored 2026-08-20 · rubric v0.12.0

Composite quality — 46.1/100 · developing

Contract Quality 18.0 / 25

Developer Ergonomics 4.3 / 20

Access Clarity 7.9 / 20

Operational Transparency 4.8 / 13

Contract Governance 3.0 / 12

Discoverability 8.2 / 10

Agent readiness — 37/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 0 / 6

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 7 / 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 3

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.23'
position: Consumer
access: 3rd-Party
tags:
- E-Commerce
- Shopping
- Price Comparison
- SEA
- Southeast Asia
- AI Agents
- Product Catalog
tags_raw:
- E-commerce
- Shopping
- Price Comparison
- SEA
- Southeast Asia
- AI Agents
- Product Catalog
apis:
- aid: buywhere:buywhere-authentication-api
  name: BuyWhere Authentication API
  description: Agent registration and API key issuance.
  humanURL: https://api.buywhere.ai/
  baseURL: https://api.buywhere.ai/v1
  tags:
  - Authentication
  properties:
  - type: OpenAPI
    url: openapi/buywhere-authentication-api-openapi.yml
  - type: Documentation
    url: https://api.buywhere.ai/
  - type: MCPDocumentation
    url: https://api.buywhere.ai/docs/guides/mcp
  - type: MCPEndpoint
    url: https://api.buywhere.ai/mcp
  - type: PluginManifest
    url: https://api.buywhere.ai/.well-known/ai-plugin.json
  - type: LlmsText
    url: https://api.buywhere.ai/llms.txt
  - type: JSONSchema
    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: JSONStructure
    url: json-structure/buywhere-product-structure.json
  - type: JSONStructure
    url: json-structure/buywhere-offer-structure.json
  - type: SpectralRules
    url: rules/buywhere-rules.yml
  - type: Examples
    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
- aid: buywhere:buywhere-categories-api
  name: BuyWhere Categories API
  description: Product taxonomy and category browsing.
  humanURL: https://api.buywhere.ai/
  baseURL: https://api.buywhere.ai/v1
  tags:
  - Categories
  properties:
  - type: OpenAPI
    url: openapi/buywhere-categories-api-openapi.yml
  - type: Documentation
    url: https://api.buywhere.ai/
  - type: MCPDocumentation
    url: https://api.buywhere.ai/docs/guides/mcp
  - type: MCPEndpoint
    url: https://api.buywhere.ai/mcp
  - type: PluginManifest
    url: https://api.buywhere.ai/.well-known/ai-plugin.json
  - type: LlmsText
    url: https://api.buywhere.ai/llms.txt
  - type: JSONSchema
    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: JSONStructure
    url: json-structure/buywhere-product-structure.json
  - type: JSONStructure
    url: json-structure/buywhere-offer-structure.json
  - type: SpectralRules
    url: rules/buywhere-rules.yml
  - type: Examples
    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
- aid: buywhere:buywhere-products-api
  name: BuyWhere Products API
  description: Product search, lookup, comparison, deals, and price history.
  humanURL: https://api.buywhere.ai/
  baseURL: https://api.buywhere.ai/v1
  tags:
  - Product
  tags_raw:
  - Products
  properties:
  - type: OpenAPI
    url: openapi/buywhere-products-api-openapi.yml
  - type: Documentation
    url: https://api.buywhere.ai/
  - type: MCPDocumentation
    url: https://api.buywhere.ai/docs/guides/mcp
  - type: MCPEndpoint
    url: https://api.buywhere.ai/mcp
  - type: PluginManifest
    url: https://api.buywhere.ai/.well-known/ai-plugin.json
  - type: LlmsText
    url: https://api.buywhere.ai/llms.txt
  - type: JSONSchema
    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: JSONStructure
    url: json-structure/buywhere-product-structure.json
  - type: JSONStructure
    url: json-structure/buywhere-offer-structure.json
  - type: SpectralRules
    url: rules/buywhere-rules.yml
  - type: Examples
    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
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 3

Open Collections 5

Pricing Plans 1