API Home

Version 3 (categorical & numerical types) - Time Series Catalog

Released At: 25 Jan 2016Last Updated At: 10 Jul 2019

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/v3/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:

Parameter	Description
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:

Parameter	Description
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/v3/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
    }
  ]
}

API Home