Version 2 (groups & weights) - Time Series Catalog

Released At: 25 Jan 2016Last Updated At: 26 Jan 2016

Get a list of all time series.

URL

To call this method, use an HTTP GET request to the following URL:

http://data.unicef.ge/[locale]/api/v2/time_series_catalog

where:

  • [locale] = the locale of the language you want the data to be returned in (currently ka for Georgian or en for English)

Required Parameters

The following parameters must be included in the request:

ParameterDescription
access_token All requests must include an access_token. You can obtain an access token easily, and for free, by going here.

 

Optional Parameters

There are no optional parameters for this call.

What You Get

The return object is a JSON array of all time series in the site with the following information:

ParameterDescription
id Unique ID of the time series that you will need to get further information or run an analysis
url URL to the dataset
title The title of the time series
dates_included An array of the dates that are included in the time series.The dates may represent a year, month/year, etc - there is no specific format for these values.
public_at Date the data was made public on this site, format: yyyy-mm-dd (e.g., 2015-01-31)
is_weighted Flag indicating if the dataset is weighted

Examples

Here is an example of what can be returned after calling this method with the following url:

http://data.unicef.ge/en/api/v2/time_series_catalog?access_token=123456789
{
  time_series: [
    {
      id: "1111111111",
      url: "http://data.unicef.ge/en/time_series/time_series1",
      title: "This is a time series!",
      dates_included: [
        "2009",
        "2011",
        "2013"
      ],
      public_at: "2015-03-01",
      is_weighted: false
    },
    {
      id: "2222222222",
      url: "http://data.unicef.ge/en/time_series/time_series1",
      title: "Wow, another time series!",
      dates_included: [
        "April 2010",
        "May 2013"
      ],
      public_at: "2015-04-15",
      is_weighted: true
    }
  ]
}