# Octopus Energy UK Tariffs Scraper (`parseforge/octopus-energy-tariffs-scraper`) Actor

Export Octopus Energy tariff products for UK regions. Pull tariff codes, unit rates, standing charges (incl. and excl. VAT), exit fees, green flags, and tracker / variable / prepay attributes per GSP region (A-P). Filter by tariff type or region.

- **URL**: https://apify.com/parseforge/octopus-energy-tariffs-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Business, Other, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $15.00 / 1,000 result items

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/platform/actors/running/actors-in-store#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

![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true)

## ⚡ Octopus Energy UK Tariffs Scraper

> 🚀 **Export the live Octopus Energy product catalog in seconds.** Pull every UK tariff with unit rate, standing charge, exit fees, green and tracker flags, and per-region pricing across all 14 GSP regions. No API key, no registration, no manual CSV wrangling.

The **Octopus Energy UK Tariffs Scraper** exports the live Octopus Energy product catalog and returns **29 fields per record** per tariff per region, including product code, display name, unit rate and standing charge (both inc-VAT and exc-VAT), exit fees, online and dual-fuel discounts, tariff direction (IMPORT or EXPORT), brand, and full attribute flags for green, tracker, variable, prepay, business, and restricted tariffs. Octopus is the UK's largest green energy supplier and publishes its full tariff catalog as a public reference.

The catalog covers **all 14 UK Grid Supply Point regions (A through P), 3 brands (Octopus Energy, Co-op Energy, London Power), and the complete IMPORT plus EXPORT tariff stack** including SMETS2 smart-meter products, Agile half-hourly pricing, Tracker daily pricing, and EV-specific tariffs. This Actor makes that data downloadable as CSV, Excel, JSON, or XML in under five minutes. All filters run server-side, so you skip the parser engineering entirely.

| 🎯 Target Audience | 💡 Primary Use Cases |
|---|---|
| UK energy switching platforms, smart-home developers, solar and battery installers, sustainability researchers, fintech, fleet/EV planners, journalists | Tariff comparison engines, smart-meter optimization, EV-charging cost models, export tariff analyses, carbon-impact dashboards, switching-savings calculators |

### 📋 What the Octopus Energy UK Tariffs Scraper does

Eight filtering workflows in a single run:

- 🔍 **Specific tariff lookup.** Pass a single product code (e.g. `AGILE-24-10-01`) to fetch just that product.
- 📈 **Variable tariffs only.** Pull only variable-price products (Agile, Tracker, flexible).
- 🌱 **Green tariffs only.** Restrict to 100% renewable electricity products.
- 📊 **Tracker tariffs only.** Daily-updated wholesale-linked products.
- 💳 **Prepay tariffs only.** Pay-as-you-go meter tariffs.
- 🏢 **Business tariffs only.** Non-domestic tariffs.
- 🗺️ **GSP region filter.** Restrict per-region rows to one of the 14 UK Grid Supply Points (A-P).
- 🏷️ **Brand filter.** Octopus Energy, Co-op Energy, or London Power.

Each record includes product naming, fuel type and register, payment method, tariff code, region, all pricing (standing charge, unit rate, exit fees, discounts) in both inc-VAT and exc-VAT form, direction flag (IMPORT or EXPORT), brand, full boolean attribute flags, and the product availability window.

> 💡 **Why it matters:** UK energy switching is a £15B+ market and tariff data drives every comparison engine, smart-home optimizer, and EV-charging planner. Building your own pipeline means handling regional pricing, VAT, and the IMPORT vs EXPORT split. This Actor flattens all of that into a single clean dataset.

### 📊 Data fields

