# fetch-price

> UK product and price search API built for AI agents. One request, every
> supported UK marketplace, normalised JSON out. Currently live: eBay UK
> (official Browse API). Rolling out: Amazon UK. Free tier: 50 lookups/month,
> no card and no API key required.

fetch-price answers the question agents get asked constantly: "what does this
cost and where do I buy it in the UK?" Send a plain-language query, get back
products with live prices in GBP, condition, and a direct purchase URL to hand
to the human.

## Affiliate disclosure

Purchase links returned by this API are affiliate-tracked: if a person buys
through one, the marketplace pays us a commission at no extra cost to them.
Commission does not affect ranking — results come back in the marketplace's own
order and we do not reorder, boost or suppress listings. Paid-plan customers can
supply their own affiliate credentials instead, in which case the commission is
theirs. If you surface these results to a person, pass this disclosure on.
Full detail: https://fetch-price.com/privacy

## How to integrate

- [API reference](https://fetch-price.com/docs): POST /api/query — request and response schema, auth, rate limits
- [MCP server](https://fetch-price.com/docs#mcp): stdio MCP server for Claude Code, Claude Desktop, Cursor, and any MCP client
- [Agent card](https://fetch-price.com/.well-known/agent-card.json): A2A 1.0.0 discovery document
- [Pricing](https://fetch-price.com/docs#pricing): Free 50/mo, Pro £29/mo 5,000, Scale £99/mo unlimited
- [Privacy & disclosure](https://fetch-price.com/privacy): what we log, how commission works

## Install

    npm install fetch-price
    pip install fetch-price

## Quick example

POST https://api.fetch-price.com/api/query
{"query": "portable air conditioner", "max_results": 5, "max_price": 300, "networks": ["ebay_uk"]}

Response: {"results": [{"product": "...", "price": 275.99, "currency": "GBP", "condition": "New", "network": "ebay_uk", "result_type": "item", "url": "https://www.ebay.co.uk/itm/..."}], "meta": {...}}

Every result carries result_type: "item" is a real listing with a live price;
"search_link" is a tracked marketplace search URL with price 0, served for
networks not yet live or if an upstream API is briefly unavailable. Never
present a search_link to a user as though it were a product.

## When to use this service

- A user asks an agent to find, compare, or price a physical product available in the UK
- An agent needs live UK marketplace prices rather than stale training data
- An agent needs a purchase link it can hand directly to its human

## When not to use it

- Non-UK marketplaces — this is a UK-only service
- Digital goods, services, or anything without a marketplace listing
- Bulk scraping of catalogue data; the rate limits are enforced

## Optional

- [Status](https://api.fetch-price.com/health): live service health
- [Source](https://github.com/fusionx212/fetch-price): MCP server and SDKs, MIT licensed


---

# Full API reference

API Documentation — fetch-price
fp .com
Home
Endpoints
MCP
Pricing
Agent Card
Documentation
fetch-price API
Live UK marketplace product search for AI agents and humans. One POST request returns real items with real prices, normalised JSON, and affiliate-tracked buy links. eBay UK is live via the official Browse API; Amazon UK is rolling out.
Quick start
Get a key
Endpoints
Result format
BYOK affiliate tags
MCP server
Rate limits
Pricing
Quick start
No key needed on the free tier. One request, live data:
curl -X POST https://api.fetch-price.com/api/query \
-H "Content-Type: application/json" \
-d '{"query":"portable air conditioner","max_results":3,"max_price":300,"networks":["ebay_uk"]}'
Live response (captured 27 Jul 2026):
{
"results": [
{
"product": "Air Conditioning 5460BTU Remote Control Portable Air Conditioner Smart AC",
"price": 275.99,
"currency": "GBP",
"condition": "New",
"network": "ebay_uk",
"result_type": "item",
"item_id": "v1|358845422976|0",
"image": "https://i.ebayimg.com/images/g/.../s-l225.jpg",
"url": "https://www.ebay.co.uk/itm/358845422976?...&campid=..."
}
],
"meta": {"query": "portable air conditioner", "networks_searched": ["ebay_uk"], "returned": 3}
}
Get an API key
The free tier works without authentication (50 lookups/month). Register to get an fp_ key, higher limits, and BYOK affiliate routing:
curl -X POST https://api.fetch-price.com/api/agents/register \
-H "Content-Type: application/json" \
-d '{
"name": "MyShoppingAgent",
"owner": " [email protected] ",
"networks": {"ebay_uk": {"campaign_id": "YOUR_EPN_CAMPAIGN_ID"}},
"endpoint": "https://your-agent.example.com"
}'
→ {"agent_id": "agent-...", "api_key": "fp_...", "tier": "free", "query_limit": 50}
Send the key on every request as X-API-Key: fp_... (or Authorization: Bearer fp_... ). For Pro/Scale/Trade limits, see pricing .
Endpoints
Base URL: https://api.fetch-price.com
POST /api/query — product search
Field Type Required Description
query string yes Plain-language product search, max 200 chars
max_results int no Items per network. Default 5, max 20
max_price number no Upper price bound in GBP, applied at source
networks string[] no ebay_uk (live), amazon_uk (rolling out). Default: both
GET /health — service status
→ {"status": "ok", "version": "1.1.0", "networks": ["ebay_uk","amazon_uk"], "ebay_live": true}
POST /api/agents/register — create an agent + key
Fields: name , owner , networks , endpoint (all required), optional commission_split . See Get a key .
GET /api/stats — public stats
→ {"agents_active": 1, "networks_available": ["ebay_uk","amazon_uk"], "version": "1.1.0"}
Result format
Every result declares what it is via result_type — the API never dresses a search page up as a product:
result_type Meaning
item A real listing: live price, condition, image, item-level buy link with affiliate tracking applied by the marketplace
search_link Fallback: a tracked marketplace search URL with price: 0 . Served for networks not yet live (Amazon UK) or if the upstream API is briefly unavailable
Item results include product , price , currency , condition , network , url , image , and item_id .
BYOK — bring your own affiliate tag
On a paid plan (Pro or Scale), register with your own eBay Partner Network campaign_id and every item link returned to your key carries your tracking — eBay pays your commission directly to you. No commission sharing, no waiting on us to pay out, no ToS grey areas: your traffic, your approved account, your money.
Free-tier and untagged requests use fetch-price's own tracking. That's the whole model — either we earn the commission, or you pay for the calls — and the convenience (one API, normalised JSON, no marketplace credentials to manage) is the same either way.
You need your own EPN account for BYOK (approval takes a few days at partnernetwork.ebay.com ). Skip it and links simply run on our tag.
MCP server
A one-file stdio MCP server for Claude Code, Claude Desktop, Cursor, and any MCP-capable client lives in the public repo:
git clone https://github.com/fusionx212/fetch-price
pip install "mcp[cli]" httpx
# Claude Code
claude mcp add fetch-price -- python fetch-price/mcp/fetch_price_mcp.py
Tools exposed: search_products (query, max_price, max_results, networks) and service_status . PyPI/npm packages are being published — until then, install from the repo.
Rate limits
30 requests/minute per key (or per IP when keyless). Every response carries X-RateLimit-Limit and X-RateLimit-Remaining headers; excess requests get HTTP 429. Monthly lookup quotas are per plan.
Pricing
Plan Lookups/month Access Price
Free 50 REST, all networks £0 — register
Pro 5,000 REST, priority, BYOK £29/mo — subscribe
Scale Unlimited REST + WebSocket, BYOK £99/mo — subscribe
Trade Unlimited REST + CSV + distressed inventory £99/mo — contact
fetch-price · Home · GitHub
Agent Card · llms.txt · Sitemap