Service
Normalized South Korea retail fuel prices and gas-station data from KNOC Opinet: national and regional averages, nearby and lowest-price stations, station detail, and area codes.
99.88%30-day uptimeAvg response259ms
Selecting a row opens the reference for that API.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-fuel-price/area-codes | Lists Opinet region codes used by other operations: top-level province/metro codes, or district codes under a parent 2-digit sido. Use when resolving human place names to area_code (korea-fuel-price:lowest-price-stations) or sido_code (korea-fuel-price:sido-average-prices). Do NOT use for fuel prices themselves — use korea-fuel-price:national-average-prices or korea-fuel-price:sido-average-prices instead. Returns area_code and area_name. The province table is a fixed set of 16 codes; district codes are listed one province at a time. | |
| POST | /v1/korea-fuel-price/lowest-price-stations | Lists the lowest-priced gas stations nationwide or in a region (2-digit sido or 4-digit district area_code) for a fuel product from KNOC Opinet, up to 20 stations. Use when the user wants the cheapest gasoline or diesel stations in Korea or a city. Do NOT use for map-radius search — use korea-fuel-price:nearby-stations instead; for full station amenities use korea-fuel-price:station-detail. Returns station_id, name, brand, price_krw_per_liter, addresses, and coordinates. This is a ranking capped at 20 by upstream, not a complete list of the stations in an area. | |
| POST | /v1/korea-fuel-price/national-average-prices | Retrieves the current nationwide average retail fuel prices from KNOC Opinet for gasoline, diesel, premium gasoline, kerosene, and auto LPG, including day-over-day change. Use when the user asks for today's Korea-wide average gas or diesel price or a national price snapshot. Do NOT use for a single station, nearby search, or province-level averages — use korea-fuel-price:station-detail, korea-fuel-price:nearby-stations, or korea-fuel-price:sido-average-prices instead. Returns product_code, average_price_krw_per_liter, trade_date, and change_from_previous_day_krw. Upstream publishes one row per product for the current trade date; this operation carries no history. | |
| POST | /v1/korea-fuel-price/nearby-stations |
Issue a sandbox key and make your first reservation.
APIFuse holds the partner credentials. You hold one managed key.
Receive events such as reservation confirmations and delivery updates.
Service outages and gateway errors normalise into one error model.
| Searches gas stations within a radius of a WGS84 latitude/longitude for a fuel product using KNOC Opinet aroundAll, converting coordinates to KATEC server-side. Use when the user asks for stations near a place, sorted by price or distance. Do NOT use for nationwide cheapest lists — use korea-fuel-price:lowest-price-stations instead; for national averages use korea-fuel-price:national-average-prices. Returns station_id, name, brand, price_krw_per_liter, distance_meters, and coordinates. Radius max 5000 meters. Upstream returns the whole radius set in one response: there is no paging, cursor or upstream total. |
| POST | /v1/korea-fuel-price/recent-daily-averages | Retrieves the recent approximately seven-day national daily average retail fuel price series from KNOC Opinet for trend analysis, optionally filtered by ISO trade_date and product. Use when the user asks how gasoline or diesel prices moved over the last week. Do NOT use for live station prices — use korea-fuel-price:nearby-stations or korea-fuel-price:station-detail instead; for province averages use korea-fuel-price:sido-average-prices. Returns dated average_price_krw_per_liter rows. The window is the most recent seven days Opinet retains, dated in Korea Standard Time (UTC+09:00). |
| POST | /v1/korea-fuel-price/sido-average-prices | Retrieves current province/metropolitan (sido) average retail fuel prices from KNOC Opinet, optionally filtered by 2-digit sido_code and product. Use when the user asks for Seoul, Busan, or other province average gas/diesel prices. Do NOT use for nationwide single-row averages — use korea-fuel-price:national-average-prices instead; for nearby stations or station detail use korea-fuel-price:nearby-stations or korea-fuel-price:station-detail. Returns items with sido_code, product_code, and average_price_krw_per_liter. Rows carry no date of their own: Opinet publishes this table as a current snapshot. |
| POST | /v1/korea-fuel-price/station-detail | Retrieves full detail for one gas station by Opinet UNI_ID including brand, addresses, phone, amenities, quality certification, coordinates, and per-product prices with observation timestamps. Use when the user already has a station_id from a list or nearby search. Do NOT use to discover stations — call korea-fuel-price:lowest-price-stations or korea-fuel-price:nearby-stations first. Returns normalized station fields and prices in KRW per liter with ISO KST timestamps. A station id Opinet does not know is reported as 404, never as an empty station object. |
