API Documentation

REST API and MCP server for real-time product data from 450+ retailers.

MCP Server Connection

Add ProductSource to your Claude Desktop or any MCP-compatible client by adding the following to your .mcp.json configuration file.

.mcp.json

{
  "mcpServers": {
    "productsource": {
      "url": "https://mcp.productsource.io",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Get your API key by emailing api@productsource.io.

Authentication

All API requests require a Bearer token in the Authorization header.

# REST API example
curl https://mcp.productsource.io/lookup \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"upc": "012345678901"}'

MCP Tool Reference

The following tools are available via MCP and equivalent REST endpoints.

lookup_product All Plans

Retrieve full product data by UPC, including current retail prices, marketplace prices, stock status, images, and attributes.

Parameters: upc (string, required) — 12 or 13 digit UPC/EAN barcode

search_products All Plans

Search the product catalog by keyword, brand, or category. Returns matching products with current pricing.

Parameters: query (string, required), brand (string, optional), category (string, optional), limit (int, optional, default 20)

compare_prices All Plans

Compare the current price of a product across all tracked retailers and marketplaces, sorted from lowest to highest.

Parameters: upc (string, required), include_shipping (bool, optional, default false)

get_price_history Pro+

Retrieve historical price data for a product at a specific retailer or across all retailers. Useful for trend analysis and buy timing.

Parameters: upc (string, required), retailer (string, optional), days (int, optional, default 30)

find_deals All Plans

Find products with profitable margins between retail cost and marketplace selling price. Filter by minimum margin, category, and retailer.

Parameters: min_margin_pct (float, optional, default 15), category (string, optional), retailer (string, optional), limit (int, optional, default 20)

check_availability All Plans

Check current in-stock status for a product across all tracked retailers. Returns per-retailer availability and quantity where available.

Parameters: upc (string, required)

get_images Pro+

Retrieve all known product images for a UPC, sourced and deduplicated across retailers and marketplaces.

Parameters: upc (string, required)

get_new_listings Business+

Get products newly discovered at tracked retailers within the specified time window. Useful for monitoring launches and restocks.

Parameters: retailer (string, optional), hours (int, optional, default 24), category (string, optional), limit (int, optional, default 50)

Rate Limits

Rate limits are enforced per API key. Monthly quotas reset on the first of each month UTC.

Plan	Monthly Lookups	Requests / Second	Concurrent Connections
Free	500	1	1
Pro	10,000	10	5
Business	100,000	50	20
Enterprise	Unlimited	Custom	Custom

Rate limit headers are returned on every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Ready to get started?

Email us to get your API key. Free tier, no credit card required.

Email api@productsource.io