API public PretCarburant.ro — REST v1
Acces programatic la datele agregate despre prețurile carburanților din România. Datele sunt aceleași pe care le folosim și noi pe site, actualizate la fiecare 2 ore, fără autentificare. Licență Creative Commons BY 4.0 — folosește liber, cu atribuire.
Endpoint-uri disponibile
Baza URL: https://pretcarburant.ro/api/v1/. Toate răspunsurile sunt JSON, cu header Cache-Control: public, max-age=300 și Access-Control-Allow-Origin: * pe endpoint-urile publice.
| Endpoint | Descriere | Rate limit |
|---|---|---|
GET /api/v1/preturi |
Prețuri agregate pe orașe (cu filtru opțional ?judet=CLUJ) |
Fără rate limit (cache 5 min) |
GET /api/v1/preturi/minime |
Prețurile minime, medii și maxime la nivel național, per tip de carburant | Fără rate limit (cache 5 min) |
GET /api/v1/retele |
Listă rețele monitorizate cu prețuri agregate per rețea | 1 cerere/săptămână per IP |
GET /api/v1/statii |
Listă stații cu coordonate, brand, prețuri (filtre: ?brand=, ?tip=) |
1 cerere/săptămână per IP |
GET /api/v1/statie/<station_id>/istoric |
Istoricul prețurilor pentru o stație individuală | 1 cerere/săptămână per IP |
Exemple cURL
Prețuri agregate pe orașe
curl -s https://pretcarburant.ro/api/v1/preturi | jq '.rezultate[0]'Filtrare pe județ
curl -s "https://pretcarburant.ro/api/v1/preturi?judet=CLUJ" | jq '.rezultate'Prețuri minime naționale
curl -s https://pretcarburant.ro/api/v1/preturi/minime | jq '.preturi'Stații Petrom cu motorină
curl -s "https://pretcarburant.ro/api/v1/statii?brand=petrom&tip=motorina_standard" | jq '.statii | length'Rate limit și politica pentru bot-uri AI
Pentru utilizatorii anonimi, endpoint-urile non-publice (/retele, /statii, /istoric) au limita de 1 cerere pe săptămână per IP. Endpoint-urile /preturi și /preturi/minime nu au rate limit (cache 5 minute).
Pentru asistenții AI (ChatGPT, Claude, Perplexity, Gemini, Bing Copilot, etc.) am implementat un whitelist explicit pe User-Agent. Aceștia bypass-ează rate limit-ul săptămânal și au în loc o limită de 60 cereri/minut/IP, exact ca să poată cita datele noastre direct în răspunsuri. User-Agent-uri recunoscute: GPTBot, ChatGPT-User, OAI-SearchBot, ClaudeBot, anthropic-ai, PerplexityBot, Google-Extended, Googlebot, Applebot-Extended, Bytespider, Meta-ExternalAgent, CCBot, MistralAI, cohere-ai, YouBot, DiffBot, Bravebot și altele.
Format răspuns
Toate răspunsurile au structura comună:
{
"status": "ok",
"data": "2026-05-07",
"rezultate": [...]
}În caz de eroare:
{
"status": "error",
"message": "Rate limit: 1 cerere pe saptamana...",
"retry_after_seconds": 543210
}Licență și atribuire
Datele sunt publicate sub Creative Commons BY 4.0. Le poți folosi în produse comerciale și non-comerciale, cu atribuire vizibilă: "Sursa: PretCarburant.ro (https://pretcarburant.ro)".
Setul de date complet este publicat și pe Zenodo cu DOI: 10.5281/zenodo.19560194. Identitatea organizației pe Wikidata: Q139285387.
Istoric versiuni
- v1.0 (2026-04-01) — primele 5 endpoint-uri publice; cache 5 min; CORS deschis.
- v1.1 (2026-04-14) — bot whitelist UA pentru AI assistants; per-IP flood cap 60 req/min.
- v1.2 (2026-05-07) — documentație publică formală la
/api(RO/EN/HU).
Contact și raportare bug-uri
Email: contact@pretcarburant.ro. Pentru bug-uri tehnice sau cereri de feature, scrie cu subiectul prefixat „[API]". Răspundem în maxim 48h în zilele lucrătoare.
Disclosure responsabilă pentru probleme de securitate: vezi /.well-known/security.txt.
