Service
한국석유공사 오피넷 기반의 정규화된 한국 주유소 유가·주유소 데이터: 전국·지역 평균 유가, 주변·최저가 주유소, 주유소 상세, 지역 코드.
100.00%30일 가동률평균 응답255ms
행을 선택하면 해당 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 |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
| 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. |
