Autocentrum APIautocentrum.pl ↗
Find current fuel prices at gas stations across Poland by searching by city, station name, or brand. Compare prices in real-time to locate the cheapest fuel options near you with easy navigation through paginated results.
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
The Autocentrum API on Parse exposes 1 endpoint for the publicly available data on autocentrum.pl. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.