# Industrial Production API
> How much each economy's factories, mines and utilities are actually producing, and which way output is turning — the OECD industrial production index as an API, live from the OECD's official statistics, no key. The industrial production index is one of the headline monthly hard-data prints: it measures the real volume of output across industry (mining, manufacturing and utilities, excluding construction), and its year-on-year change is a direct read on whether the real economy is expanding or contracting — it moves markets and feeds straight into GDP nowcasts. Manufacturing, the largest and most cyclical part, is broken out separately. The OECD publishes a seasonally-adjusted production-volume index for each economy; this API turns it into the number people use — the year-on-year and month-on-month growth of industrial output. The board endpoint ranks every economy by its industrial-production growth (industry excluding construction), with manufacturing alongside, so you can see where factories are humming and where they are stalling. The manufacturing endpoint ranks by manufacturing output growth on its own. The country endpoint gives one economy's industrial and manufacturing growth, year-on-year and month-on-month. Each reading carries its own period and discontinued series are excluded, so the board is genuinely current. The industrial-output / hard-data cut — distinct from the leading-indicator and confidence boards (soft, survey-based, forward-looking), the annual IMF database, and the generic data aggregator. Figures are monthly, in percent.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/industrialproduction-api/..."
```

## Pricing
- **Free** (Free) — 805 calls/Mo, 2 req/s
- **Starter** ($11/Mo) — 17,900 calls/Mo, 6 req/s
- **Pro** ($35/Mo) — 90,800 calls/Mo, 16 req/s
- **Business** ($79/Mo) — 503,000 calls/Mo, 40 req/s

## Endpoints

### Board

#### `GET /v1/board` — Economies ranked by industrial-production growth, with manufacturing

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/industrialproduction-api/v1/board"
```

**Response:**
```json
{
    "data": {
        "note": "Economies ranked by year-on-year industrial-production growth (industry excluding construction), with manufacturing alongside. A direct read on whether the real economy is expanding or contracting; feeds straight into GDP nowcasts. Growth computed from the OECD's seasonally-adjusted production-volume index. Each row carries its own period; discontinued series are excluded. Monthly, cached a few hours.",
        "board": [
            {
                "code": "DNK",
                "name": "Denmark",
                "ip_mom": 8.35,
                "ip_yoy": 17.84,
                "period": "2026-03",
                "reading": "output expanding strongly",
                "manufacturing_yoy": 15.56
            },
            {
                "code": "ISR",
                "name": "Israel",
                "ip_mom": 4.82,
                "ip_yoy": 17.68,
                "period": "2026-02",
                "reading": "output expanding strongly",
                "manufacturing_yoy": 17.68
            },
            {
                "code": "GRC",
                "name": "Greece",
                "ip_mom": 1.03,
                "ip_yoy": 8.06,
                "period": "2026-03",
                "reading": "output expanding strongly",
                "manufacturing_yoy": 5.49
            },
            {
                "code": "LVA",
                "name": "Latvia",
                "ip_mom": 0.1,
                "ip_yoy": 7.38,
               
…(truncated, see openapi.json for full schema)
```

### Manufacturing

#### `GET /v1/manufacturing` — Economies ranked by manufacturing output growth

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/industrialproduction-api/v1/manufacturing"
```

**Response:**
```json
{
    "data": {
        "note": "Economies ranked by year-on-year manufacturing output growth — the largest and most cyclical part of industry. Growth computed from the OECD's seasonally-adjusted production-volume index. Monthly, cached a few hours.",
        "board": [
            {
                "code": "ISR",
                "name": "Israel",
                "ip_yoy": 17.68,
                "period": "2026-02",
                "reading": "output expanding strongly",
                "manufacturing_mom": 4.82,
                "manufacturing_yoy": 17.68
            },
            {
                "code": "DNK",
                "name": "Denmark",
                "ip_yoy": 17.84,
                "period": "2026-03",
                "reading": "output expanding strongly",
                "manufacturing_mom": 7.98,
                "manufacturing_yoy": 15.56
            },
            {
                "code": "LTU",
                "name": "Lithuania",
                "ip_yoy": 6.24,
                "period": "2026-04",
                "reading": "output expanding strongly",
                "manufacturing_mom": -1.67,
                "manufacturing_yoy": 6.98
            },
            {
                "code": "IND",
                "name": "India",
                "ip_yoy": 4.92,
                "period": "2026-04",
                "reading": "output expanding strongly",
                "manufacturing_mom": -1.02,
                "manufacturing_yoy": 6.27
            },
  
…(truncated, see openapi.json for full schema)
```

### Country

#### `GET /v1/country` — One economy's industrial and manufacturing production growth

**Parameters:**
- `country` (query, required, string) — ISO-3 code or name Example: `USA`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/industrialproduction-api/v1/country?country=USA"
```

**Response:**
```json
{
    "data": {
        "code": "USA",
        "name": "United States",
        "note": "One economy's industrial-production and manufacturing growth, year-on-year and month-on-month, from the OECD's seasonally-adjusted production-volume index. A positive year-on-year change means output is above its level a year earlier. Monthly, cached a few hours.",
        "period": "2026-04",
        "source": "OECD industrial production (SDMX)",
        "manufacturing": {
            "mom": 0.6,
            "yoy": 1.3,
            "period": "2026-04",
            "reading": "output growing"
        },
        "industrial_production": {
            "mom": 0.68,
            "yoy": 1.35,
            "period": "2026-04",
            "reading": "output growing"
        }
    },
    "meta": {
        "timestamp": "2026-06-12T19:37:33.670Z",
        "request_id": "b7bec13f-dd96-489c-9fac-995b94e24163"
    },
    "status": "ok",
    "message": "Country industrial production retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/industrialproduction-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "board and manufacturing take no required parameters. country takes country (ISO-3 code or name, required). meta takes no parameters. Growth figures are in percent; yoy is year-on-year, mom is month-on-month, computed from the production-volume index. Monthly data; a multi-hour protective cache fronts the OECD upstream.",
        "source": "OECD industrial production (DF_INDSERV) via OECD SDMX API (PRVM index, seasonally adjusted), live, keyless",
        "service": "industrialproduction-api",
        "economies": 47,
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/board": "Economies ranked by industrial-production growth (industry excl. construction), with manufacturing.",
            "GET /v1/country": "One economy's industrial and manufacturing production growth (country=USA).",
            "GET /v1/manufacturing": "Economies ranked by manufacturing output growth."
        },
        "description": "Industrial production — how much each economy's factories, mines and utilities are producing and which way output is turning, live from the OECD (no key). It computes the year-on-year and month-on-month growth of the production-volume index for industry (excluding construction) and manufacturing. board ranks economies by industrial-production growth with manufacturing alongside; manufacturing ranks by manufacturing growth; country gives one economy's figures. A headline monthly hard-data print that feed
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/industrialproduction-api
OpenAPI spec: https://www.oanor.com/api/industrialproduction-api/openapi.json
