GraphQL

GraphQL is a query language for APIs. You can use it to request the exact data you need and nothing more. This limits the number of requests you need, making GraphQL more efficient and flexible to use.

GraphQL APIs are strongly typed, and the type system determines what data can be queried. You can use queries to request data and mutations to modify data.

To learn more about GraphQL, we recommend reading Introduction to GraphQL

Authentication

To communicate with the API authentication is required. The Charity Navigator Data API uses API keys for request authentication. You can access and manage your API keys below.

Authentication to the API is performed by setting the Stellate-Api-Tokenheader to API key token for every request.

The Charity Navigator Data API endpoint is located at https://data.charitynavigator.org

API playground

Readme

query PublicSearchFaceted($term: String!) {
    publicSearchFaceted(term: $term) {
      size
      from
      term
      result_count
      results {
        ein
        name
        mission
        organization_url
        charity_navigator_url
        encompass_score
        encompass_star_rating
        encompass_publication_date
        cause
        street
        street2
        city
        state
        zip
        country
        highest_level_advisory
        encompass_rating_id
      }
    }
  }

Note that for this example you will need to pass {term: "<your-search-term>"} as an argument as well as the API key in as a header