API v1.0

Friday's Watchlist API

31,000+ car auctions. Fair market values. Deal scores. Market intelligence. Build auction analytics into your app in minutes.

Get API Key Quickstart

SDKs

🟡

JavaScript / TypeScript

npm install @fridayswatchlist/sdk

Zero dependencies. Works in Node.js 18+ and modern browsers. Full TypeScript types.

🐍

Python

pip install fridayswatchlist

Python 3.9+. Zero dependencies (uses stdlib). Type hints. Dataclass responses.

Quickstart

1. Get your API key

2. Search auctions

curl "https://api.fridayswatchlist.com/auctions/search?q=manual+porsche+911+under+100k" \
  -H "X-API-Key: your-api-key"

3. Get a fair value

curl "https://api.fridayswatchlist.com/valuation?make=Porsche&model=911+GT3&yearMin=2018&yearMax=2022&mileage=15000" \
  -H "X-API-Key: your-api-key"

4. Get a full auction report

curl "https://api.fridayswatchlist.com/report/65a1b2c3d4e5f6789" \
  -H "X-API-Key: your-api-key"

Authentication

Pass your API key in the X-API-Key header with every request.

curl "https://api.fridayswatchlist.com/stats" \
  -H "X-API-Key: fw_live_abc123..."

API Tiers

Free

5 requests/day

Try the API with basic search and truncated reports

Pro

$9.99/mo

100 requests/day

Full reports, sentiment, bid intelligence

Dealer

$49/mo

500 requests/day

Bulk valuations, full API access

API

$99–199/mo

10,000+ requests/day

Enterprise — high volume, priority support

Rate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

API Reference

Search

Valuation

Reports

Bid Intelligence

Sentiment

Ask the Seller

Discovery

Weekly Digest

Price Prediction Game

Slang Search

Stats

Error Handling

The API returns standard HTTP status codes. Errors include a JSON body with an error field.

200Success

400Bad request — missing or invalid parameters

401Unauthorized — invalid or missing API key

404Not found — auction or resource does not exist

429Rate limited — too many requests for your tier

500Server error — retry with exponential backoff

Claude MCP Integration

Use Friday's Watchlist directly inside Claude via the Model Context Protocol. Ask Claude to find deals, research comps, or check market trends — it queries live FW data automatically.

Install (Claude CLI)

claude mcp add fridayswatchlist \
  --transport http https://mcp.fridayswatchlist.com \
  --header "X-FW-API-Key: YOUR_API_KEY"

Install (Claude Desktop)

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "fridayswatchlist": {
      "type": "http",
      "url": "https://mcp.fridayswatchlist.com",
      "headers": { "X-FW-API-Key": "YOUR_API_KEY" }
    }
  }
}

Available MCP tools

fw_get_sniper_dealsLive auctions scored against fair value — sorted best deals first

fw_search_auctionsSearch sold and live auction history

fw_estimate_fair_valueAI fair value estimate for any make/model/year

fw_get_pulse_todayToday's market pulse: biggest sale, best deal, temperature

fw_get_market_trendsPrice trends and sell-through rate for a make/model

OpenAPI Specification

Download the full OpenAPI 3.1 spec to auto-generate clients in any language.

Download openapi.yaml

Ready to build?

Get your API key and start querying 31,000+ auctions in minutes. Free tier includes 5 requests/day.

Get API Key GitHub