API Documentation

Quick start

One curl, no auth, no install:

curl https://api.getthepriceof.com/v1/pricing?product=notion

The full OpenAPI 3.1 spec lives at /openapi.json.

Authentication

Three access tiers. The endpoint is identical across all of them — only the rate limit changes.

• Anonymous: 20 queries/day per IP. No header needed.
• Free: 100 queries/month. Sign up for an API key, then send it as Authorization: Bearer po_live_…
• Paid: 2K – 10K queries/month. Upgrade in your dashboard.

curl https://api.getthepriceof.com/v1/pricing?product=notion \
  -H "Authorization: Bearer po_live_YOUR_KEY"

REST endpoints

GET /v1/pricing

Full pricing breakdown for one product. Returns plans, prices, features, and a freshnessScore (1.0 = verified within 3 days).

curl 'https://api.getthepriceof.com/v1/pricing?product=notion'
curl 'https://api.getthepriceof.com/v1/pricing?product=notion&plan=team'
curl 'https://api.getthepriceof.com/v1/pricing?product=notion&plan=team&billing_cycle=annual'

GET /v1/products

List all tracked products. Filter by category.

curl 'https://api.getthepriceof.com/v1/products?limit=100'
curl 'https://api.getthepriceof.com/v1/products?category=crm'

GET /v1/compare

Compare 2–5 products side-by-side. Pass team_size to get total monthly and annual cost per plan.

curl 'https://api.getthepriceof.com/v1/compare?products=notion,linear,asana&team_size=10'

GET /v1/search

Search by name, vendor, or description.

curl 'https://api.getthepriceof.com/v1/search?q=project%20management'

GET /v1/categories

List all category slugs (used by /v1/products?category=…).

POST /v1/reports

Report incorrect or outdated pricing. We use these to prioritize re-verification.

curl -X POST https://api.getthepriceof.com/v1/reports \
  -H "Content-Type: application/json" \
  -d '{
    "product": "notion",
    "reportType": "incorrect_price",
    "description": "Plus plan is $10/seat/month annual, not $8."
  }'

MCP server

Two ways to plug PriceOf into an MCP-compatible agent (Claude Desktop, Cursor, Windsurf, ChatGPT remote MCP, etc.).

Hosted (HTTP) — recommended

Paste the URL into any client that accepts a remote MCP server. No install needed.

{
  "mcpServers": {
    "priceof": {
      "url": "https://api.getthepriceof.com/mcp"
    }
  }
}

Local (npm/stdio)

For clients that only support stdio MCP servers.

{
  "mcpServers": {
    "priceof": {
      "command": "npx",
      "args": ["-y", "-p", "@priceof/mcp-server", "mcp-server"],
      "env": { "PRICEOF_API_KEY": "po_live_YOUR_KEY" }
    }
  }
}

Tools exposed

get_pricing, compare_products, search_products, report_incorrect_pricing, request_product.

Rate limits & errors

Errors return JSON with error and message fields.

• 400 — bad_request: missing or invalid query parameter
• 404 — not_found: product or plan not in the database. Response includes a fetch.status field if we're queueing a fetch.
• 429 — rate-limited: free tier exhausted, try later or upgrade.

Data freshness

Every pricing response includes lastVerifiedAt (ISO timestamp) and freshnessScore (0–1, where 1.0 means verified within 3 days). If you need stronger guarantees, check the timestamp before trusting a price in a buying decision.

Found stale or wrong data? Report via POST /v1/reports or the MCP report_incorrect_pricing tool — it goes straight to the verification queue.