US Gas Stations Scraper An efficient and powerful Apify actor for scraping detailed information about US gas stations. This scraper allows you to target specific geographic locations or a list of known Google Maps Place IDs. It extracts crucial data including fuel prices, addresses, contact information, and operating hours, providing a comprehensive dataset for market analysis, location intelligence, and other data-driven applications. ## Features - Targeted Scraping: Scrape by city and state, or provide a specific list of Google Maps Place IDs. - Comprehensive Data Extraction: Gathers essential details like name, address, phone number, gas prices (Regular, Midgrade, Premium, Diesel), website, operating hours, and user reviews. - Proxy Integration: Built-in support for Apify Proxy to ensure reliable and anonymous scraping. - Structured Output: Provides data in a clean, well-structured JSON format for easy integration with other systems. - Scalable: Built on the Apify platform, allowing you to scale your scraping jobs to any size. ## Input Parameters To run the scraper, you need to provide input settings. You can do this via the Apify Console UI or by using the API. | Field | Type | Description | | --------------- | --------- | --------------------------------------------------------------------------------------------------------------------- | | placeIds | Array | An array of Google Maps Place IDs to scrape directly. E.g., ["ChIJP3ODowq7QIYRsEPAu4jkeP8"] | | stateCode | String | A two-letter US state code (e.g., "TX", "CA") to search for gas stations within that state. | | cityName | String | The name of the city to scrape within the specified state. | | useApifyProxy | Boolean | Set to true to use Apify Proxy for the requests, which is recommended for any serious scraping. Defaults to true. | Example Input: json { "stateCode": "TX", "cityName": "Houston", "useApifyProxy": true } json { "placeIds": ["ChIJP3ODowq7QIYRsEPAu4jkeP8"], "useApifyProxy": true } ## Output Data Structure The scraper returns a dataset of gas stations with the following structure. Each item in the dataset represents a single gas station. json { "itemUrl": "https://www.google.com/maps/place/Pilot+Travel+Center/@29.8002384,-95.2676262,17z/data=!3m1!4b1!4m6!3m5!1s0x8640bb0aa383733f:0xff78e488bbc043b0!8m2!3d29.8002384!4d-95.2676262!16s%2Fg%2F1tj33h_0?entry=ttu&g_ep=EgoyMDI1MDgxMi4wIKXMDSoASAFQAw%3D%3D", "IdCodes": { "CID": "18408714752793527216", "PID": "ChIJP3ODowq7QIYRsEPAu4jkeP8", "FID": "0x8640bb0aa383733f:0xff78e488bbc043b0" }, "mainImage": "https://lh3.googleusercontent.com/p/AF1QipMmll2Rl8y-wAu42X1IdPhNNDxKJlhxmoPGFnAH=w408-h321-k-no", "imageCount": "", "name": "Pilot Travel CenterSponsoredBy Pilot Travel Center", "gasPrices": [ { "price": 2.54, "type": "Regular", "currency": "USD", "measureUnit": "gallon" }, { "price": 3.14, "type": "Midgrade", "currency": "USD", "measureUnit": "gallon" }, { "price": 3.52, "type": "Premium", "currency": "USD", "measureUnit": "gallon" }, { "price": 3.5, "type": "Diesel", "currency": "USD", "measureUnit": "gallon" } ], "website": "https://locations.pilotflyingj.com/us/tx/houston/4440-north-mccarty-street", "bookingUrl": "", "phoneNumber": "+17136753375", "address": { "address": "4440 N McCarty St", "city": "Houston", "state": "TX", "zipCode": "77013", "plusCode": "RP2J+3W El Dorado / Oates Prairie, Houston, TX", "coordinates": { "lat": "29.8002384", "long": "-95.2676262" } }, "language": "English", "categories": ["Truck stop", "Convenience store", "Gas station"], "services": ["Onsite services", "Wheelchair accessible restroom"], "reviewStats": { "rating": "3.5", "reviewsCount": "", "reviewsDistribution": { "oneStars": "648", "twoStars": "351", "threeStars": "245", "fourStars": "108", "fiveStars": "324" } }, "openHours": { "Thursday": "Open 24 hours", "Friday": "Open 24 hours", "Saturday": "Open 24 hours", "Sunday": "Open 24 hours", "Monday": "Open 24 hours", "Tuesday": "Open 24 hours", "Wednesday": "Open 24 hours" }, "isTempClosed": false, "isPermClosed": false } ## How to Run 1. Create a new task for this actor. 2. Set the input parameters as described above. 3. Click "Start" to run the actor. 4. When the run is finished, you can download the results from the "Dataset" tab in either JSON or other formats.