Docs — ProductSource | API & MCP Documentation

What you get per product

Pricing

Real-time prices at every retailer + marketplace sell prices

Images

Every product photo from every source, deduplicated

Descriptions & SEO

Titles, bullet points, feature lists, specs from every retailer

Availability

In-stock status at 450+ retailers, updated continuously

Brand & Category

Verified brand, department, size, color, weight — normalized

Margin Data

Source cost vs. sell price with profit calculations

Price History

Track changes over time across every source

New Drops

Products newly listed at retailers — first mover data

All matched by UPC/GTIN. One product, every source, one unified record.

Try it live

Enter any UPC and see what comes back. Real data, real-time. No API key needed.

Connect in 30 seconds

Add ProductSource to Claude Code, Codex, or any MCP-compatible client.

claude mcp add product-source --transport http https://mcp.productsource.io/mcp --header "Authorization: Bearer YOUR_API_KEY"

codex mcp add product-source --transport http https://mcp.productsource.io/mcp --header "Authorization: Bearer YOUR_API_KEY"

{
  "mcpServers": {
    "product-source": {
      "type": "streamable-http",
      "url": "https://mcp.productsource.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Get your free API key below — 500 lookups/month, no credit card.

Authentication

All requests require a Bearer token in the Authorization header.

Authorization: Bearer ps_live_your_api_key

MCP Tool Reference

8 tools available. All return structured JSON with complete product data.

lookup_product All Plans

The core tool. Look up any product by UPC — returns everything: title, brand, description, images, specs, prices at every retailer, marketplace sell prices, margin estimates, and availability.

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

search_products All Plans

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

Parameters: query (string), brand (string, optional), category (string, optional), limit (int, default 25, max 100)

compare_prices All Plans

Compare current prices for a product across all retailers and marketplaces. Sorted lowest to highest with shipping costs and tax.

Parameters: upc (string, required)

get_price_history Pro+

Historical price data for a product across retailers and marketplaces. See trends, spot drops, time your buys.

Parameters: upc (string, required), days (int, default 30, max 365)

find_deals All Plans

Find products with the highest verified margin between retail source price and marketplace sell price.

Parameters: category (string, optional), brand (string, optional), min_margin (number, default 20%), limit (int, default 25)

check_availability All Plans

Check in-stock status at specific retailers or across all 450+ sources. Know where to buy right now.

Parameters: upc (string, required), retailers (string array, optional)

get_images Pro+

Every product image from every retailer, deduplicated. Multiple angles, lifestyle shots, packaging — all in one call.

Parameters: upc (string, required)

get_new_listings Business+

Products newly discovered at retailers in the last N hours. Be the first to know about new drops, restocks, and launches.

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

Rate Limits

Monthly quotas reset on the 1st of each month UTC.

Plan	Lookups/mo	Price
Free	500	$0
Pro	10,000	$29/mo
Business	100,000	$99/mo
Enterprise	Unlimited	Custom