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.

Ai nevoie de mai mult decât cvota gratuită? Planuri comerciale de la 19 €/lună — 10.000–1.000.000 cereri/lună, trial 3 zile. Vezi planurile →

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-uri REST v1
EndpointDescriereRate limit
GET /api/v1/preturi Prețuri agregate pe orașe (filtru opțional ?judet=CLUJ). Public: top 20 orașe; cu cheie API: toate (~595) 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/judete/<judet> Preț mediu agregat la nivel de județ (ex: /api/v1/judete/CLUJ) 1 cerere/săptămână per IP
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 și id stabil per stație (filtre: ?brand=, ?tip=, ?lat=&lon=&raza=). Public: eșantion 150 înregistrări; cu cheie API: setul complet 1 cerere/săptămână per IP
GET /api/v1/statie/<station_id>/istoric Istoricul prețurilor pentru o stație (station_id = câmpul id din /api/v1/statii; id necunoscut → 404) 1 cerere/săptămână per IP
GET /api/v1/geocode Autocomplete pentru numele orașelor (?q=cluj, minim 2 caractere) 1 cerere/săptămână per IP
POST /api/v1/traseu/custom Stații de-a lungul unei rute A→B (body JSON: start, end, tip) 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'

Stații în rază de 10 km (lat/lon)

curl -s "https://pretcarburant.ro/api/v1/statii?lat=46.77&lon=23.62&raza=10" | jq '.total'

Preț mediu pe județ

curl -s https://pretcarburant.ro/api/v1/judete/CLUJ | jq

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.

Acces comercial — planuri self-serve

Tier-ul gratuit CC-BY 4.0 rămâne neschimbat: 1 cerere/săptămână per IP pe endpoint-urile non-publice, cu atribuire vizibilă. Nu îl închidem și nu îl plafonăm — datele publice rămân publice.

Pentru aplicații, flote, redacții și orice integrare cu volum mare, există planuri comerciale cu activare imediată — cheia API sosește pe email în câteva minute după abonare:

  • Starter — 19 €/lună, 10.000 cereri/lună
  • Pro — 49 €/lună, 100.000 cereri/lună
  • Business — 149 €/lună, 1.000.000 cereri/lună, suport prioritar

Toate includ 3 zile de probă gratuită, acces la toate endpoint-urile fără cvota săptămânală și headerele X-RateLimit-* pentru monitorizarea consumului. Vezi planurile și abonează-te →

Nevoi speciale (SLA contractual, export bulk, snapshot-uri istorice, drepturi extinse fără atribuire)? Scrie-ne pentru o ofertă dedicată.

Istoric versiuni

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.