Opet district fuel prices and history
Under maintenancePricing
$1.00 / 1,000 price records
Opet district fuel prices and history
Under maintenanceCurrent Opet district pump prices for Turkey, plus per-district price history.
Current Opet pump prices by district, and the days those prices changed. One run calls the opet-prices Worker and writes one dataset item per result.
Each dataset item costs $0.001 ($1.00 per 1,000 items). A price item is one published product in one district on one day. A reference item is the whole province list, or the last-update date. Both kinds cost the same. Starting a run is free. A run that finds nothing, or that fails, writes no items and costs nothing.
Query
Set mode. The other fields are read only for the mode that needs them.
| mode | fields | items |
|---|---|---|
province | provinceCode | one price item per published product per district |
location | latitude, longitude | one price item per published product |
archive | districtCode, start, end | one price item per published product per change-day |
provinces | none | one reference item, the province list |
lastUpdate | none | one reference item, Opet's last price date |
provinceCode is an integer from 1 to 9999. 34 is İstanbul Anadolu. 934 is İstanbul Avrupa. districtCode is six digits. start and end are ISO date-times, end is on or after start, and the span is at most 366 days.
Price item
day is null for a current price. For archive, day is the change-day string Opet returned. Days without a change are absent. A product Opet did not publish has amount 0 upstream and is omitted here, so it is not billed. Archive items include districtCode and not the province name, because the history payload does not carry it.
A reference item looks like { "kind": "reference", "reference": "provinces", "provinces": [{ "code": 1, "name": "ADANA" }], "fetchedAt": "..." } or { "kind": "reference", "reference": "last-update", "lastUpdateDate": "01.11.2026", "fetchedAt": "..." }.
An unknown province comes back as a failed run with status not_found. Invalid input fails before any request, with status invalid_input.
