ORLEN APIorlen.pl ↗
Access ORLEN S.A. wholesale fuel prices, investor reports, dividend history, office locations, and company info via 7 structured API endpoints.
What is the ORLEN API?
The ORLEN API covers 7 endpoints that return structured data from orlen.pl, including company details, contact information, office locations, current wholesale fuel prices in PLN per 1000 liters, fuel product definitions, current stock exchange reports, and dividend history. The get_wholesale_fuel_prices endpoint alone returns seven fields per price record — product name, effective date, publish date, value, location name, location symbol, and unit.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/acf4671e-95b0-428d-a3be-3ceb4b87317c/get_company_info' \ -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 orlen-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: ORLEN S.A. API — company data, fuel prices, and investor info."""
from parse_apis.orlen_s_a__api import Orlen, OrlenUnavailable
client = Orlen()
# Get company info — singleton fetch, typed field access
info = client.companyinfos.get()
print(f"Company: {info.company_name}, HQ: {info.headquarters}")
# List current wholesale fuel prices — limit caps total items
for price in client.fuelprices.list(limit=5):
print(f"{price.product_name}: {price.value} PLN/1000L (effective {price.effective_date})")
# List fuel product definitions
for product in client.fuelproducts.list(limit=5):
print(f"[{product.symbol}] {product.name} / {product.name_en}")
# List office locations
for loc in client.officelocations.list(limit=3):
print(f"{loc.name}: {loc.details[:60]}")
# Investor reports — typed error handling
try:
for report in client.investorreports.list(limit=3):
print(f"{report.number} ({report.date}): {report.title}")
except OrlenUnavailable as exc:
print(f"ORLEN unavailable: {exc}")
print("exercised: companyinfos.get / fuelprices.list / fuelproducts.list / officelocations.list / investorreports.list")
Extract core ORLEN company information including name, description, headquarters address, and social media links. Returns a single record with static company metadata scraped from the ORLEN homepage.
No input parameters required.
{
"type": "object",
"fields": {
"description": "string, company description from the homepage meta tag",
"company_name": "string, the official company name",
"headquarters": "string, headquarters address",
"social_links": "object with platform names as keys and profile URLs as values"
},
"sample": {
"data": {
"description": "Zapewniamy energię i paliwa ponad 100 milionom Europejczyków, a nasze zaawansowane produkty dostępne są w blisko 90 krajach na 6 kontynentach.",
"company_name": "ORLEN S.A.",
"headquarters": "Płock, ul. Chemików 7",
"social_links": {
"tiktok": "https://www.tiktok.com/@grupaorlen",
"threads": "https://www.threads.net/@grupaorlen",
"twitter": "https://twitter.com/GrupaORLEN",
"youtube": "https://www.youtube.com/user/PKNORLENSA",
"facebook": "https://www.facebook.com/ORLENOfficial",
"linkedin": "https://www.linkedin.com/company/orlen"
}
},
"status": "success"
}
}About the ORLEN API
Company, Contact, and Office Data
get_company_info returns the official company name, a description sourced from the homepage, the headquarters address, and a set of social media profile URLs keyed by platform name. get_contact_details aggregates email addresses and phone numbers from ORLEN's homepage and contact page into a flat array of strings. get_office_locations returns an array of office objects, each with a name field and a details field covering address and phone — useful for building location directories or compliance records.
Wholesale Fuel Prices and Product Catalog
get_wholesale_fuel_prices returns ORLEN's current published wholesale pricing. Each record includes productName, effectiveDate, publishFrom, value (numeric price), locationName, locationSymbol, and unit (PLN per 1000 liters). These prices reflect the official ORLEN rack pricing and carry an effective date, making them suitable for time-stamped logging. get_fuel_products returns the full product catalog with integer id, Polish name, English nameEn, and symbol fields — giving you the reference vocabulary to map price records to named products in both languages.
Investor Relations Data
get_investor_reports_current returns current stock exchange reports (raporty bieżące) with a report number, date in DD-MM-YYYY format, and title. get_dividend_info returns dividend history as an array of tables; each table is an array of rows, and each row is an array of cell strings, covering year, dividend per share, total dividend, record date, and payment date. Both endpoints draw from ORLEN's investor relations pages and require no input parameters.
No Input Parameters Required
All seven endpoints are parameterless GET calls. There is no filtering by date range, product type, location, or report category at the endpoint level — each call returns the full current dataset for that resource.
The ORLEN API is a managed, monitored endpoint for orlen.pl — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when orlen.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 orlen.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?+
- Log daily ORLEN wholesale fuel prices with effective dates for fuel cost analysis or procurement benchmarking.
- Build a Polish fuel price tracker that maps
locationSymbolandproductNameto named fuel types using the product catalog. - Aggregate ORLEN contact details and office locations for a B2B directory or corporate data enrichment pipeline.
- Monitor ORLEN current stock exchange reports by polling
get_investor_reports_currentfor new report numbers and titles. - Reconstruct ORLEN dividend history tables for equity research or investor dashboards using
get_dividend_inforow data. - Populate a company profile card with ORLEN's headquarters address and social media links from
get_company_info.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ORLEN provide an official public developer API?+
What does get_wholesale_fuel_prices return, and are historical prices available?+
Can I filter investor reports by date range or report category?+
get_investor_reports_current returns all available current stock exchange reports with number, date, and title fields, but no filtering by date, category, or keyword is built in. You can fork the API on Parse and revise it to add a filtered or paginated reports endpoint.