Continents and regions

It's easy to filter and group by large geographic regions, such as continents and the Global South.

Continents

Countries are mapped to continents using data from the United Nations Statistics Division. You can see the actual mapping used by the API here.

Filter by continent

There are three ways to use continent filters:
Endpoint
Format
Authors
/authors?filter=last_known_institution.continent:<continent>
Institutions
/institutions?filter=continent:<continent>
Works
/works?filter=institutions.continent:<continent>
Available values for the <continent> filter are:
Continent
Filter Value
Canonical ID
Africa
africa
Q15
Antarctica
antarctica
Q51
Asia
asia
Q48
Europe
europe
Q46
North America
north_america
Q49
Oceania
oceania
Q55643
South America
south_america
Q18

Group by continent

You can group by continent.
Response:
{
key: "Q46",
key_display_name: "Europe",
count: 41382
},
{
key: "Q49",
key_display_name: "North America",
count: 37458
},
{
key: "Q48",
key_display_name: "Asia",
count: 20432
}...
Groups are available in these endpoints:
Endpoint
Format
Authors
/authors?group-by=last_known_institution.continent
Institutions
/institutions?group-by=continent
Works
/works?group-by=institutions.continent

Global South

The Global South is a term used to identify regions within Latin America, Asia, Africa, and Oceania. Our source for this group of countries is the United Nations Finance Center for South-South Cooperation.

Filter by Global South

You can filter Global South countries by using the boolean filter is_global_south in the following endpoints:
Endpoint
Format
Authors
/authors?filter=last_known_institution.is_global_south:<boolean>
Institutions
/institutions?filter=is_global_south:<boolean>
Works
/works?filter=institutions.is_global_south:<boolean>

Group by Global South

You can also group by the Global South:
Endpoint
Format
Authors
/authors?group-by=last_known_institution.is_global_south
Institutions
/institutions?group-by=is_global_south
Works
/works?group-by=institutions.is_global_south

Tips & Tricks

To see country-by-country details for a geographic region, filter by region, then group by country_code.
Response:
// all countries are in the Global South
{
key: "CN",
key_display_name: "China",
count: 13926441
},
{
key: "IN",
key_display_name: "India",
count: 2632721
},
{
key: "BR",
key_display_name: "Brazil",
count: 2089957
}...