Version 1 - Dataset Catalog

Released At: 29 Apr 2015Last Updated At: 02 Nov 2015

Get a list of all datasets.

URL

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

http://data.unicef.ge/[locale]/api/v1/dataset_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 datasets in the site with the following information:

ParameterDescription
id Unique ID of the dataset that you will need to get further information or run an analysis
title The title of the dataset
source The name of the source that gathered the data
start_gathered_at Date the data gathering process started, format: yyyy-mm-dd (e.g., 2015-01-31)
end_gathered_at Date the data gathering process finished, format: yyyy-mm-dd (e.g., 2015-01-31)
released_at Date the data was released to the public by the source, format: yyyy-mm-dd (e.g., 2015-01-31)
public_at Date the data was made public on this site, format: yyyy-mm-dd (e.g., 2015-01-31)

Examples

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

http://data.unicef.ge/en/api/v1/dataset_catalog?access_token=123456789
{
  datasets: [
    {
      id: "1111111111",
      title: "This is a dataset!",
      source: "People",
      start_gathered_at: "2014-04-01",
      end_gathered_at: "2014-06-30",
      released_at: "2015-01-01",
      public_at: "2015-03-01"
    },
    {
      id: "2222222222",
      title: "Wow, another dataset!",
      source: "Studies R Us",
      start_gathered_at: null,
      end_gathered_at: null,
      released_at: null,
      public_at: "2015-04-15"
    }
  ]
}