European Fuel Station Price Intelligence (CEE + DACH)

Normalized station-level fuel prices across CEE + DACH — country, point, and route modes for fleet, logistics, travel apps, and vibe-coder workflows.

Standalone Apify Actor for European fuel intelligence (not a single-site scraper). Pairs well with the Google Maps CEE Supplier Shortlist Builder when you already have depot / stop coordinates, and with the Website Change Monitor if you schedule daily price snapshots.

Slug: cee-dach-fuel-intelligence
PPE floor: $0.0025 / station ($2.50 / 1k) + usage · min $0.10

What it does

• Returns normalized station rows for DE, AT, CH, HU, PL, CZ, SK, RO, HR, SI, BG.
• Modes: country (national centroid), point (lat/lng radius), route (deterministic cheapest-stop).
• Adds ECB FX fields (dieselEur, petrol95Eur, …, priceEur), dataConfidence, and regulatory flags.
• Optional brands[], openNow, diffAgainstPrevious, and brand-analytics summary.
• Optional BYOK AI digest (off by default) — never invents regulations; narrates aggregates + flags only.
• Built for n8n, Make, Zapier, and agent workflows.

Who it's for

1. Fleet / logistics teams comparing pump prices near hubs or along corridors.
2. Travel / mobility apps that need structured station prices, not HTML scrapes.
3. Market researchers tracking brand and country price spreads.
4. Vibe coders wiring fuel intelligence into CRM / n8n / Make / Zapier / Apify.
5. Procurement-adjacent teams validating fuel-cost assumptions on routes.

What this actor is — and is not

This Actor helps you read public / official / licensed open fuel feeds into one schema. It does not guarantee every station in a country, negotiate fuel cards, or replace regulator portals.

Use the output for:

• station shortlists and route cheapest-stop
• scheduled price monitoring (diffAgainstPrevious)
• EUR-normalized analytics across borders

Do not treat community/aggregator rows (COMMUNITY_AGGREGATOR_UNVERIFIED) as official regulator dumps.

Live sources & keys

Country	Source	Confidence	Keys
DE	Tankerkönig / MTS-K	OFFICIAL_REALTIME	Buyer tankerkoenigApiKey
AT	E-Control	OFFICIAL_REALTIME	None — cheapest-N only, not full market
RO	PretCarburant	OFFICIAL_REALTIME	None (station endpoint often rate-limited → city averages)
SI	goriva.si	OFFICIAL_REALTIME	None
HR	mzoe-gor.hr	OFFICIAL_REALTIME	None
CH, HU, PL, CZ, SK, BG	Fuelo.net	COMMUNITY_AGGREGATOR_UNVERIFIED	Buyer fueloApiKey

BYOK keys are for buyers — never provided by this Actor. Never paste keys into public Tasks, GitHub, or Store screenshots.

Not used: Google Maps, Waze, holtankoljak /api+/stations (robots-disallowed).

How to get a Fuelo API key (fueloApiKey)

Needed for CH, HU, PL, CZ, SK, BG.

1. Open the free key request form: https://fuelo.net/about/api_key_request
   (The page is in Bulgarian; there is no English URL for this form.)
2. Fill the fields:
   • Име/Фирма — your name or company
   • E-mail — where Fuelo sends the key
   • Web site — product / Actor / company URL
   • Повече информация — short intended use (API only, Apify Actor, rate limits respected)
   • Math captcha (Колко е … ?)
3. Submit. Approval is often immediate; the key is 15 characters and valid right away (Fuelo may revoke it if data was filled incorrectly).
4. Paste the key into Actor input field fueloApiKey (or your Apify secret / task private input — not a public task default).
5. API overview: https://fuelo.net/about/api

Free-tier notes: respect Fuelo’s limits (commonly cited ~5k requests/day). This Actor uses /near for locations and enriches pump prices from the public station page.

How to get a Tankerkönig API key (tankerkoenigApiKey)

Needed for DE.

1. Open the registration form: https://onboarding.tankerkoenig.de/
   Docs hub: https://creativecommons.tankerkoenig.de/
2. Enter your real first and last name (no nicknames — Bundeskartellamt identity rule), email, category, and a short description/URL of your app or Actor.
3. Confirm you are not in the mineral-oil industry and accept ToS / privacy.
4. Wait for manual review; the personal API key arrives by email.
5. Paste it into Actor input tankerkoenigApiKey.

