Creativecommons Tankerkoenig De Tankerkoenig API

Name: Tankerkoenig API
Brand: Tankerkoenig API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentData EnrichmentAddress ValidationapiKey5 EndpointsREST

For Agents

Install Jentic One Beta

Connect the Tankerkoenig API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Tankerkoenig API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fcreativecommons.tankerkoenig.de%2Ftankerkoenig" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fcreativecommons.tankerkoenig.de%2Ftankerkoenig" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Tankerkoenig API.

Search nearby filling stations within a radius around a latitude and longitude pair

Look up the current E5, E10, and diesel prices for a list of station IDs in one call

Find filling stations and their fuel prices within a specific German postal code area

GET STARTED

Start building with Tankerkoenig API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI specification for Tankerkoenig API, keeping it validated and agent-ready. Tankerkoenig serves real-time gasoline and diesel prices for filling stations across Germany, sourced from the official Marktransparenzstelle für Kraftstoffe and released under a Creative Commons licence usable for commercial purposes. The API exposes a small set of read endpoints to search stations by location or postal code, fetch detail by station ID, and pull aggregate price statistics, plus a single write endpoint for filing data complaints.

Use Cases

Patterns agents use Tankerkoenig API for, with concrete tasks.

★ Cheapest fuel near a location

Find the lowest current price for E5, E10, or diesel within a configurable radius around a user's coordinates by calling the station search endpoint. The endpoint returns each station's brand, address, opening status, and live prices in one response, which is enough for an assistant to recommend a station without further calls.

Call GET /stations/search with lat=52.52, lng=13.40, rad=5, type=diesel, sort=price and return the top three stations with their addresses and current diesel prices.

Postal-code price comparison

Compare fuel prices across all stations within a given German postal code by calling the postal-code endpoint, which returns each station with its address and current prices. Useful for local fuel comparison sites, fleet managers planning refuels in a specific district, or chat assistants answering 'where is fuel cheapest in 10115 today'.

Call GET /stations/postalcode with postalcode=10115 and return a table of station name, street, and E5/E10/diesel prices sorted by E10 ascending.

Trip fuel cost estimation

Build an estimate of fuel costs along a planned route by passing the IDs of stations near each waypoint to the bulk lookup endpoint. The single call returns live prices for all requested stations, so the agent can sum the cheapest plausible refuel at each leg without making one HTTP request per station.

Call GET /stations/ids with a comma-separated list of 8 station IDs along an A9 route and return the cheapest diesel price for each leg.

Agent-driven local fuel assistant

Through Jentic, an agent can answer free-form fuel questions for German users by routing them to the correct Tankerkoenig endpoint without the developer wiring each call by hand. Search for 'find a gas station' or 'fuel prices near me', load the matching operation, and execute it with the user's coordinates while Jentic injects the API key from the vault.

Through Jentic, run search('find cheapest diesel near coordinates'), load the Tankerkoenig stations search operation, and execute it with the user's lat/lng to recommend a station.

Key Endpoints

5 endpoints — jentic publishes the only available openapi specification for tankerkoenig api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/stations/search

Search nearby gas stations by coordinates and radius

GET

/stations/postalcode

Search stations within a German postal code

GET

/stations/ids

Bulk lookup of stations and prices by ID

GET

/stats

Aggregate fuel price statistics

POST

/complaint

Submit a price-data complaint

GET

/stations/search

Search nearby gas stations by coordinates and radius

GET

/stations/postalcode

Search stations within a German postal code

GET

/stations/ids

Bulk lookup of stations and prices by ID

GET

/stats

Aggregate fuel price statistics

POST

/complaint

Submit a price-data complaint

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring Tankerkoenig by hand means passing the apikey as a query parameter and assembling the search, postal-code, and station-id lookups yourself against the German fuel-price surface. Through Jentic you install once, import Tankerkoenig from the API Directory, store the apikey once, and your agent calls it.

Permission scoping

Tankerkoenig takes coordinates, postal codes, and station ids as query inputs rather than as URL resource ids, so scope the agent to the operations it needs, such as searching stations or reading prices. Submitting a price complaint stays out unless you include that operation.

Credential isolation

Your Tankerkoenig apikey is stored once, encrypted, by your own Jentic One instance and injected as the apikey query parameter at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'find a gas station near coordinates' or 'cheapest diesel in a postal code', and Jentic returns the matching Tankerkoenig operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

FAQs

Specific to using Tankerkoenig API through Jentic.

Why is there no official OpenAPI spec for Tankerkoenig API?

Tankerkoenig does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Tankerkoenig API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

What authentication does the Tankerkoenig API use?

The API uses an API key passed as the apikey query parameter on every request. The key is a UUID issued by Tankerkoenig after a free request form. Through Jentic, the key is stored in the encrypted vault and injected at execution time so the agent never sees the raw value.

Can I search for gas stations by coordinates with the Tankerkoenig API?

Yes. Call GET /stations/search with lat, lng, and rad query parameters and the response includes nearby stations with their address, opening status, and current E5, E10, and diesel prices.

What are the rate limits for the Tankerkoenig API?

Tankerkoenig publishes fair-use rules on its terms page rather than fixed numeric limits in the spec. Polling individual stations more often than once every five minutes is discouraged. For dashboards or fleet tools, prefer /stations/ids for bulk lookups instead of one request per station.

Is the Tankerkoenig API free?

Yes. The data is published under a Creative Commons licence and the API is free to use, including for commercial projects, provided attribution requirements in the licence are met.

How do I find the cheapest diesel near a user with Tankerkoenig through Jentic?

Install Jentic with pip install jentic, then run an async search for 'find cheapest diesel near coordinates'. Jentic returns the GET /stations/search operation; load its schema and execute with the user's lat, lng, rad, and type=diesel. Jentic attaches the apikey from the vault automatically.