Sign up
All data sources

Eurostat

No autheurostat

Eurostat is the European Union's official statistics agency. This connector queries its public JSON-stat dissemination API (no auth) for energy data: complete energy balances (nrg_bal_c — production, imports, exports, gross inland consumption by fuel and country), gas and electricity consumer prices (nrg_pc_203 / nrg_pc_204, by consumption band and tax component), and a generic getDataset passthrough for any Eurostat dataset with arbitrary dimension filters. Results are flattened from JSON-stat into tabular rows (geo, time, other dimensions, value) with a dimension legend. Complements EIA and ENTSO-E with pan-EU coverage. Toggle on and use — no setup needed.

Get this contract as JSONConnect this source →

Provenance

PublisherEurostat
API basehttps://ec.europa.eu/eurostat/api/dissemination/statistics/1.0

Freshness & coverage

FreshnessFreshness not declared
GeographicNot declared
TemporalNot declared
AuthenticationNo credentials required

Methods (5)

  • getEnergyBalance

    read

    EU energy balances (nrg_bal_c): production, imports, exports, consumption by fuel/country.

    Input schema
    {
  "type": "object",
  "properties": {
    "geo": {
      "type": "array",
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "time": {
      "type": "integer",
      "examples": [
        2022
      ],
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "array",
          "items": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "number"
              }
            ]
          }
        }
      ]
    },
    "nrgBal": {
      "type": "string",
      "examples": [
        "GIC"
      ],
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "siec": {
      "type": "string",
      "examples": [
        "TOTAL"
      ],
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "unit": {
      "type": "string",
      "examples": [
        "KTOE"
      ],
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "lastTimePeriod": {
      "type": "number"
    },
    "lang": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

    Filter geo, time, nrgBal (e.g. GIC), siec (fuel), unit. Arrays allowed.

  • getGasPrices

    read

    EU gas prices for non-household consumers (nrg_pc_203) by band, tax component, and currency.

    Input schema
    {
  "type": "object",
  "properties": {
    "geo": {
      "type": "string",
      "examples": [
        "DE"
      ],
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "time": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "array",
          "items": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "number"
              }
            ]
          }
        }
      ]
    },
    "nrgCons": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "unit": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "tax": {
      "type": "string",
      "examples": [
        "I_TAX"
      ],
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "currency": {
      "type": "string",
      "examples": [
        "EUR"
      ],
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "lastTimePeriod": {
      "type": "number",
      "examples": [
        1
      ]
    },
    "lang": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

    Filter geo, time, nrgCons (band), tax, currency. lastTimePeriod=N for latest.

  • getElectricityPrices

    read

    EU electricity prices for household consumers (nrg_pc_204) by band, tax component, and currency.

    Input schema
    {
  "type": "object",
  "properties": {
    "geo": {
      "type": "array",
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "time": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "array",
          "items": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "number"
              }
            ]
          }
        }
      ]
    },
    "nrgCons": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "unit": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "tax": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "currency": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "lastTimePeriod": {
      "type": "number",
      "examples": [
        2
      ]
    },
    "lang": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

    Same filters as getGasPrices. tax: X_TAX | X_VAT | I_TAX.

  • getDataset

    read

    Generic passthrough: any Eurostat dataset id + arbitrary dimension filters, flattened to rows.

    Input schema
    {
  "type": "object",
  "properties": {
    "dataset": {
      "type": "string",
      "examples": [
        "nrg_ti_gas"
      ]
    },
    "filters": {
      "type": "object",
      "properties": {},
      "additionalProperties": true
    },
    "lang": {
      "type": "string"
    }
  },
  "additionalProperties": false,
  "required": [
    "dataset"
  ]
}

    filters values may be arrays (multi-value). 413 = narrow your filters.

  • getServiceInfo

    read

    Describe the JSON-stat format, filters, error shapes, and datasets, with a live probe.

    Input schema
    {
  "type": "object",
  "properties": {},
  "additionalProperties": false
}