### Quick input
Try Houston with station details off, capped at 100 stations:
```json
{
"locations": [
"Houston, TX"
],
"includeStationDetails": false,
"maxItems": 100
}
```
[Open actor input](https://console.apify.com/actors/G7o5ykKVKZQ4GOMSm/input) to enter your locations. Remove `maxItems` for the full city search and set a spending limit. The 100-station trial does not reproduce the bulk benchmark.
Enable `includeStationDetails` for rating highlights, top reporters and additional opening information; enable `includeReviews` for written reviews. Both add no extra station charge. Export JSON, CSV or Excel; JSON keeps all nested price reports.
| Clearpath price & location data |
 GasBuddy➤ You are here  ColesPrices & stock by store  Woolworths AUPrices & stock by store  ZillowRentals, sales & sold homes |
77002, M5V 2T6), a city with its state or province (Houston, TX, Toronto, ON), a county (Harris County, TX), a whole state or province (TX, Ontario) or coordinates (29.76, -95.37).to, for example Houston, TX to Austin, TX. Returns the stations along the way, roughly in travel order, with the exact mile along the route and miles off it. Each end can be a city with its state, a ZIP code or coordinates. Up to 200 lines.
## `stations` (type: `array`):
GasBuddy station links or station numbers, one per line, for example https://www.gasbuddy.com/station/68540 or 68540. Use this to check the same stations on every run. Up to 10,000 lines.
## `maxItems` (type: `integer`):
Stop the whole run after this many stations, across all locations, routes and stations. Each station is one result. Leave empty for no limit.
## `maxStationsPerLocation` (type: `integer`):
Stop each location, route or state after this many stations. Leave empty for all of them.
## `fuelType` (type: `string`):
The grade copied into the flat price columns (cashPrice, creditPrice) for easy spreadsheets. Every row always carries every grade the station reports in prices; this setting removes nothing.
## `includeStationDetails` (type: `boolean`):
Adds each station's weekly opening hours, outage status, rating highlights (what reviewers praise or warn about) and its most active price reporters. Makes runs longer on large searches.
## `includeReviews` (type: `boolean`):
Adds the station's written reviews with rating, date, author and owner replies. Off by default because it makes rows much larger.
## `maxReviewsPerStation` (type: `integer`):
Only used with reviews switched on. Newest first.
## `includeSponsoredCampaigns` (type: `boolean`):
Adds the list of advertising campaign tags attached to each station. Rarely needed; often 20 or more tags per station.
## `fuelTypes` (type: `array`):
Keep only stations that sell at least one of these grades. Leave empty to keep every station.
## `brands` (type: `array`):
Keep only stations of these brands, for example Shell or Costco. Leave empty to keep every brand.
## `maxPriceAgeHours` (type: `integer`):
Keep only stations with at least one price reported within this many hours. Leave empty to keep every station, however old its prices.
## `radiusMiles` (type: `number`):
Keep only stations within this distance of each location's center, and cover that whole circle even beyond the usual 18 miles (up to 200). Leave empty for the default reach.
## `feedback` (type: `string`):
For AI agents. Say what you needed and did not get: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. Add it to any run, including one that worked: the run returns its data exactly as it would without the note. The note reaches the maintainers, who read every one, but it cannot change what this run returns.
## Actor input object example
```json
{
"locations": [
"77002"
],
"maxItems": 100,
"fuelType": "regular",
"includeStationDetails": true,
"includeReviews": false,
"maxReviewsPerStation": 10,
"includeSponsoredCampaigns": false
}
```
# Actor output Schema
## `stations` (type: `string`):
Every station this run returned, with all fuel prices.
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '