Skip to main content

A simple Eurostat Rest API client

Project description

Eurostat API Client (Python)

Use the Eurostat API Client to quickly retrieve json data from Eurostat REST service and convert it to a pandas DataFrame. A simple description of the service can be found here

Installation

Install Eurostat API Client using pip.

pip install eurostatapiclient

Quick start

This example shows how to retrieve a dataset and a pandas dataframe from it.

from eurostatapiclient import EurostatAPIClient

# Choose service version : only 1.0 is currently available
VERSION = '1.0'

# Only json is currently available
FORMAT = 'json'

# Specify language : en, fr, de
LANGUAGE = 'en'

client = EurostatAPIClient(VERSION, FORMAT, LANGUAGE)

# Optionnal : working behing a proxy :
# client.set_proxy({'http':'my.proxy.com/8080', 'https':'my.proxy.com/8080'})

dataset = client.get_dataset('tps00001')
print(dataset.label)

dataframe = dataset.to_dataframe()
print(dataframe.head())

# Add some filters (only mono-filtering is available for now)
params = {
    'geo': 'DE',
}

# Note that some keys may be repeated in eurostat's api
# In that case, you will want to pass params as a list of tuples
# ex. : 
# params = [
#  ('siec', 'TOTAL'),
#  ('precision', '1'),
#  ('unit', 'KTOE'),
#  ('nrg_bal', 'AFC'),
#  ('nrg_bal', 'DL'),
#  ('nrg_bal', 'EXP'),
#  ('nrg_bal', 'FC_E'),
#  ('nrg_bal', 'FEC2020-2030')]
# filtered_dataset = client.get_dataset('nrg_bal_c', params=params)

filtered_dataset = client.get_dataset('tps00001', params=params)
filtered_dataframe = filtered_dataset.to_dataframe()
print(filtered_dataframe.head())

Contributions

Contributions are welcome !

Feel free to suggest modifications/enhancements in the "issues" section, or to create a pull request

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

eurostatapiclient-0.3.0.tar.gz (14.3 kB view details)

Uploaded Source

Built Distribution

eurostatapiclient-0.3.0-py3-none-any.whl (12.4 kB view details)

Uploaded Python 3

File details

Details for the file eurostatapiclient-0.3.0.tar.gz.

File metadata

  • Download URL: eurostatapiclient-0.3.0.tar.gz
  • Upload date:
  • Size: 14.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.8

File hashes

Hashes for eurostatapiclient-0.3.0.tar.gz
Algorithm Hash digest
SHA256 ff0442b9b0a21cb2ca51c7abdb40595569f22ab6a88ff1c863d4bedfd6bfde69
MD5 4c5f299deddffc7f075554b4556807b1
BLAKE2b-256 0db8cf361ac15e16680bac3c4c0728ddbc39917849a6fa52fe4884fcab136967

See more details on using hashes here.

File details

Details for the file eurostatapiclient-0.3.0-py3-none-any.whl.

File metadata

File hashes

Hashes for eurostatapiclient-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b3cae81c6358d735c0ffc6190df02b24645e7631d714ebbd82231ebe108418b7
MD5 0ac527dde37e48f1736b030491a02692
BLAKE2b-256 28e8f449bf5382c5b0e260476e597362672b82200a152da3b0f7c31e23c4f7eb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page