Version 1
Open, read-only
No authentication. 60 requests per minute per IP. Suitable for static dashboards, citation in research, and CC BY-SA 4.0 redistribution.
Version 2
Authenticated, extended
Optional X-API-Key. Anonymous = 30 req/min and 7-day history window. Authenticated = up to 10,000 req/min, monthly quota, extended fields.
Authentication
One header to add
Send your API key in the X-API-Key header. The query string ?api_key= is accepted for quick tests but discouraged in production (leaks into logs).
Header example
curl -s https://www.nexthop.fr/api/v2/usage \
-H 'X-API-Key: nh_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6'Endpoints v1
Seven public endpoints
Method
Path
Summary
GET
/api/v1/providers
List all analysed providers, public columns.
GET
/api/v1/providers/{slug}
Single provider detail with criteria breakdown.
GET
/api/v1/scores
Current sovereignty scores, sortable.
GET
/api/v1/export/providers.csv
CSV export of providers (Content-Disposition attachment).
GET
/api/v1/export/providers.json
JSON export of providers.
GET
/api/v1/export/scores.csv
CSV export of current scores.
POST
/api/v1/api-keys/request
Self-service creation of a Free tier key (3 req/h/IP).
Endpoints v2
Five authenticated-aware endpoints
Method
Path
Summary
GET
/api/v2/providers
Paginated providers list. Extended fields when authenticated.
GET
/api/v2/providers/{slug}
Provider detail with detailed criteria (comment field if authenticated).
GET
/api/v2/scores
Current scores with auth-aware quotas.
GET
/api/v2/scores/history
Score change history. 7-day window for anonymous, unlimited if authenticated.
GET
/api/v2/usageauth required
API key usage stats (tier, rate limit, monthly quota). Auth required.
Rate limits and quotas
Per-tier limits
Tier
Rate limit
Monthly quota
Anonymous
30 req/min
No monthly quota
Free
60 req/min
10,000 req/month
Pro
600 req/min
100,000 req/month
Enterprise
10,000 req/min
1,000,000 req/month
Detailed pricing on the pricing page (in French).