場所なび ガソリン価格API

APIの特徴

利用方法

APIキーを取得後、以下のエンドポイントにGETリクエストを送信してください。

1. 店舗詳細・価格取得

特定のガソリンスタンドのIDがわかっている場合に使用します。

2. 店舗検索・一覧取得

位置情報やキーワード、地域条件で店舗を検索します。
include_average=1 を指定すると、直近の投稿がない場合に都道府県平均価格を自動的に補完して返します。

パラメータ一覧

パラメータ	説明	例
lat, lon	緯度経度。中心点検索に使用します。radiusとセットで使用。	35.6895, 139.6917
radius	検索半径 (km)。デフォルト: 5.0 (最大50)	10
keyword	店名、ブランド、住所の部分一致検索。	ENEOS
pref	都道府県名による絞り込み。	東京都
city	市区町村名による絞り込み。	新宿区
include_average	1を指定すると、価格データがない場合に都道府県平均値を返します。	1

レスポンス例 (JSON)

{
    "count": 5,
    "limit": 20,
    "results": [
        {
            "id": 8267,
            "name": "Dr.Drive セルフ西新宿",
            "brand": "ENEOS",
            "address": "東京都新宿区西新宿3-1-1",
            "lat": 35.685...,
            "lon": 139.692...,
            "distance_km": 1.2,
            "info": {
                "self_service": true,
                "car_wash": true,
                "convenience": false
            },
            "prices": {
                "regular": {
                    "cash": 168.0,
                    "is_average": true,
                    "source": "Ministry of Economy... (東京都 Average)",
                    "date": "2026-01-20"
                },
                "high_oc": null
            }
        },
        ...
    ]
}