Free-tier limits to respect: search radius ≤ ~25 km, about 1 request/minute, and CC BY 4.0 attribution (e.g. link to tankerkoenig.de). Do not publish the key in forums, GitHub, or public Tasks.

Canonical fuel grades

Input fuel: diesel | petrol95 | petrol98 | lpg | cng | all
Mapped from local names (e.g. DE E10→petrol95, E5→petrol98, SI dizel→diesel).

Partial runs

If one country fails (missing key, adapter error), the run still succeeds with other countries. Check dataset / RUN_STATUS.countryStatus.

What data you get

Field	Description
stationId, brand, name, address, city, postcode	Station identity
lat, lng, distanceKm	Location / distance from query point
diesel, petrol95, petrol98, lpg, cng	Local-currency pump prices when available
*Eur, priceEur	ECB FX normalized EUR fields
currency, lastUpdated, openingHours	Meta
dataConfidence, source, sourceStatus, regulatoryFlags	Honesty / provenance
recordType: brand-analytics	Brand avg/min/max/count summary (separate row)
RUN_STATUS	Per-country status + adapter latency (KV + dataset)

How to use it

1. Pick a mode — country, point, or route.
2. Add keys only when needed — none for AT/SI/HR/RO; tankerkoenigApiKey for DE; fueloApiKey for CH/HU/PL/CZ/SK/BG.
3. Run on Apify cloud (recommended) or locally with apify run.
4. Download the dataset as JSON, CSV, or Excel; check RUN_STATUS if a country is empty.

Input presets

Austria diesel near Vienna (no key — Store / QA)

{
  "mode": "country",
  "countryCode": "AT",
  "fuel": "diesel",
  "radiusKm": 8,
  "maxStations": 15,
  "enableAIDigest": false
}

AT returns E-Control cheapest-N, not the full Austrian market.

Hungary petrol95 near Budapest (needs fueloApiKey)

{
  "mode": "point",
  "countries": ["HU"],
  "lat": 47.4979,
  "lng": 19.0402,
  "radiusKm": 10,
  "fuel": "petrol95",
  "maxStations": 20,
  "fueloApiKey": "YOUR_FUELO_KEY",
  "enableAIDigest": false
}

Germany diesel near Berlin (needs tankerkoenigApiKey)

{
  "mode": "point",
  "countries": ["DE"],
  "lat": 52.52,
  "lng": 13.405,
  "radiusKm": 10,
  "fuel": "diesel",
  "maxStations": 20,
  "tankerkoenigApiKey": "YOUR_TANKERKOENIG_KEY",
  "enableAIDigest": false
}

History (honest)

• Live — default for all supported countries
• asOfDate — best-effort; most sources ignore it (or fail if asOfDateStrict)
• Recommended: schedule the Actor daily and use diffAgainstPrevious for change economics

Pricing

Event	When	USD
station-price	Full snapshot (default)	0.0025
station-price-changed	diffAgainstPrevious=true and price moved	0.0025
route-recommendation	Route mode	0.05
brand-analytics	Brand summary for the run	0.05
ai-digest	Optional BYOK narrative	0.15
Minimum charge	Per run floor	0.10

Enable Pay per event + usage in Apify Console so platform compute costs are passed through to users.

Optional BYOK AI digest (secondary)

Off by default. One narrative per run over aggregates + flags. Missing LLM key → warning; deterministic station data still succeeds.

Local development

cd apify/cee-dach-fuel-intelligence
npm install && npm test && npm run build
cp INPUT.smoke.json INPUT.json && npx apify run -p

Disclaimer

Public / official transparency feeds and licensed open data where adapters are live. You are responsible for downstream use. Platform and source ToS change — verify before high-volume commercial use. Monetization / Store publication may require ~14 days for Apify PPE usage pass-through and pricing notice windows.

Related actors (suite)

Actor	Role
Google Maps CEE Supplier Shortlist	Discover local suppliers
Website Intelligence + Contact	Enrich websites (contacts, tech, compliance)
Dealer / Distributor Locator	Expand brand locator pages
PDF Procurement Document Extractor	Find certs / reports / datasheets
Website Change Monitor	Watch pages for changes
European Fuel Station Price Intelligence (this Actor)	CEE + DACH station fuel prices

Each Actor runs standalone; use them as an optional suite when chaining discovery → enrichment → monitoring → fuel intelligence.

Feedback

Open an issue on the actor’s Apify page or contact Vibe Coder's Life.