OpenAlex technical documentation
  • Overview
  • Quickstart tutorial
  • API Entities
    • Entities overview
    • 📄Works
      • Work object
        • Authorship object
        • Location object
      • Get a single work
      • Get lists of works
      • Filter works
      • Search works
      • Group works
      • Get N-grams
    • 👩Authors
      • Author object
      • Get a single author
      • Get lists of authors
      • Filter authors
      • Search authors
      • Group authors
      • Limitations
      • Author disambiguation
    • 📚Sources
      • Source object
      • Get a single source
      • Get lists of sources
      • Filter sources
      • Search sources
      • Group sources
    • 🏫Institutions
      • Institution object
      • Get a single institution
      • Get lists of institutions
      • Filter institutions
      • Search institutions
      • Group institutions
    • 💡Topics
      • Topic object
      • Get a single topic
      • Get lists of topics
      • Filter topics
      • Search topics
      • Group topics
    • 🗝️Keywords
    • 🏢Publishers
      • Publisher object
      • Get a single publisher
      • Get lists of publishers
      • Filter publishers
      • Search publishers
      • Group publishers
    • 💰Funders
      • Funder object
      • Get a single funder
      • Get lists of funders
      • Filter funders
      • Search funders
      • Group funders
    • 🌎Geo
      • Continents
      • Regions
    • Concepts
      • Concept object
      • Get a single concept
      • Get lists of concepts
      • Filter concepts
      • Search concepts
      • Group concepts
    • Aboutness endpoint (/text)
  • How to use the API
    • API Overview
    • Get single entities
      • Random result
      • Select fields
    • Get lists of entities
      • Paging
      • Filter entity lists
      • Search entities
      • Sort entity lists
      • Select fields
      • Sample entity lists
      • Autocomplete entities
    • Get groups of entities
    • Rate limits and authentication
  • Download all data
    • OpenAlex snapshot
    • Snapshot data format
    • Download to your machine
    • Upload to your database
      • Load to a data warehouse
      • Load to a relational database
        • Postgres schema diagram
  • Additional Help
    • Tutorials
    • Report bugs
    • FAQ
Powered by GitBook
On this page
Export as PDF
  1. API Entities
  2. Geo

Continents

PreviousGeoNextRegions

Last updated 10 months ago

Countries are mapped to continents using data from the . You can see the actual mapping used by the API .

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

Antarctica

antarctica

Asia

asia

Europe

europe

North America

north_america

Oceania

oceania

South America

south_america

Group by continent

You can group by continent.

  • Group institutions 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

🌎
United Nations Statistics Division
here
https://api.openalex.org/institutions?group-by=continent
Q15
Q51
Q48
Q46
Q49
Q55643
Q18