# 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, NaN 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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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. > πŸ•’ **Last updated:** 2026-05-22 Β· **πŸ“Š 29 fields** per record Β· **⚑ Live UK tariffs** Β· **🌍 14 GSP regions (A-P)** Β· **🏷️ 3 brands** 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. --- ### 🎬 Full Demo _🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded tariff dataset._ --- ### βš™οΈ Input
InputTypeDefaultBehavior
maxItemsinteger10Records to return. Free plan caps at 10, paid plan at 1,000,000.
tariffCodestring""Specific product code (e.g. AGILE-24-10-01). Overrides other filters.
isVariablebooleanfalseOnly variable tariffs (Agile, Tracker, etc.).
isGreenbooleanfalseOnly 100% renewable tariffs.
isTrackerbooleanfalseOnly tracker (daily-updated) tariffs.
isPrepaybooleanfalseOnly prepayment tariffs.
isBusinessbooleanfalseOnly business (non-domestic) tariffs.
regionstring""GSP region code (_A through _P). Empty = all 14 regions per product.
brandstring""Brand filter. Empty = all brands.
availableAtstring""ISO 8601 datetime. Empty = currently available products.
**Example: every Agile tariff in London (region C).** ```json { "maxItems": 50, "tariffCode": "AGILE-24-10-01", "region": "_C" } ```` **Example: all green variable tariffs across every region.** ```json { "maxItems": 200, "isGreen": true, "isVariable": true, "brand": "OCTOPUS_ENERGY" } ``` > ⚠️ **Good to Know:** prices are published per kWh in pence. Standing charges are per-day. Both `*IncVat` and `*ExcVat` fields are returned so you can use whichever your downstream calculations expect. The `direction` field separates IMPORT (you pay) from EXPORT (you receive, e.g. solar buyback) tariffs. *** ### πŸ“Š Output Each tariff-per-region record contains **29 fields**. Download the dataset as CSV, Excel, JSON, or XML. #### 🧾 Schema | Field | Type | Example | |---|---|---| | 🏷️ `productCode` | string | `"AGILE-24-10-01"` | | πŸ“› `displayName` | string | `"Agile Octopus"` | | πŸ“„ `fullName` | string | `"Agile Octopus October 2024 v1"` | | ⚑ `fuel` | string | `"electricity"` | | πŸ”’ `registerType` | string | `"standard"` | | πŸ’³ `paymentMethod` | string | `"DIRECT_DEBIT"` | | πŸ”– `tariffCode` | string | `"E-1R-AGILE-24-10-01-C"` | | πŸ—ΊοΈ `region` | string | `"_C"` | | πŸ“Š `standingChargeIncVat` | number | `52.05` | | πŸ“Š `standingChargeExcVat` | number | `49.57` | | ⚑ `unitRateIncVat` | number | `22.41` | | ⚑ `unitRateExcVat` | number | `21.34` | | πŸšͺ `exitFeesIncVat` | number | `0` | | πŸšͺ `exitFeesExcVat` | number | `0` | | 🏷️ `exitFeesType` | string | `"NONE"` | | 🎁 `onlineDiscountIncVat` | number | null | `null` | | 🎁 `dualFuelDiscountIncVat` | number | null | `null` | | πŸ” `direction` | string | `"IMPORT"` | | 🏷️ `brand` | string | `"OCTOPUS_ENERGY"` | | πŸ“ˆ `isVariable` | boolean | `true` | | 🌱 `isGreen` | boolean | `true` | | πŸ“Š `isTracker` | boolean | `false` | | πŸ’³ `isPrepay` | boolean | `false` | | 🏒 `isBusiness` | boolean | `false` | | 🚫 `isRestricted` | boolean | `false` | | πŸ“… `term` | number | null | `null` | | πŸ“… `availableFrom` | ISO 8601 | `"2024-10-01T00:00:00Z"` | | πŸ“ `description` | string | `"Agile Octopus tracks wholesale prices half-hourly..."` | | πŸ•’ `scrapedAt` | ISO 8601 | `"2026-05-22T00:00:00.000Z"` | #### πŸ“¦ Sample records
⚑ Half-hourly: Agile Octopus (London, region C) ```json { "productCode": "AGILE-24-10-01", "displayName": "Agile Octopus", "fullName": "Agile Octopus October 2024 v1", "fuel": "electricity", "registerType": "standard", "paymentMethod": "DIRECT_DEBIT", "tariffCode": "E-1R-AGILE-24-10-01-C", "region": "_C", "standingChargeIncVat": 52.05, "standingChargeExcVat": 49.57, "unitRateIncVat": 22.41, "unitRateExcVat": 21.34, "exitFeesIncVat": 0, "exitFeesExcVat": 0, "exitFeesType": "NONE", "onlineDiscountIncVat": null, "dualFuelDiscountIncVat": null, "direction": "IMPORT", "brand": "OCTOPUS_ENERGY", "isVariable": true, "isGreen": true, "isTracker": false, "isPrepay": false, "isBusiness": false, "isRestricted": false, "term": null, "availableFrom": "2024-10-01T00:00:00Z", "description": "Agile Octopus tracks wholesale prices half-hourly, with prices updated daily at 4pm.", "scrapedAt": "2026-05-22T00:00:00.000Z" } ```
🌞 Solar export: Outgoing Octopus ```json { "productCode": "OUTGOING-FIX-12M-24-04-01", "displayName": "Outgoing Octopus", "fullName": "Outgoing Octopus Fixed 12M April 2024", "fuel": "electricity", "registerType": "standard", "paymentMethod": "DIRECT_DEBIT", "tariffCode": "E-1R-OUTGOING-FIX-12M-24-04-01-A", "region": "_A", "standingChargeIncVat": 0, "standingChargeExcVat": 0, "unitRateIncVat": 15.0, "unitRateExcVat": 14.29, "exitFeesIncVat": 0, "exitFeesExcVat": 0, "exitFeesType": "NONE", "onlineDiscountIncVat": null, "dualFuelDiscountIncVat": null, "direction": "EXPORT", "brand": "OCTOPUS_ENERGY", "isVariable": false, "isGreen": true, "isTracker": false, "isPrepay": false, "isBusiness": false, "isRestricted": false, "term": 12, "availableFrom": "2024-04-01T00:00:00Z", "description": "Get paid for the electricity you export to the grid at a flat rate.", "scrapedAt": "2026-05-22T00:00:00.000Z" } ```
🌱 Daily tracker: Octopus Tracker (Yorkshire, region M) ```json { "productCode": "SILVER-FLEX-22-11-25", "displayName": "Octopus Tracker", "fullName": "Octopus Tracker November 2022 v1", "fuel": "electricity", "registerType": "standard", "paymentMethod": "DIRECT_DEBIT", "tariffCode": "E-1R-SILVER-FLEX-22-11-25-M", "region": "_M", "standingChargeIncVat": 48.99, "standingChargeExcVat": 46.66, "unitRateIncVat": 17.83, "unitRateExcVat": 16.98, "exitFeesIncVat": 0, "exitFeesExcVat": 0, "exitFeesType": "NONE", "onlineDiscountIncVat": null, "dualFuelDiscountIncVat": null, "direction": "IMPORT", "brand": "OCTOPUS_ENERGY", "isVariable": true, "isGreen": true, "isTracker": true, "isPrepay": false, "isBusiness": false, "isRestricted": false, "term": null, "availableFrom": "2022-11-25T00:00:00Z", "description": "Tracker prices follow the wholesale market with a fresh price each day.", "scrapedAt": "2026-05-22T00:00:00.000Z" } ```
*** ### ✨ Why choose this Actor | | Capability | |---|---| | ⚑ | **Live UK tariff catalog.** Every published Octopus product, fresh on every run. | | πŸ—ΊοΈ | **All 14 GSP regions.** A through P, covering every postcode in Great Britain. | | 🌱 | **Green flag included.** Filter for 100% renewable electricity products in one click. | | πŸ“Š | **Both VAT views.** `*IncVat` and `*ExcVat` columns so you never recalculate. | | πŸ” | **IMPORT and EXPORT.** Buy and sell tariffs in one dataset, ready for solar/battery models. | | ⚑ | **Fast.** 10 tariffs in under 5 seconds, the full catalog in under a minute. | | 🚫 | **No authentication.** Works with the public Octopus catalog. No login needed. | > πŸ“Š Live tariff data is the foundation of every UK switching engine, smart-home optimizer, and EV-charging planner. *** ### πŸ“ˆ How it compares to alternatives | Approach | Cost | Coverage | Refresh | Filters | Setup | |---|---|---|---|---|---| | **⭐ Octopus Energy UK Tariffs Scraper** *(this Actor)* | $5 free credit, then pay-per-use | **All UK Octopus products** | **Live per run** | brand, region, type flags, code, date | ⚑ 2 min | | Commercial switching-engine feeds | Β£500+/month | Multi-supplier, fee-gated | Vendor-controlled | Limited | 🐒 Days | | Manual portal scraping | Free | Single product at a time | Manual | None | 🐌 Hours of clicking | | Building your own integration | Free | Full | Live | Build your own | πŸ•’ Days of engineering | Pick this Actor when you want the live Octopus catalog flattened into a clean dataset with zero parser maintenance. *** ### πŸš€ 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. *** ### πŸ’Ό Business use cases
#### πŸ”Œ Switching & Comparison Engines - Live unit-rate and standing-charge feeds - Per-region pricing for postcode lookups - Green-only filters for sustainability-focused users - Annual-cost calculators using both IMPORT direction #### 🏠 Smart-Home & EV Optimization - Half-hourly Agile pricing for battery dispatch - EV-charging cost models with overnight rates - Heat-pump scheduling against live unit rates - Smart-meter consumption + tariff joins
#### 🌞 Solar & Battery Installers - EXPORT tariff data for solar buyback ROI calculators - Customer-facing payback dashboards - Battery storage economic modeling - Tariff-switch recommendations after install #### 🏒 Business Energy & Procurement - Non-domestic tariff sourcing for SMEs - Tracker vs fixed risk analyses - Procurement reports for energy buyers - Sustainability reporting on green tariff uptake
*** ### πŸ”Œ Automating Octopus Energy UK Tariffs Scraper Control the scraper programmatically for scheduled runs and pipeline integrations: - 🟒 **Node.js.** Install the `apify-client` NPM package. - 🐍 **Python.** Use the `apify-client` PyPI package. - πŸ“š See the [Apify API documentation](https://docs.apify.com/api/v2) for full details. The [Apify Schedules feature](https://docs.apify.com/platform/schedules) lets you trigger this Actor on any cron interval. A daily schedule is ideal for tracker tariffs, which refresh once per day at 4pm UK time. *** ### 🌟 Beyond business use cases Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.
#### πŸŽ“ Research and academia - UK energy-market dissertations and academic papers - Wholesale-price pass-through studies - Reproducible studies with cited tariff snapshots - Climate-policy and net-zero transition research #### 🎨 Personal and creative - Personal smart-home dashboards - Side-project switching tools and calculators - Energy-bill blog posts and YouTube reviews - Hobby projects for solar enthusiasts
#### 🀝 Non-profit and civic - Fuel-poverty research and outreach - Consumer-advocacy switching guides - Open data publication for UK transparency - Local-authority sustainability planning #### πŸ§ͺ Experimentation - Train price-forecast or arbitrage ML models - Validate switching-tool product hypotheses - Prototype LLM agents that recommend tariffs - Test dashboard concepts with live tariff data
*** ### πŸ€– Ask an AI assistant about this scraper Open a ready-to-send prompt about this ParseForge actor in the AI of your choice: - πŸ’¬ [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20Octopus%20Energy%20UK%20Tariffs%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - 🧠 [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20Octopus%20Energy%20UK%20Tariffs%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - πŸ” [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20Octopus%20Energy%20UK%20Tariffs%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - πŸ…’ [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20Octopus%20Energy%20UK%20Tariffs%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) *** ### ❓ Frequently Asked Questions #### 🧩 How does it work? Pick a region, brand, or tariff-type flag in the input form, click Start, and the Actor fetches the live Octopus product catalog and emits a clean structured record per tariff per region. No browser automation, no captchas, no setup. #### πŸ“ How fresh is the pricing? Every run pulls the current catalog. Tracker tariffs refresh once per day at 4pm UK time. Agile tariffs publish half-hourly rates daily at 4pm for the following day. #### πŸ—ΊοΈ What are GSP regions? Grid Supply Point regions are the 14 zones (A through P, skipping I and O) that the UK National Grid uses to allocate transmission and distribution costs. Each postcode belongs to one region, and unit rates differ slightly across regions. #### πŸ” What is the difference between IMPORT and EXPORT tariffs? IMPORT tariffs are what you pay when consuming grid electricity. EXPORT tariffs are what Octopus pays you for energy you push back to the grid (e.g. from solar panels or a home battery). The `direction` field tells you which is which. #### 🌱 Are all Octopus tariffs green? Most Octopus Energy electricity tariffs are 100% renewable. The `isGreen` flag is set per product so you can filter explicitly. #### ⏰ Can I schedule regular runs? Yes. A daily Apify Schedule (just after 4pm UK time) captures the freshest Agile and Tracker prices. #### βš–οΈ Is this data legal to use? Octopus publishes its full tariff catalog as public reference data for switching engines and customer transparency. Review the downstream terms of your specific use case, but published tariff pricing is generally considered public. #### πŸ’Ό Can I use this data commercially? Yes. Switching platforms, comparison engines, and smart-home tools commonly use published UK tariff data. You are responsible for complying with any regulatory requirements (Ofgem rules, consumer protection) in your own product. #### πŸ’³ Do I need a paid Apify plan to use this Actor? No. The free Apify plan is enough for testing and small runs (10 records per run). A paid plan lifts the limit and gives you access to scheduling, higher concurrency, and larger datasets. #### πŸ” What happens if a run fails or gets interrupted? Apify automatically retries transient errors. If a run still fails, you can inspect the log in the Runs tab, fix the input, and re-run. Partial datasets from failed runs are preserved so you never lose progress. #### πŸ†˜ What if I need help? Our support team is here to help. Contact us through the Apify platform or use the Tally form linked below. *** ### πŸ”Œ Integrate with any app Octopus Energy UK Tariffs Scraper connects to any cloud service via [Apify integrations](https://apify.com/integrations): - [**Make**](https://docs.apify.com/platform/integrations/make) - Automate multi-step workflows - [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Connect with 5,000+ apps - [**Slack**](https://docs.apify.com/platform/integrations/slack) - Get run notifications in your channels - [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe tariff data into your warehouse - [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits and releases - [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export datasets straight to Sheets You can also use webhooks to trigger downstream actions when a run finishes. Push fresh tariff data into your switching backend, or alert your team in Slack when a new product launches. *** ### πŸ”— 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. *** **πŸ†˜ Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) to request a new scraper, propose a custom data project, or report an issue. *** > **⚠️ 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. # Actor input Schema ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## `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 '' with your token const client = new ApifyClient({ 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 '' with your token. client = ApifyClient("") # 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 " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Octopus Energy UK Tariffs Scraper", "description": "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.", "version": "1.0", "x-build-id": "MeetRFLNstycgHNqx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~octopus-energy-tariffs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-octopus-energy-tariffs-scraper", "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/parseforge~octopus-energy-tariffs-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-octopus-energy-tariffs-scraper", "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/parseforge~octopus-energy-tariffs-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-octopus-energy-tariffs-scraper", "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": { "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "tariffCode": { "title": "Specific Tariff Code", "type": "string", "description": "If set, fetch only this single product (e.g. 'AGILE-24-10-01'). Overrides the filters below." }, "isVariable": { "title": "Variable Tariffs Only", "type": "boolean", "description": "If true, only include variable tariffs (e.g. Agile, Tracker).", "default": false }, "isGreen": { "title": "Green Tariffs Only", "type": "boolean", "description": "If true, only include 100% renewable electricity tariffs.", "default": false }, "isTracker": { "title": "Tracker Tariffs Only", "type": "boolean", "description": "If true, only include tracker tariffs (daily price updates).", "default": false }, "isPrepay": { "title": "Prepay Tariffs Only", "type": "boolean", "description": "If true, only include prepayment (pay-as-you-go) tariffs.", "default": false }, "isBusiness": { "title": "Business Tariffs Only", "type": "boolean", "description": "If true, only include business (non-domestic) tariffs.", "default": false }, "region": { "title": "GSP Region", "enum": [ "", "_A", "_B", "_C", "_D", "_E", "_F", "_G", "_H", "_J", "_K", "_L", "_M", "_N", "_P" ], "type": "string", "description": "UK Grid Supply Point region code. Leave blank for all 14 regions per product." }, "brand": { "title": "Brand", "enum": [ "", "OCTOPUS_ENERGY", "COOP_ENERGY", "LONDON_POWER" ], "type": "string", "description": "Filter products by brand. Leave blank for all brands." }, "availableAt": { "title": "Available At (ISO date)", "type": "string", "description": "Return products available at this point in time (ISO 8601, e.g. 2026-05-21T00:00:00Z). Leave blank for currently-available products." } } }, "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 } } }, "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 } } } } } } } } } } ```