# EVD2.ca

> Canadian electric vehicle news aggregator and vehicle database. Tracks every EV sold in Canada with automated news, specs, pricing, and market analysis.

## API

- Documentation: https://www.evd2.ca/api/docs
- OpenAPI Spec: https://www.evd2.ca/api/openapi.json
- Health: https://www.evd2.ca/api/health
- RSS Feed: https://www.evd2.ca/api/feed

## Endpoints

- GET /api/articles — Search EV news (params: q, vehicle, offset, limit max 50)
- GET /api/vehicles — Search vehicle database (params: q, category, make, status, offset, limit max 48)
- GET /api/vehicles/{slug} — Get vehicle by slug with specs and recent articles
- GET /api/blog — List blog posts (params: offset, limit max 50)
- GET /api/blog/{slug} — Get blog post content
- POST /api/subscribe — Subscribe to vehicle updates (double opt-in, body: {email, vehicleSlug})

## Content Negotiation

Request `Accept: text/markdown` on any public page to get structured markdown instead of HTML. Supported pages: homepage, /en/articles, /en/vehicles, /en/vehicles/{slug}, /en/blog, /en/blog/{slug}.

## Discovery

- /.well-known/api-catalog — API catalog (RFC 9727, application/linkset+json)
- /.well-known/mcp/server-card.json — MCP Server Card (SEP-1649)
- /.well-known/agent-skills/index.json — Agent Skills Discovery (v0.2.0)

## Rate Limits

60 requests/minute per IP on read endpoints. 5/minute on subscribe. Responses include X-RateLimit-Remaining header. 429 responses include Retry-After header.

## Data

- 125+ electric vehicles (BEV, PHEV, FCEV) available or coming to Canada
- 30+ news sources checked every 30 minutes
- Vehicle specs: range, battery, MSRP (CAD), seats, drivetrain, V2L, V2H
- Bilingual (English and French)

## Contact

https://www.evd2.ca/en/contact