INE Spain Statistics Scraper

INE Spain Statistics Scraper

Scrape official INE Spain statistics: operations, tables, datasets, and time series. Get clean, structured data from the Spanish National Statistics Institute without writing API calls. Export to CSV, JSON, Excel, or XML.

The Spanish National Statistics Institute (INE) publishes official economic and demographic data, but its API and web interface are hard to navigate and return nested JSON. This Actor reads the public INE catalogue directly and returns operations, tables, datasets, and individual time series as flat rows. No API key or registration is needed.

Who uses it	What they scrape INE Spain for
Economists and analysts	Pull official Spanish economic indicators like IPC or GDP into their models
Data journalists	Get clean INE datasets for charts and stories without manual downloads
Market researchers	Track demographic and social statistics for Spain over time
Academic researchers	Collect consistent time series for papers and theses
Business intelligence teams	Monitor Spanish economic trends for planning and forecasting

What it does

This Actor collects INE Spain statistical operations, tables, datasets, and time series, and returns each record as a flat row with labels in English or Spanish.

• 📋 Operations mode: list all INE Spain statistical operations with their codes and names.
• 📊 Tables mode: list every table available for one operation code, like IPC or EPA.
• 📈 Dataset mode: fetch observation values for a table ID, limited to the latest N periods.
• 📉 Series mode: pull a single time series by its SERIE code, such as IPC206449.
• 🌐 Bilingual labels: get all labels in English or Spanish with one setting.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

What you can do with INE Spain data

📈 Track Spanish inflation.

An economist runs the Actor in dataset mode with the IPC table ID and latestN set to 12 to get the last year of monthly inflation data for a report.

📊 Build a demographic dashboard.

A data analyst collects population tables from INE operations and feeds the flat rows into a BI tool to visualize regional trends.

📉 Monitor unemployment.

A market researcher pulls the EPA time series by series code to track quarterly unemployment rates and compare them with forecasts.

🗂️ Catalogue all INE operations.

A developer runs the Actor in operations mode to get a complete list of statistical operations and their codes for building an internal data dictionary.

🌐 Compare Spanish regions.

A journalist scrapes a dataset with regional breakdowns and exports it to CSV to create a story on economic differences across Spain.

Why choose this scraper

	What you get
Official source	Data comes directly from the Spanish National Statistics Institute, not third parties.
Flat output	Nested INE JSON is flattened into one row per record, ready for analysis.
No API key	No registration or authentication is required to start scraping.
Flexible modes	Choose operations, tables, datasets, or single series with one input.
Bilingual	Labels in English or Spanish, so you can work in your preferred language.

How it compares

No other Store actor targets INE Spain the same way, so the honest comparison is with the alternatives teams actually weigh.

	INE Spain Statistics Scraper	Build it in-house	By hand
Setup	Run it now, zero config	Days of engineering	None, but hours per pull
When INE Spain changes	Maintained for you	You fix it	You re-learn the page
Proxies, retries, anti-bot	Built in	Your problem	Browser only
Output	Fixed JSON schema, CSV/Excel export	Whatever you build	Copy-paste
Cost	Pay per result	Engineering time	Analyst hours

Configure the run

Drive the Actor with an operation code, table ID, or series code depending on the mode, and limit dataset results to the most recent periods. The Input tab lists every parameter.

A first run with the defaults:

{
 "mode": "operations",
 "language": "EN",
 "latestN": 12,
 "maxItems": 10
}

A larger pull:

{
 "mode": "operations",
 "language": "EN",
 "latestN": 12,
 "maxItems": 200
}

Pricing

Pay-per-result: $0.0365 per result collected. You pay only for the results written to your dataset.

Results collected	Approximate cost
100 results	$3.65
1,000 results	$36.50
10,000 results	$365.00

New Apify accounts start with $5 in free credit.

Free users

Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.

Run it

1. Create a free Apify account with $5 in credit.
2. Open the INE Spain Statistics Scraper.
3. Set your inputs and any filters, then click Start.
4. Export the results as CSV, Excel, JSON, or XML from the Dataset tab.

Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.

Use with AI agents (MCP)

Give an AI agent live access to INE Spain through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/ine-spain-scraper"

Then prompt it in plain language to run the scraper and read back the results.

Troubleshooting

Why am I getting no results?

Check that the operation code, table ID, or series code is correct. Run operations mode first to verify codes. Also ensure the mode matches the input you provided.

Why is the dataset empty?

The table ID may not have data for the selected language or period. Try a different table ID or set latestN to a larger number.

Why are labels in English when I wanted Spanish?

Set the language input to ES. The default is EN. If labels are still in English, the INE API may not have Spanish translations for that item.

Why did the run time out?

Large datasets can take time. Reduce maxItems or latestN to limit the amount of data. You can also increase the Actor's timeout in the run settings.

Why do I get an error for an invalid code?

INE codes are case-sensitive and must match exactly. Copy the code from the operations or tables list, not from memory.

FAQ

Question	Answer
What is INE Spain?	INE (Instituto Nacional de Estadística) is the official statistical office of Spain. It publishes data on economy, demography, society, and more.
Do I need an API key?	No. This Actor reads the public INE catalogue directly, so no registration or authentication is required.
What can I scrape with this Actor?	You can scrape statistical operations, tables for an operation, dataset values for a table, or a single time series by its series code.
How do I find an operation code?	Run the Actor in operations mode first. It returns all operation codes and names, so you can pick the one you need.
How do I find a table ID?	Use tables mode with an operation code. It lists all tables for that operation, including their IDs.
How do I find a series code?	Series codes are available in the INE web interface or API documentation. You can also get them from dataset results.
Can I get data in Spanish?	Yes. Set the language input to ES to get all labels in Spanish. The default is English.
What is the latestN input?	In dataset mode, latestN limits the result to the most recent N periods. For example, set it to 12 to get the last 12 months.
What output formats are supported?	The Actor returns data in JSON, and you can export it to CSV, Excel, XML, or other formats from the Apify platform.
Is the data official?	Yes. The Actor scrapes directly from the official INE Spain website, so the data is the same as what INE publishes.
Can I scrape multiple datasets in one run?	Yes. Use the maxItems input to control how many datasets are collected per run, up to 1,000,000.
Does this Actor handle pagination?	Yes. It automatically handles pagination for operations, tables, and datasets, so you get complete results.

Related actors

Browse the full ParseForge collection for more scrapers.

🆘 Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Instituto Nacional de Estadística. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.