Each record includes: `availableFrom`, `brand`, `description`, `direction`, `displayName`, `dualFuelDiscountIncVat`, `exitFeesExcVat`, `exitFeesIncVat`, `exitFeesType`, `fuel`, `fullName`, `isBusiness`, `isGreen`, `isPrepay`, `isRestricted`, `isTracker`, `isVariable`, `onlineDiscountIncVat`, `paymentMethod`, `productCode`, `region`, `registerType`, `scrapedAt`, `standingChargeExcVat`, `standingChargeIncVat`, `tariffCode`, `term`, `unitRateExcVat`, `unitRateIncVat`. These field names come straight from the actor's dataset schema, so what you see here is what lands in your dataset.

### 🚀 How to use

1. 📝 **Sign up.** [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) (takes 2 minutes).
2. 🌐 **Open the Actor.** Go to the Octopus Energy UK Tariffs Scraper page on the Apify Store.
3. 🎯 **Set input.** Pick a region, brand, or tariff-type flags (or leave blank for everything), set `maxItems`.
4. 🚀 **Run it.** Click **Start** and let the Actor collect your data.
5. 📥 **Download.** Grab your results in the **Dataset** tab as CSV, Excel, JSON, or XML.

> ⏱️ Total time from signup to downloaded dataset: **3-5 minutes.** No coding required.

### 🔗 Recommended Actors

- [**🌍 NOAA Weather Scraper**](https://apify.com/parseforge/noaa-weather-scraper) - Weather data for energy demand modeling
- [**🔌 AFDC EV Stations Scraper**](https://apify.com/parseforge/afdc-ev-stations-scraper) - U.S. EV charging station directory
- [**📊 Indexmundi Scraper**](https://apify.com/parseforge/indexmundi-scraper) - Global economic and commodity indicators
- [**🏠 OurAirports Scraper**](https://apify.com/parseforge/ourairports-scraper) - Global aviation reference data
- [**🌐 Wikipedia Article Scraper**](https://apify.com/parseforge/wikipedia-article-scraper) - Structured encyclopedia content

> 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more reference-data scrapers.

> **⚠️ Disclaimer:** this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Octopus Energy Ltd, Co-op Energy, London Power, or any UK energy regulator. All trademarks mentioned are the property of their respective owners. Only publicly available tariff data is collected.

### 🆘 Need Help?

If you hit a bug, have questions about setup, or need a scraper we haven't built yet, open our [contact form](https://tally.so/r/BzdKgA) or write to parseforge@protonmail.com. We also take on paid custom data projects.

For faster answers, join our [Discord](https://parseforge.co/discord). It's the best place to get support and suggest new actors.

# Actor input Schema

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

How many tariffs to collect per run.

## `tariffCode` (type: `string`):

If set, fetch only this single product (e.g. 'AGILE-24-10-01'). Overrides the filters below.

## `isVariable` (type: `boolean`):

If true, only include variable tariffs (e.g. Agile, Tracker).

## `isGreen` (type: `boolean`):

If true, only include 100% renewable electricity tariffs.

## `isTracker` (type: `boolean`):

If true, only include tracker tariffs (daily price updates).

## `isPrepay` (type: `boolean`):

If true, only include prepayment (pay-as-you-go) tariffs.

## `isBusiness` (type: `boolean`):

If true, only include business (non-domestic) tariffs.

## `region` (type: `string`):

UK Grid Supply Point region code. Leave blank for all 14 regions per product.

## `brand` (type: `string`):

Filter products by brand. Leave blank for all brands.

## `availableAt` (type: `string`):

Return products available at this point in time (ISO 8601, e.g. 2026-05-21T00:00:00Z). Leave blank for currently-available products.

## Actor input object example

```json
{
  "maxItems": 10,
  "isVariable": false,
  "isGreen": false,
  "isTracker": false,
  "isPrepay": false,
  "isBusiness": 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 = {
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/octopus-energy-tariffs-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 = { "maxItems": 10 }

# Run the Actor and wait for it to finish
run = client.actor("parseforge/octopus-energy-tariffs-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "maxItems": 10
}' |
apify call parseforge/octopus-energy-tariffs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=parseforge/octopus-energy-tariffs-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/JC5x1SmMwLe7xelZd/builds/3cDN2McKV9UUWmU1P/openapi.json