Search observations
Search persisted, source-backed observations without starting a crawl.
GET /api/v1/prices/search Access: prices:read
Developer platform · API v1
Build with source-backed market observations.
Query goods and services by description, CPV code, SKU, MPN or GTIN. Every observed price retains capture time, extraction evidence and its public source URL.
Authentication. Create a scoped key under Account & API Keys, then send it in the X-API-Key header. Read and live-observation scopes are independently revocable.
API resources
Observe prices
Run Exa discovery, fetch candidate pages and persist attributable evidence.
POST /api/v1/prices/observe Access: prices:observe
CPV hierarchy
Search CPV Version 2008 or expand a broad code into descendants.
GET /api/v1/cpv/{code}/overview Access: prices:read
Item price variance
Compare latest supplier offers within one country, with EU ranges as secondary context.
GET /api/v1/items/{item_id}/price-variance Access: prices:read
Market overview
Retrieve observation, source and median coverage for one market.
GET /api/v1/markets/{country}/overview Access: prices:read
Price indices
Read base-100 web-observed price-index series and their coverage.
GET /api/v1/indices Access: prices:read
Watchlists
Create and manage user-scoped daily price monitors and events.
POST /api/v1/watchlists Access: signed-in user
Observation jobs
Queue quota-controlled live discovery and poll its durable result.
POST /api/v1/observation-jobs Access: prices:observe
MCP server
Let LLM clients discover read-only catalogue, CPV, variance and monitoring tools.
POST /mcp/ Access: Bearer fcpi_… · prices:read
Quick start
curl --get 'https://cpi.fastsme.com/api/v1/prices/search' \
--header 'X-API-Key: fcpi_…' \
--data-urlencode 'q=A4 recycled paper' \
--data-urlencode 'market=FR'
# Lowest always means lowest observed in the returned public-source sample.
LLM and MCP discovery
Connect a Streamable HTTP MCP client to https://cpi.fastsme.com/mcp/ and pass Authorization: Bearer fcpi_…. The alpha exposes read-only catalogue search, CPV lookup, same-country price variance, market coverage, watchlists, scan status and the FastCPI methodology resource. OAuth authorization-server support remains on the roadmap; current scoped keys are independently revocable.