Ferret — Benchmark

325 API routes tested, 269 OK (82.8%) — UPDATED June 18, 2026 Auto-generated by bench.py

Summary

Metric	Value
Endpoints tested	325 (all routes auto-detected)
✅ OK	269 (82.8%)
⚠️ 0 items	34 (anti-bot, offline APIs, missing params)
❌ Fail	54 (15 auth/block/rate, 39 other)
Total time	~630s (10 min)
Infrastructure	Obscura headless (46MB) + 9 5G proxies

Top 10 Fastest

Endpoint	Time
/qr	0.005s
/quiz	0.005s
/ping	0.005s
/parsers	0.006s
/api/proxy/status	0.006s
/tuner/stats	0.005s
/mcp/docs	0.007s
/langdetect	0.007s
/french/departements	0.036s
/french/education	0.036s

Top 10 Slowest (functional)

Endpoint	Time
/search/google	18.75s
/instagram	15.91s
/social/ask	15.47s
/position/google	12.56s
/search/rambler	15.14s
/french/elus	8.27s
/iss/location	7.50s
/social/aggregate	5.68s
/aliexpress	4.58s
/hackernews	4.31s

/search/google and /instagram are intentionally slow: Google requires heavy anti-bot evasion, Instagram enforces login. Both still return data via the Obscura headless pool.

Evolution

Date	Routes	OK	%
May 2026	237	171	72.0%
June 18, 2026	325	269	82.8%

Coverage grew by 88 routes (+37%) and the pass rate improved by 10.8 points between May and June 2026.

Failure detail (54)

Auth / Key required (blocking)

/amazon, /etsy, /ebay, /walmart, /twitter, /tiktok, /whatsapp, /telegram, /pinterest, /instagram/http

These endpoints require platform credentials configured in ferret.toml.

Anti-bot / Rate-limit

/trends, /shop/bing, /reviews/trustpilot, /boardgamegeek, /startpage

Intermittent — usually pass on retry with a fresh proxy.

Parse error (HTML structure changed)

/french/immobilier, /french/loyers, /french/musees, /travel/places, /music, /tvmaze, /grammar, /langdetect, /lyrics/search

Upstream sites changed their markup; parsers need a selector refresh.

Dead endpoints / Offline APIs

/french/arbres, /french/bibliotheques, /french/calendrier, /french/elus, /french/adresse, /french/sport, /data/ireland, /data/usa, /wikipedia, /wikipedia/search, /openlibrary, /deezer, /research, /images/google, /maps, /reviews, /batch, /extract, /map

Run the benchmark

python3 bench.py    # Tests all 325 routes automatically

Results are saved to /tmp/ferret_bench_auto.json. The benchmark auto-detects every route registered in the Axum router, so the count grows as new parsers are added.

Parsers — the 333 parsers behind these routes
Business endpoints — cross-cutting analyses