# PetrolSpy Australia NZ Fuel Price Scraper (`rainminer/petrolspy-com-au-scraper`) Actor

Scrape live Australian and New Zealand fuel prices from PetrolSpy for travel and fleet planners. Extract station names, brands, addresses, GPS, and U91, E10, U95, U98, diesel, and LPG near any city map. No login. Schedule runs, export JSON/CSV/Excel, and feed routing tools via API. Pay per station.

- **URL**: https://apify.com/rainminer/petrolspy-com-au-scraper.md
- **Developed by:** [rainminer](https://apify.com/rainminer) (community)
- **Categories:** Travel, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.86 / 1,000 fuel station scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

![PetrolSpy](https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/BNQWWUJ8lcaBhP8HG-actor-Vo40hX9B25bDfp9wa-HxCQoZoxd1-petrolspy-com-au-scraper.png)

### What does PetrolSpy Australia NZ Fuel Price Scraper do?

**PetrolSpy Australia NZ Fuel Price Scraper** extracts **crowd-reported pump prices** from [PetrolSpy](https://petrolspy.com.au/) across Australia and New Zealand. Point it at a city map URL (Sydney, Melbourne, Auckland, and more) and export **station names, brands, addresses, and live U91 / E10 / U95 / U98 / diesel / LPG prices** without writing any code. **No login required.**

Run it on the **Apify platform** to schedule crawls, export JSON/CSV/Excel, monitor failures, and integrate results via API.

***

### What data can you extract from PetrolSpy?

| Field | Description |
| --- | --- |
| id | PetrolSpy station id |
| name | Station name |
| brand | Brand or banner |
| address / suburb / state / postalCode | Location fields |
| u91Price / e10Price / u95Price / u98Price | Petrol prices in AUD (or NZD) per litre |
| dieselPrice / lpgPrice | Diesel and LPG per litre |
| prices | All reported fuels with amounts, timestamps, and reporters |
| imageUrl | Brand icon |
| latitude / longitude | Station coordinates |
| phone | Public phone number when listed |
| url | Map URL for the station |

***

### Why scrape PetrolSpy?

PetrolSpy is a public crowd-price map for AU and NZ metros. Typical jobs:

1. **Cheapest U91** — Compare independents against the majors in Sydney or Melbourne
2. **Fleet routing** — Pull a metro snapshot before a delivery day
3. **E10 vs U91 spreads** — See where ethanol blend is actually cheaper
4. **Diesel desks** — Track truck and light-diesel prices around depots
5. **NZ coverage** — Run Auckland or Wellington alongside Australian cities
6. **Brand research** — Follow Ampol, BP, Caltex, and independents over time
7. **Alerting** — Feed U91 drops into Slack, email, or a sheet
8. **Travel weekends** — Scan a holiday-town radius before a road trip
9. **Data pipelines** — Automate collection from a public crowd-price network
10. **Dashboards** — Join prices with GPS for routing and cost models
11. **State comparisons** — Run NSW, VIC, QLD, WA, and SA maps in one Actor run
12. **LPG maps** — Filter stations that still publish LPG

***

### How to scrape PetrolSpy

1. Open the Actor in [Apify Console](https://console.apify.com/)
2. Keep the default Sydney map URL, or paste another PetrolSpy city or map URL
3. Optionally set **Latitude**, **Longitude**, and **Search radius** (used when the URL has no city slug or lat/lng)
4. Set **Maximum items** (stations per start URL; keep it small for a test run)
5. Click **Start** and download results from the **Dataset** tab as JSON, CSV, Excel, or HTML

For all input options, see the **Input** tab in Console.

***

### Input

| Field | Description |
| --- | --- |
| Start URLs | PetrolSpy map or city URLs |
| Maximum items | Stations to return **per start URL** (default 5) |
| Latitude / Longitude | Search center when the URL has no city (defaults to Sydney) |
| Search radius | Map box around the center (1–50 km) |
| Proxy configuration | Optional. The scraper works without a proxy in most regions |

Supported start URLs:

- City map: `https://petrolspy.com.au/map/location/au/nsw/2000/sydney`
- Homepage: `https://petrolspy.com.au/`

***

### Output

Each result is one gas station. You can download the dataset in **JSON, HTML, CSV, or Excel**.

```json
{
  "id": "12345",
  "name": "Budget Sydney CBD",
  "brand": "Budget",
  "address": "123 Example St",
  "suburb": "Sydney",
  "state": "NSW",
  "postalCode": "2000",
  "u91Price": 1.939,
  "dieselPrice": 1.899,
  "currency": "AUD",
  "url": "https://petrolspy.com.au/map?station=12345",
  "imageUrl": "https://petrolspy.com.au/img/budget.png"
}
```

***

### How much will it cost to scrape PetrolSpy?

This Actor is **pay per event**. You pay a tiny start fee plus one charge per station pushed to the dataset. On the FREE plan that is **$2.49 per 1,000 stations** (about $0.0025 per station). GOLD and higher Store plans pay less per station. A five-station test run costs well under a dollar.

The crawler is HTTP-only (no browser) and uses **no proxy by default**, so compute stays low. Wider radiuses scale with **maxItems**.

***

### Tips and advanced options

- Raise **radiusKm** (up to 15 km) to capture more of a metro. Larger map boxes are rejected.
- `maxItems` is counted **per start URL**.
- Default run uses no Apify Proxy. Enable a proxy group only if you see timeouts.

***

### FAQ, disclaimers, and support

**Is scraping PetrolSpy legal?**\
This Actor collects only **public** fuel price listings. You are responsible for complying with applicable laws when processing any data.

**Does it need a login?**\
No. Map prices are public.

**Does it cover New Zealand?**\
Yes. Use an Auckland, Wellington, or other NZ map URL (or set coordinates) the same way as Australian cities.

Use the **Issues** tab for feedback. Transfer data via the **API** tab or platform integrations.

***

### Related scrapers

You might also like [Clever-Tanken.de German Fuel Price Scraper](https://apify.com/rainminer/clever-tanken-de-scraper), [FuelWatch WA Official Fuel Price Scraper](https://apify.com/rainminer/fuelwatch-wa-gov-au-scraper), [Carbu.com France Belgium Fuel Price Scraper](https://apify.com/rainminer/carbu-com-scraper), and [Spritpreisrechner.at Scraper](https://apify.com/rainminer/spritpreisrechner-at-scraper).

### Image Credit

Image credit: [petrolspy.com.au](https://petrolspy.com.au/)

# Actor input Schema

## `startUrls` (type: `array`):

PetrolSpy map or city URLs. Coordinates can also come from the fields below.

## `maxItems` (type: `integer`):

Maximum number of gas stations to return per start URL.

## `latitude` (type: `number`):

Search center latitude (WGS84). Used when the start URL has no city or lat/lng. Defaults to Sydney.

## `longitude` (type: `number`):

Search center longitude (WGS84). Used when the start URL has no city or lat/lng. Defaults to Sydney.

## `radiusKm` (type: `integer`):

Map bounding box radius around the search center (maximum 15 km).

## `proxyConfiguration` (type: `object`):

Proxy settings. The scraper works without a proxy in most regions.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://petrolspy.com.au/map/location/au/nsw/2000/sydney"
    }
  ],
  "maxItems": 5,
  "latitude": -33.8688,
  "longitude": 151.2093,
  "radiusKm": 5,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://petrolspy.com.au/map/location/au/nsw/2000/sydney"
        }
    ],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("rainminer/petrolspy-com-au-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": [{ "url": "https://petrolspy.com.au/map/location/au/nsw/2000/sydney" }],
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("rainminer/petrolspy-com-au-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://petrolspy.com.au/map/location/au/nsw/2000/sydney"
    }
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call rainminer/petrolspy-com-au-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,rainminer/petrolspy-com-au-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Vo40hX9B25bDfp9wa/builds/istqkWrtwPUmfyXh2/openapi.json