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
Release history Release notifications | RSS feed
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)
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 |
ff0442b9b0a21cb2ca51c7abdb40595569f22ab6a88ff1c863d4bedfd6bfde69
|
|
MD5 |
4c5f299deddffc7f075554b4556807b1
|
|
BLAKE2b-256 |
0db8cf361ac15e16680bac3c4c0728ddbc39917849a6fa52fe4884fcab136967
|
File details
Details for the file eurostatapiclient-0.3.0-py3-none-any.whl
.
File metadata
- Download URL: eurostatapiclient-0.3.0-py3-none-any.whl
- Upload date:
- Size: 12.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.8.8
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
b3cae81c6358d735c0ffc6190df02b24645e7631d714ebbd82231ebe108418b7
|
|
MD5 |
0ac527dde37e48f1736b030491a02692
|
|
BLAKE2b-256 |
28e8f449bf5382c5b0e260476e597362672b82200a152da3b0f7c31e23c4f7eb
|