Get started with Essentials

Overview

Essentials API is Candid's nonprofit search engine, where you an fine the most common set of data about nonprofits to quickly find organizations most relevant to your users, and use those results to get more data from our other APIs. The Essentials API returns search results in JSON format.

  • Search by organization name, keyword, or EIN when users want to find nonprofits relevant to their interests.
  • Research nonprofits most relevant to your users based on keyword search terms, location, financials & more.
  • Create advanced search capabilities for your users to search by cause area as reflected by the IRS, within a location and radius, between a financial range across revenue, assets and expenses, or by revoked, defuncted or merged organizations.
  • Allow users to filter results based on Pub78 Verification, audits performed, and form types filed with the IRS.
  • Display results with nonprofit branding including mission, website, logo, and contact information to help users easily recognize their favorite nonprofits.

Endpoints

The following endpoints are the most recent versions included with Essentials API:

Organization Search Endpoints

  • Essentials API v2 (Most Recent Version) - Search GuideStar’s most common set of data about nonprofits to quickly find organizations most relevant to your users, and use those results to get more data from our other APIs. API returns search result in JSON format.

👍

Easily Build Your Essentials v2 Search Query

Take all the guess-work out of building your search query by using the built-in query generator on the Essentials API v2 API Docs page.

Lookup Value Helper Endpoints

  • Essentials Lookup API - Provides a list of all the tables used as a filter_name with the Essentials Lookup endpoints. The tables and their contents can be used to generate dropdowns and filters in your system when using the Essentials API.
  • Essentials Lookup Filter Name API - Provides a list of all the human-readable search values within a specific filter_name table that can be used in search queries with the Essentials endpoints. Each array contains a table key, name value, and search value. The resulting search_value(s) can be passed as search values in the Essentials API.
  • Essentials Lookup Key Value API - Lookup details on a specific filter using the known filter_name and key_or_value. The resulting search_value can be passed as a search value in the Essentials API.

Essentials endpoint-specific user guides




Did this page help you?