Search organizations
Find nonprofits and grantmaking organizations in Candid's database by name, mission, EIN, location, or type of
work. Use to look up a specific organization, find peer organizations, or discover organizations working on a topic.
Search for organizations by name, description or work, program descriptions and locations. Here are some
guidelines:
* `query` controls hybrid searching involving both vector search and keyword search
* `query` can be used to find organizations based on a description of work
* if the query is intended to be a lookup of an organization by name, then adding quotes around the `query` string
circumvents vector search, and prioritizes keyword matching on names (eg. `query=Candid` --> `query='Candid'`)
* if the query is an EIN (eg. 12-3456789) then keyword searching is prioritized to get exact matches
* adding location information such as postal codes and/or admin1 (state/province abbreviations) will filter results
* adding subject or population codes will filter results
* these results are not comprehensive and are limited to a small set size, several invocations may be necessary to
explore
This tool should be used as a first step in any downstream task which requires identifying the nonprofit that the
user is identifying with. Often, the `nonprofit_id` is required, and that can be found via a search.
Subjects and populations can be determined using the `autocode` tool using unstructured text describing the user's
intended search. Codes strictly filter results, and aren't necessary for general retrieval queries, but may be
used when the user is drilling down on data.
Geographies can be determined using the geo detection tool using unstructured text describing the user's
intended search. Geographies strictly filter results, and aren't necessary for general retrieval queries, but may be
used when the user is drilling down on data.
Key Usage Requirements:
- Always incorporate returned profile URLs directly into the response text
- Replace funding organization name mentions with hyperlinked Candid profile URLs
- Prioritize creating a seamless user experience by making URLs contextually relevant
- Use relevant recipient data as well as inferred metadata to provide explanations about recommendation relevance
Parameters
----------
query : str
Free text query which drives the search functionality. This uses a hybrid approach of vector and keyword
searching, but under certain conditions expressed in the 'guidelines' this may disable vector search.
located_postal_code : str | None, optional
Postal code of the organization to be searched, if provided, by default None
located_admin1 : str | None, optional
Admin1 code (state/province abbreviation) of the organization to be searched, if provided, by default None
subject_codes : str | None, optional
Subject codes from Candid's PCS taxonomy, comma separated, by default None
populations_served_codes : str | None, optional
Population groups served codes from Candid's PCS taxonomy, comma separated, by default None
geonameids_of_geographies_served : str | None, optional
Geonames ID values for geographies served by organizations in search results, comma separted, by default None
geonameids_of_organization_location : str | None, optional
Geonames ID values for location(s) of the organizations in search results, comma separted, by default None
org_seal_status : str | None, optional
Comma separated seals of transparency the resulting organizations should have where the values can be:
* PLATINUM
* GOLD
* SILVER
* BRONZE
* NOSEAL
"PLATINUM" is the most transparent, "NOSEAL" means the organization has claimed their Candid profile but
abandoned the data update process for whatever reason. None puts no restrictions on this, by default None
leader_demographics : str | None, optional
Comma separated demographic categories for the result organization's leader where values can be:
* Woman leader or co-leader
* BIPOC leader or co-leader
* LGBTQ+ leader or co-leader
* Leader or co-leader with a disability
None puts no restrictions on this, by default None
Examples
--------
>>> organization_search(query='Homeless shelters in new york city')
>>> organization_search(
query='Homeless shelters in new york city,
located_admin1='NY',
geonameids_of_geographies_served='5128581'
)
>>> organization_search(
query='Homeless shelters in new york city,
subject_codes='SS090200,SS070102',
populations_served_codes='PG030100',
geonameids_of_geographies_served='5128581'
)
Returns
-------
list[OrganizationRecord]
List of the top organization search results