AutoCentrum APIautocentrum.pl ↗
Search current fuel prices at Polish gas stations by city, brand, or address. Returns price in PLN, fuel type, station name, and last updated timestamp.
What is the AutoCentrum API?
The AutoCentrum.pl API provides access to current fuel prices across Poland through 1 endpoint, search_stations, returning up to 7 fields per record including station name, brand, address, city, fuel type, price in PLN, and an updated_at timestamp. Results are paginated and ordered by most recently updated, letting you query by city name, station brand (e.g. Orlen, Shell), or street address.
curl -X GET 'https://api.parse.bot/scraper/10adcad3-b712-4aa5-8ee3-54f199c7da0d/search_stations?page=1&query=Warszawa' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace autocentrum-pl-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: AutoCentrum fuel prices SDK — search stations in Poland."""
from parse_apis.autocentrum_pl_api import AutoCentrum, ParseError
client = AutoCentrum()
# Search for fuel stations in Warsaw, capped to 5 results
for price in client.fuel_prices.search(query="Warszawa", limit=5):
print(f"{price.brand} {price.address} — {price.fuel_type}: {price.price} PLN ({price.updated_at})")
# Drill into a specific brand in another city
result = client.fuel_prices.search(query="Shell Kraków", limit=1).first()
if result:
print(f"\nFirst Shell in Kraków: {result.station_name}, {result.city}")
print(f" {result.fuel_type}: {result.price} PLN (updated: {result.updated_at})")
# Handle errors gracefully
try:
for item in client.fuel_prices.search(query="Orlen Gdańsk", limit=3):
print(f"{item.station_name} — {item.fuel_type}: {item.price} PLN")
except ParseError as exc:
print(f"Error searching stations: {exc}")
print("\nexercised: fuel_prices.search (by city / by brand+city / error handling)")
Search fuel stations in Poland by city, station name, brand, or address. Returns a flat list of fuel price records — one entry per fuel type per station — ordered by most recently updated. Each record includes station name, brand, street address, city, fuel type, price in PLN, and a relative timestamp of the last price update. Results are paginated with 15 stations per page.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-based). |
| queryrequired | string | Search term matching city name, station brand, or street address (e.g. 'Warszawa', 'Shell Kraków', 'Orlen'). |
{
"type": "object",
"fields": {
"page": "integer",
"query": "string",
"results": "array of fuel price records with station_name, brand, address, city, fuel_type, price, updated_at",
"total_pages": "integer"
},
"sample": {
"page": 1,
"query": "Warszawa",
"results": [
{
"city": "Warszawa",
"brand": "BP",
"price": 6.64,
"address": "Modlińska 54",
"fuel_type": "ON",
"updated_at": "dzisiaj",
"station_name": "BP Modlińska 54"
},
{
"city": "Warszawa",
"brand": "Shell",
"price": 6.79,
"address": "Wał Miedzeszyński 219",
"fuel_type": "FuelSave 95",
"updated_at": "wczoraj",
"station_name": "Shell Wał Miedzeszyński 219"
}
],
"total_pages": 16
}
}About the AutoCentrum API
What the API Returns
The search_stations endpoint returns a flat list of fuel price records sourced from AutoCentrum.pl's fuel price tracker. Each record in the results array represents a single fuel type at a single station, so a station offering Pb95, Pb98, diesel, and LPG will appear as four separate entries. Each record exposes station_name, brand, address, city, fuel_type, price (in PLN), and updated_at — the timestamp of the most recent price update for that specific fuel.
Querying and Pagination
The required query parameter accepts free-text strings matched against city name, station brand, or street address. Searches like 'Warszawa', 'Orlen', or 'Shell Kraków' all work. The optional page parameter (1-based integer) handles pagination; the response always includes total_pages and the current page so you can walk through all results programmatically. There is no separate endpoint for listing cities or brands — those lookups are performed through the same query field.
Coverage and Freshness
Coverage spans gas stations across Poland as listed on AutoCentrum.pl, one of the more widely used Polish fuel price aggregators. Prices are user-reported and station-reported, so the updated_at field is the most reliable indicator of how current a given record is. Stations with no recent updates will still appear in results but will carry older timestamps. The API does not expose historical price data — only the most recently recorded price per fuel type per station is returned.
The AutoCentrum API is a managed, monitored endpoint for autocentrum.pl — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when autocentrum.pl changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official autocentrum.pl API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Find the cheapest Pb95 price in a given Polish city by querying by city name and sorting client-side by
price. - Monitor LPG prices across multiple cities by iterating through paginated
search_stationsresults filtered byfuel_type. - Build a price comparison dashboard for a specific brand (e.g. Orlen vs. BP) using the
brandfield in each result. - Track price freshness by comparing
updated_attimestamps across stations in a region. - Identify all fuel types available at a named station by querying the station name and grouping results by
fuel_type. - Aggregate fuel prices across Polish cities to produce regional average price reports using
cityandpricefields.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does AutoCentrum.pl offer an official developer API?+
What does a single record in the `results` array actually contain?+
station_name, brand, address, city, fuel_type, price (a numeric value in PLN), and updated_at. Because results are one record per fuel type per station, a station with four fuel types returns four separate records in the same response.Can I filter results by a specific fuel type, such as diesel or LPG?+
search_stations endpoint does not accept a fuel type as a query parameter — filtering is limited to city, brand, or address via the query field. You can filter the returned results array client-side using the fuel_type field. If you need server-side fuel type filtering, you can fork this API on Parse and revise it to add that parameter.Does the API return historical fuel price data or price trends over time?+
updated_at field. Historical price series are not exposed. You can fork this API on Parse and revise it to add a historical prices endpoint if AutoCentrum.pl surfaces that data.How does pagination work, and how do I retrieve all results for a query?+
page (current page number, 1-based), total_pages (total number of pages for your query), and query (the search term used). Increment the page parameter from 1 up to total_pages to walk through the full result set for a given query.