OECD Data Scraper

Access economic and social statistics from the OECD (Organisation for Economic Co-operation and Development) via the official SDMX REST API. Covers GDP, employment, trade, inequality, housing, and more for 38+ OECD member countries and partners.

No API key required. Data is publicly available at data-explorer.oecd.org.

---

What Can It Do?

• Browse available datasets — discover all OECD datasets with descriptions and categories
• Fetch time-series data — get indicator values for specific countries and date ranges
• Multi-country queries — pull data for multiple countries in one run
• Diverse indicators — GDP growth, unemployment, trade flows, Gini coefficients, house prices, and more
• Standard SDMX format — uses the official OECD SDMX JSON API

---

Input

Field	Type	Description	Example
mode	select	searchDatasets or getIndicator	searchDatasets
datasetCode	string	OECD dataflow ID (from searchDatasets)	DSD_NAMAIN1@DF_QNA_EXPENDITURE_GROWTH_OECD
countries	array	ISO-3 country codes	["USA", "GBR", "AUS"]
startYear	integer	First year (1990–2030)	2020
endYear	integer	Last year (1990–2030)	2022
maxItems	integer	Records cap (1–1000)	100

---

Available Datasets

Dataset Code	Name	Category
DSD_NAMAIN1@DF_QNA_EXPENDITURE_GROWTH_OECD	Quarterly National Accounts: GDP & Expenditure (OECD)	National Accounts
DSD_NAMAIN1@DF_QNA_EXPENDITURE_GROWTH_NON_OECD	Quarterly National Accounts: GDP & Expenditure (Non-OECD)	National Accounts
DSD_ALFS@DF_SUMTAB	Annual Labour Force Statistics — Summary Tables	Labour
DSD_BATIS@DF_BATIS	Balanced Trade in Services (BaTIS)	Trade
DSD_BIMTS@DF_BIMTS_HS2017_2D	Balanced International Merchandise Trade	Trade
DSD_WISE_IDD@DF_IDD	Income Distribution Database (IDD)	Social
DSD_WEALTH@DF_WEALTH	Wealth Distribution Database	Social
DSD_AN_HOUSE_PRICES@DF_HOUSE_PRICES	Analytical House Price Indicators	Housing
DSD_FUA_CLIM@DF_TEMPERATURES	Air Temperature — Cities and FUAs	Environment

Run searchDatasets mode to get the full list with descriptions.

---

Output

Dataset Record (searchDatasets mode)

Field	Type	Description
datasetCode	string	Unique dataset/dataflow identifier
agencyId	string	OECD agency responsible
name	string	Full dataset name
description	string	What the dataset covers
category	string	Thematic category
frequency	array	Available frequencies (A, Q, M)
version	string	Dataset version
sourceUrl	string	OECD data explorer URL
recordType	string	"dataset"
scrapedAt	string	ISO timestamp

Indicator Record (getIndicator mode)

Field	Type	Description
datasetCode	string	Dataset identifier
agencyId	string	OECD agency
countryCode	string	ISO-3 country code (e.g. "USA")
countryName	string	Country name
indicatorCode	string	Indicator/measure code
indicatorName	string	Indicator description
period	string	Year or quarter (e.g. "2022" or "2022-Q3")
value	float	Numeric value
frequency	string	"A" (annual), "Q" (quarterly), "M" (monthly)
sourceUrl	string	OECD data explorer URL
recordType	string	"indicator"
scrapedAt	string	ISO timestamp

---

Example Use Cases

1. Discover Available Datasets

{
  "mode": "searchDatasets",
  "maxItems": 20
}

2. US Quarterly GDP Growth (2020–2022)

{
  "mode": "getIndicator",
  "datasetCode": "DSD_NAMAIN1@DF_QNA_EXPENDITURE_GROWTH_OECD",
  "countries": ["USA"],
  "startYear": 2020,
  "endYear": 2022,
  "maxItems": 100
}

3. Multi-Country Labour Statistics

{
  "mode": "getIndicator",
  "datasetCode": "DSD_ALFS@DF_SUMTAB",
  "countries": ["USA", "GBR", "AUS", "DEU"],
  "startYear": 2018,
  "endYear": 2022
}

4. Income Inequality (Gini Coefficients)

{
  "mode": "getIndicator",
  "datasetCode": "DSD_WISE_IDD@DF_IDD",
  "countries": ["USA", "FRA", "SWE"],
  "startYear": 2015,
  "endYear": 2022
}

5. House Price Indices

{
  "mode": "getIndicator",
  "datasetCode": "DSD_AN_HOUSE_PRICES@DF_HOUSE_PRICES",
  "countries": ["USA", "GBR", "AUS"],
  "startYear": 2018,
  "endYear": 2023
}

---

Frequently Asked Questions

Do I need an API key? No. The OECD SDMX API is publicly accessible without registration.

How do I find the right dataset code? Run the actor in searchDatasets mode first. Each record contains the datasetCode you can copy into getIndicator mode.

What are ISO-3 country codes? Three-letter codes: USA (United States), GBR (United Kingdom), AUS (Australia), DEU (Germany), FRA (France), JPN (Japan), CAN (Canada), ITA (Italy), KOR (Korea), MEX (Mexico).

Why might I get no results for getIndicator? Some datasets have specific dimension requirements. Try searchDatasets mode to verify the dataset exists and check the description. Some datasets cover only OECD members.

What does "frequency" mean? A = Annual (yearly data), Q = Quarterly (every 3 months), M = Monthly.

How recent is the data? OECD data is typically 6–18 months behind the current date, depending on the dataset and country reporting speed.

---

Data Source

Data comes from the OECD Data Explorer via the OECD SDMX REST API. All data is © OECD and licensed under the OECD Terms and Conditions.