Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Python wrapper for ICANE Statistical Data and Metadata API

Project Description

pyicane is a Python wrapper for the Statistical Office of Cantabria’s (ICANE) metadata restful API. This module parses ICANE’s json data and metadata into Python objects and common data structures such as Pandas dataframes [1]. All ICANE’s API classes and methods are covered; also, time-series data can be downloaded into a Python Pandas dataframe structure.

pyicane is written and maintained by Miguel Expósito Martín and is distributed under the Apache 2.0 License (see LICENSE file).

[1] for Python Data Analysis Library information


pyicane requires pandas and requests packages. For installation:

pip install pyicane


Get a list of categories

Typical usage often looks like this:

from pyicane import pyicane

categories = pyicane.Category.find_all()
print categories

Get Time Series Data in a Dataframe

Conversion to dataframe is a useful feature:

from pyicane import pyicane

time_series = pyicane.TimeSeries.get('census-series-1900-2001')
print time_series.data_as_dataframe()

Get Time Series Metadata in a Dataframe

Let’s check the most relevant metadata:

from pyicane import pyicane

time_series = pyicane.TimeSeries.get('census-series-1900-2001')
print time_series.metadata_as_dataframe()

Get last updated data

Which was the last ICANE’s API data update:

from pyicane import pyicane

print pyicane.Data.get_last_updated()

Release History

This version
History Node


History Node


Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(183.2 kB) Copy SHA256 Hash SHA256
Source None Mar 7, 2015

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting