Charity Navigator
Charity Data API

publicSearchFaceted

queryData Essentials

Return an array of nonprofits summary and rating data based on search and/or filter criteria. You can iterate over the dataset by supplying a value to the from parameter. See example here

Arguments

term·String!= ""

Search term to conduct a search based on the nonprofit's name or exact EIN match

ein·[String!]!= []

Array of EINs

states·[String!]!= []

Array of 2 character state codes: ["CA", "NY"]

sizes·[String!]!= []

Charity size (must be capitalized): MICRO, SMALL, MEDIUM, LARGE, and SUPER

causes·[String!]!= []

Cause names to filter against. For possible values, visit https://taxonomy.candid.org/ and navigate to the "Subject" tab.

Attribution: This field utilizes data from the Philanthropy Classification System (PCS) by Candid (https://taxonomy.candid.org/). The PCS is licensed under a Creative Commons Attribution 4.0 International License (https://creativecommons.org/licenses/by/4.0/).

ratings·[String!]!= []

Rating number to filter against, from 0-4

is_rated·Boolean

Filter by whether the nonprofit has an Encompass star rating. true returns only rated nonprofits, false returns only unrated nonprofits, and omitting the argument returns both.

c3·Boolean!= false

501(c)3 filter

result_size·Int!= 10

Size of result set for pagination

from·Int!= 0

Offset of result set for pagination

advisories·[String!]!= []

Advisory levels to filter against. Possible values: "Review Before Proceeding", "Proceed with Caution", "Proceed with Increased Caution", "Giving Not Recommended". Note: This field will be deprecated in the future.

order_by·String!= "relevance"

Sort style for the result set. Valid values are: "relevance", "rating", "size"

Return Type

·PublicFacetedResponse!

Array of results

term·String

Search term to conduct a search based on the nonprofit's name or exact EIN match

size·Int!

Total number of results requested

result_count·Int!

Total number of results found

from·Int!

The offset of the first result in this response, used for pagination.