{
  "openapi": "3.0.1",
  "info": {
    "title": "Cheapest Fuel Prices & Gas Near Me API - ES, FR, IT & US",
    "description": "Cheapest fuel prices near any location: station-level diesel, petrol (e5, e10, sp98) and LPG prices from Spanish, French and Italian government open data, plus official US EIA weekly regional averages. Smart ranking weighs the detour against the pump price. JSON/CSV rows, pay per query.",
    "version": "0.1",
    "x-build-id": "ODrBY2KloPwPJbdzN"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/rolescout~fuelscout-cheapest-fuel-prices/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-rolescout-fuelscout-cheapest-fuel-prices",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/rolescout~fuelscout-cheapest-fuel-prices/runs": {
      "post": {
        "operationId": "runs-sync-rolescout-fuelscout-cheapest-fuel-prices",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/rolescout~fuelscout-cheapest-fuel-prices/run-sync": {
      "post": {
        "operationId": "run-sync-rolescout-fuelscout-cheapest-fuel-prices",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "country": {
            "title": "Country",
            "enum": [
              "ES",
              "FR",
              "IT",
              "US"
            ],
            "type": "string",
            "description": "ES, FR or IT for station-level prices near lat/lon; US for the official EIA weekly average of a region.",
            "default": "ES"
          },
          "lat": {
            "title": "Latitude",
            "minimum": -90,
            "maximum": 90,
            "type": "number",
            "description": "Decimal degrees. Required for ES, FR and IT; ignored for US."
          },
          "lon": {
            "title": "Longitude",
            "minimum": -180,
            "maximum": 180,
            "type": "number",
            "description": "Decimal degrees. Required for ES, FR and IT; ignored for US."
          },
          "grade": {
            "title": "Fuel grade",
            "enum": [
              "e5",
              "e10",
              "sp98",
              "diesel",
              "diesel_premium",
              "lpg"
            ],
            "type": "string",
            "description": "The US has no lpg or diesel_premium series, and US diesel exists only for US, the PADD regions and California.",
            "default": "diesel"
          },
          "region": {
            "title": "US region",
            "type": "string",
            "description": "Country US only, e.g. CA: US for the national average, a PADD region, or a covered state or city such as CA, TX or NY. Leave empty for the national average; it must stay empty for ES, FR and IT."
          },
          "radius": {
            "title": "Search radius (km)",
            "type": "number",
            "description": "Around lat/lon. The service's own default is 10 km."
          },
          "limit": {
            "title": "Maximum stations",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Stations returned per query, 1 to 100. The service's own default is 10. It changes the dataset size, not the price."
          },
          "smart": {
            "title": "Smart ranking (all-in cost)",
            "type": "boolean",
            "description": "Rank stations by all-in cost: pump price plus the fuel burned and the time spent on the round-trip detour, using the five fields below.",
            "default": false
          },
          "liters": {
            "title": "Litres you will buy (smart ranking)",
            "type": "number",
            "description": "Only with smart ranking, e.g. 40; leave empty otherwise. The service's own default is 40."
          },
          "economy": {
            "title": "Vehicle consumption in L/100 km (smart ranking)",
            "type": "number",
            "description": "Only with smart ranking, e.g. 7; leave empty otherwise. The service's own default is 7."
          },
          "speed": {
            "title": "Average detour speed in km/h (smart ranking)",
            "type": "number",
            "description": "Only with smart ranking, e.g. 30; leave empty otherwise. The service's own default is 30."
          },
          "wait": {
            "title": "Minutes at the pump (smart ranking)",
            "type": "number",
            "description": "Only with smart ranking, e.g. 3; leave empty otherwise. The service's own default is 3."
          },
          "time_value": {
            "title": "Value of your time per hour (smart ranking)",
            "type": "number",
            "description": "Only with smart ranking, in the local currency, e.g. 12; leave empty otherwise. The service's own default is 12."
          },
          "points": {
            "title": "More points",
            "type": "array",
            "description": "Extra \"lat,lon\" points, one query each, with the fields above as defaults. Each is one billable event; at most 25 queries per run.",
            "items": {
              "type": "string"
            }
          },
          "queries": {
            "title": "Queries (advanced)",
            "type": "array",
            "description": "A list of query objects using the same field names as above, each merged over the top-level fields: mix countries, grades and points in one run. At most 25 queries per run in total."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}