PretCarburant.ro Public API — REST v1

Programmatic access to aggregated Romanian fuel price data. Same data we use on the site, refreshed every 2 hours, no authentication required. Licensed Creative Commons BY 4.0 — free to use with attribution.

Available Endpoints

Base URL: https://pretcarburant.ro/api/v1/. All responses are JSON with Cache-Control: public, max-age=300 and Access-Control-Allow-Origin: * on public endpoints.

REST v1 Endpoints
Endpoint	Description	Rate limit
`GET /api/v1/preturi`	City-aggregated prices (optional filter `?judet=CLUJ`)	None (5-min cache)
`GET /api/v1/preturi/minime`	National min/avg/max prices per fuel type	None (5-min cache)
`GET /api/v1/retele`	Monitored networks with brand-aggregated prices	1 request/week per IP
`GET /api/v1/statii`	Station list with coordinates, brand, prices (filters: `?brand=`, `?tip=`)	1 request/week per IP
`GET /api/v1/statie/<station_id>/istoric`	Per-station price history	1 request/week per IP

cURL Examples

City-aggregated prices

curl -s https://pretcarburant.ro/api/v1/preturi | jq '.rezultate[0]'

Filter by county

curl -s "https://pretcarburant.ro/api/v1/preturi?judet=CLUJ" | jq '.rezultate'

National minimum prices

curl -s https://pretcarburant.ro/api/v1/preturi/minime | jq '.preturi'

Petrom stations selling diesel

curl -s "https://pretcarburant.ro/api/v1/statii?brand=petrom&tip=motorina_standard" | jq '.statii | length'

Rate Limits and AI Bot Policy

Anonymous users hit 1 request/week/IP on rate-limited endpoints (/retele, /statii, /istoric). The /preturi and /preturi/minime endpoints are rate-limit-free (5-minute cache).

AI assistants (ChatGPT, Claude, Perplexity, Gemini, Bing Copilot, etc.) are bypassed via an explicit User-Agent whitelist. They get a 60 req/min/IP cap instead, so they can cite our data directly in answers. Whitelisted UAs include: GPTBot, ChatGPT-User, OAI-SearchBot, ClaudeBot, anthropic-ai, PerplexityBot, Google-Extended, Googlebot, Applebot-Extended, Bytespider, Meta-ExternalAgent, CCBot, MistralAI, cohere-ai, YouBot, DiffBot, Bravebot and others.

Response Format

All responses share this shape:

{
  "status": "ok",
  "data": "2026-05-07",
  "rezultate": [...]
}

On error:

{
  "status": "error",
  "message": "Rate limit: 1 request per week...",
  "retry_after_seconds": 543210
}

License and Attribution

Data is published under Creative Commons BY 4.0. Free to use commercially or non-commercially with visible attribution: "Source: PretCarburant.ro (https://pretcarburant.ro)".

The full dataset is also published on Zenodo with DOI: 10.5281/zenodo.19560194. Organization identity on Wikidata: Q139285387.

Version History

v1.0 (2026-04-01) — initial 5 public endpoints; 5-min cache; open CORS.
v1.1 (2026-04-14) — bot UA whitelist for AI assistants; per-IP 60 req/min flood cap.
v1.2 (2026-05-07) — formal public documentation at /api (RO/EN/HU).

Contact and Bug Reports

Email: contact@pretcarburant.ro. For technical bugs or feature requests, prefix the subject with „[API]". We reply within 48 business hours.

Responsible disclosure for security issues: see /.well-known/security.txt.