Canary Islands Electricity Scraper (ISTAC Daily Consumption)

Official daily electricity consumption for every Canary Island and municipality, straight from ISTAC (the Canary Islands Statistics Institute). One dataset item per territory, day and economic flow.

What it does

The Actor downloads the public ISTAC dataset ISTAC/C00022A_000005 - "Consumo final de energia electrica segun grandes sectores. Municipios de Canarias por dias" - as CSV over plain HTTP and streams it once per run. It keeps the rows that match your filters and pushes one dataset item per observation:

• Territory: islands and aggregates (ES70, ES708, ...) plus 88 municipalities with their 5-digit INE code.
• Date: one observation per day.
• Economic flow: Total, Residencial, Servicios and Industria.
• Value: the published consumption figure; the unit is read from the dataset metadata (MWH - megawatt-hour - in the current version) and is null if the source ever stops declaring one.

No login, no API key, no paywall, no CAPTCHA and no browser. The CSV is downloaded exactly once per run and reading stops as soon as maxRows matching rows are found.

Coverage measured on 21 October 2026

Measure	Value
CSV size	82,109,984 bytes
Data rows	771,072 (plus 1 header row)
Territories	96 (88 municipalities + islands and aggregates)
Dates	2020-01-01 to 2025-06-30
Economic flows	4 (_T, RESIDENCIAL, SERVICIOS, INDUSTRIA)
Rows with an empty OBS_VALUE	0
Source last modified	2025-09-04

The specification written before this build counted 771,073 rows. The file has 771,072 data rows and one header row, so the difference is the header. The Actor publishes what it reads; the delta is recorded in docs/measurements.md and is not corrected by hand.

Example output

The source labels are Spanish; the JSON below uses \u escapes so this README stays ASCII. The actual dataset item contains the decoded text.

{
    "measure": "Energ\u00eda el\u00e9ctrica",
    "measureCode": "ENERGIA_ELECTRICA",
    "territory": "Lanzarote",
    "territoryCode": "ES708",
    "date": "2020-07-14",
    "flow": "Total",
    "flowCode": "_T",
    "value": 1759.37,
    "unit": "MWH",
    "notes": null,
    "confidentiality": null,
    "status": null,
    "dataset": "ISTAC/C00022A_000005",
    "sourceUrl": "https://datos.canarias.es/api/estadisticas/statistical-resources/v1.0/datasets/ISTAC/C00022A_000005/1.11.csv",
    "url": "https://datos.canarias.es/api/estadisticas/statistical-resources/v1.0/datasets/ISTAC/C00022A_000005/1.11.csv",
    "scrapedAt": "2026-10-21T15:24:00.000Z"
}

url is the common Steadfetch envelope field and carries the same value as sourceUrl. Every item is validated against .actor/dataset_schema.json before it reaches the dataset; with strictSchema: true (default) the run fails instead of pushing a malformed item.

Input

{
    "territories": ["ES708"],
    "dateFrom": "2025-01-01",
    "dateTo": "2025-06-30",
    "flows": ["Total"],
    "maxRows": 100,
    "delayMs": 1000
}

• territories: TERRITORIO_CODE values. Empty means all 96.
• dateFrom / dateTo: ISO dates (YYYY-MM-DD), inclusive. Empty means no bound.
• flows: Total, Residencial, Servicios, Industria. Empty means all four.
• maxRows: 1 to 100000, default 100.
• delayMs: politeness delay before the single download, at least 1000 ms. Concurrency is always 1.

Pricing

Event	Charged when	Price
apify-actor-start	a run starts (synthetic, automatic)	0.00005 USD per run
apify-default-dataset-item	a result is saved to the dataset (synthetic, automatic)	0.001 USD per result = 1.00 USD per 1,000 results

There is no custom per-item event and no Actor.charge() call, so a result is never billed twice. The price sits between the INE-style reference (sefran1/ine-spain-statistics, 0.50 USD per 1,000) and the only energy comparable on the Store (promptica/eprel-etichette-energetiche, 3.00 USD per 1,000); no Store Actor packages Canary municipal electricity consumption.

Measured cost: estimated at or below 0.05 USD per 1,000 results - one plain CSV download (about 82 MB) and one small metadata request per run, no browser, no API key, single concurrency. Platform compute cost will be confirmed with a minimal Store run after publication; the estimate is not presented as a measured platform bill.

FAQ

Does the Actor need a login or paid subscription? No. The ISTAC dataset is public and the Actor only reads it over HTTP.

Which unit are the values in? The metadata declares MWH (megawatt-hour) with unit multiplier 0. The Actor reads the unit from the metadata on every run and returns null if the source stops declaring one. It never guesses or converts.

Does it scrape personal data? No. Every row is an aggregate for a territory and a day; there are no people, accounts, emails or phone numbers in the dataset.

How fresh is the data? The Actor returns what ISTAC publishes. The current dataset version ends on 2025-06-30 and was last modified on 2025-09-04. The README reports the measured coverage instead of promising a delay the source does not meet.

How many downloads does one run make? Exactly one CSV download plus one metadata request. Reading stops at maxRows.

Is the output schema stable? Yes. New fields are added additively and required fields never change; url and scrapedAt are always present.

Data licence and attribution

Source: Instituto Canario de Estadistica (ISTAC), Gobierno de Canarias - dataset ISTAC/C00022A_000005. Published under Creative Commons Attribution 4.0 (CC-BY 4.0). This Actor attributes ISTAC and the dataset in this README and in docs/legal-gate.md, as the licence requires.

Maintenance

This Actor is tested daily: automated runs keep the source reachable and the output schema valid. A failing run becomes an issue in the Steadfetch repository.

Honest demand note

As of 21 October 2026, Apify Store demand for this niche is near zero: no Store Actor packages Canary municipal electricity consumption, and the first paying buyer is still being tested. The Actor stays private until that test is positive; the build is justified by the data gap and a Board request, not by proven sales.