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
  • Search a specific field
  • Autocomplete publishers
Export as PDF
  1. API Entities
  2. Publishers

Search publishers

The best way to search for publishers is to use the search query parameter, which searches the display_name and alternate_titles fields. Example:

  • Search publishers' display_name and alternate_titles for "springer": https://api.openalex.org/publishers?search=springer

You can read more about search here. It will show you how relevance score is calculated, how words are stemmed to improve search results, and how to do complex boolean searches.

Search a specific field

You can also use search as a filter, allowing you to fine-tune the fields you're searching over. To do this, you append .search to the end of the property you are filtering for:

  • Get publishers with "elsevier" in the display_name: https://api.openalex.org/publishers?filter=display_name.search:elsevier

The following field can be searched as a filter within publishers:

Search filter
Field that is searched

You can also use the filter default.search, which works the same as using the search parameter.

Autocomplete publishers

You can autocomplete publishers to create a very fast type-ahead style search function:

  • Autocomplete publishers with "els" in the display_name: https://api.openalex.org/autocomplete/publishers?q=els

This returns a list of publishers:

{ 
  "results": [
    {
        "id": "https://openalex.org/P4310320990",
        "display_name": "Elsevier BV",
        "hint": null,
        "cited_by_count": 407508754,
        "works_count": 20311868,
        "entity_type": "publisher",
        "external_id": "https://www.wikidata.org/entity/Q746413"
    },
    ...
  ]
}

Read more in the autocomplete page in the API guide.

PreviousFilter publishersNextGroup publishers

Last updated 1 year ago

🏢
display_name.search
display_name