The Data > Categories > Countries and Regions

Regions

Regions are broad geographic groupings, which enable users to explore our documents and organisations by more than one country. These include:

  • Africa
  • East Asia and Pacific
  • Eastern Europe
  • Europe
  • Japan
  • Latin America and Caribbean
  • Middle East and North Africa
  • North America
  • Russia and the Commonwealth of Independent States
  • South Asia

Fields

Field Name Description
cat_level Position in the hierarchy, starting at 1, the top level
level Position in the hierarchy, starting at 1, the top level
metadata_url Web-accessible uri for this object
name Name of region
object_id Unique idenitfier of this region
object_type The type of asset, in this case “region”
parent_object_id Unique idenitfier of the parent of this region
site Name of the collection to which this document belongs
timestamp Indicates when record was indexed in the API Used to determine updates to the index for synchronisation.Timestamp is in ISO 8601 format: YYYY-MM-DD hh:mm:ss
title Name of region
toplevel_object_id Unique idenitfier of the top level of this category
website_url Link to the region page on the site URL, where applicable

List of all Regions

Eldis

http://api.ids.ac.uk/openapi/eldis/get_all/regions/?num_results=20

BRIDGE

http://api.ids.ac.uk/openapi/bridge/get_all/regions/?num_results=20

Countries

Countries of focus are used to identify either:

  • which geographic area the research document covers
  • where the research was produced, based on the publisher country
  • the countries in which an organisation works

Note that we also provide:

  • a location_country to indicate where an organisation is based, and
  • a publisher_country to indicate where the publisher of a document is based.

We use the predefined list of countries and make the ISO codes available for searching.

Fields

Field Name Description
alternative_name Alternative name of country
category_region_array List of regions to which this country belongs
  • archived: “false” or “true” (shows whether region has been archived)
  • metadata_url
  • object_id
  • object_name: Region name
  • object_type: “region”
country_name Name of country
iso_number See http://en.wikipedia.org/wiki/ISO_3166-1 for description and full list of these codes
iso_three_letter_code
iso_two_letter_code
metadata_url Web-accessible uri for this object
name Name of country
object_id Unique idenitfier of this theme
object_type The type of object, in this case “Country”
site Name of the collection to which this theme belongs
timestamp Indicates when record was indexed in the API Used to determine updates to the index for synchronisation.Timestamp is in ISO 8601 format: YYYY-MM-DD hh:mm:ss
title Name of country
website_url Link to the country page on site URL, where applicable

List of all countries

Please note that the list of countries in BRIDGE are the same as those in Eldis. However, the countries are not organised by Region in BRIDGE.

http://api.ids.ac.uk/openapi/eldis/get_all/countries/full?num_results=300

Latest updates

Additional fields in count results
Website URL added to countries and regions
Archiving themes and regions


Leave a Reply

Your email address will not be published. Required fields are marked *

IDS Open API

The IDS Knowledge Services API button

Your feedback

Please let us know if any of our documentation is not clear, or you have an queries, using the comments box at the bottom of each page.