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. Authors

Group authors

You can group authors with the group_by parameter:

  • Get counts of authors by the last known institution continent: https://api.openalex.org/authors?group_by=last_known_institution.continent``

Or you can group using one the attributes below.

It's best to read about group by before trying these out. It will show you how results are formatted, the number of results returned, and how to sort results.

/authors group_by attributes

  • affiliations.institution.country_code

  • affiliations.institution.id

  • affiliations.institution.lineage

  • affiliations.institution.ror

  • affiliations.institution.type

  • cited_by_count

  • has_orcid

  • last_known_institution.continent

  • last_known_institution.country_code

  • last_known_institution.id

  • last_known_institution.is_global_south

  • last_known_institution.lineage

  • last_known_institution.ror

  • last_known_institution.type

  • summary_stats.2yr_mean_citedness

  • summary_stats.h_index

  • summary_stats.i10_index

  • works_count

PreviousSearch authorsNextLimitations

Last updated 1 year ago

👩