Developer API
A free, open, key-free JSON API for the Portuguese car market: estimate the import tax (ISV) and annual road tax (IUC) in one call, value a car against live comparables, and read our stock. No sign-up, fair-use per-IP rate limits.
On accuracy: the ISV/IUC figures are a maintained estimate, cross-checked against the official AT (Autoridade Tributária) simulator and the published tax tables. They are not the official AT figure and do not replace the AT simulator or a licensed despachante.
Quickstart
curl 'https://claracars.pt/api/public/isv?cc=1950&co2=130&fuel=petrol&year=2016'
# -> {"isv":{"isv":...,"table":"A"},"iuc":{"iuc":...,"category":"B"}}Endpoints
GET | /api/public/isv | Estimate ISV (import tax) + IUC (annual road tax) in one call. Params: cc, co2, fuel, year, month, used, from_eu, vehicle_type, range_km, particulas. |
GET | /api/public/valuation | Market price range from comparable Portuguese listings. Params: make, model, year, km, fuel?, gearbox?, hp?. |
GET | /api/public/car_refs | Canonical make/model vocabulary. No make → brands; with make → that brand's models. |
GET | /api/public/cars | Current stock. Params: site, lang, make?, fuel?, gearbox?, max_price?, limit, offset. |
GET | /api/public/cars/{slug} | Full detail for one car. |
Base URL https://claracars.pt/api/public. Full machine-readable description: OpenAPI 3.1 spec.
Rate limits & fair use
/isv: ~60 requests/minute per IP (burst 20)./valuation: ~20 requests/minute per IP (it queries live market data).- Over the limit →
HTTP 429with aRetry-Afterheader. - Calculations are deterministic and may be cached at the CDN. Need higher limits for a widget or partner integration? Ask us for a soft key — the public tier stays key-free.
Open source
The ISV/IUC calculators behind this API are open-source (MIT) — use them as a zero-dependency Python library or self-host the API: github.com/claracarspt/calcs.
Embed the calculator
Drop the ISV+IUC calculator on any website — free, no key. Keep the "Estimate by claracars.pt" link (it is rendered inside the frame and is part of the free terms).
<iframe src="https://claracars.pt/embed-isv?lang=pt" width="360" height="380" style="border:0" loading="lazy" title="ISV + IUC calculator"></iframe>MCP server
Same data, as Model Context Protocol tools for AI assistants.
# Remote (Streamable HTTP)
https://claracars.pt/mcp
# stdio
npx -y claracars-mcpDiscovery: /.well-known/mcp.json · Source (MIT): github.com/claracarspt/mcp · More: MCP page