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 funders
Export as PDF
  1. API Entities
  2. 💰Funders

Search funders

PreviousFilter fundersNextGroup funders

Last updated 1 year ago

The best way to search for funders is to use the search query parameter, which searches the , the , and the description fields. Example:

  • Search funders' display_name, alternate_titles, and description for "health": https://api.openalex.org/funders?search=health

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 funders with "florida" in the display_name: https://api.openalex.org/funders?filter=display_name.search:florida

The following fields can be searched as a filter within funders:

Search filter
Field that is searched

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

Autocomplete funders

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

  • Autocomplete funders with "national sci" in the : https://api.openalex.org/autocomplete/funders?q=national+sci

This returns a list of funders with the funder location set as the hint:

  "results": [
    {
        "id": "https://openalex.org/F4320306076",
        "display_name": "National Science Foundation",
        "hint": null,
        "cited_by_count": 6705777,
        "works_count": 264303,
        "entity_type": "funder",
        "external_id": "https://ror.org/021nxhr62"
    },
    ...
  ]

Read more in the autocomplete page in the API guide.

display_name.search
description.search
display_name
alternate_titles
display_name
display_name
description