The Giving Compass API

The Giving Compass API Overview

Giving Compass is designed to help donors give better. Our editorial team works tirelessly to vet, research and summarize the best philanthropic information. No fake news here! We have published more than 14,000 articles, guides and videos to help educate people and guide them toward giving with impact. As we all try to navigate a complex world, Giving Compass is also a place to find inspiring stories and examples of solutions to social issues.

Now, we’re making all of that content available to other organizations via a simple (but easily customizable) API. If your organization wishes to have a direct custom integration with Giving Compass, the API is the way to do it. Get your API key and have access to our interface to be able to define your own parameters and extract content from Giving Compass to be presented to your visitors in the page of your choice and with complete control over design elements such as font, style, colors, layout and more. If you are a web developer and are ready to explore our API, please see details below. If you are a partner and are missing your API key, contact us.

API Parameters at a Glance

The following is a list of parameters that can be customized to meet your organization’s requirements:

Query String: This allows the developer to specify keywords to include (and exclude) in the search.

Categories: All our articles are tagged with a category (e.g. – education, environment, health, etc.). This parameter allows the developer to specify the categories of content to be returned by the API.  If the developer does not specify a category, all categories are searched.

Regions: This allows the developer to customize the search experience based on region or geography.

Content Types: This allows the developer to customize the type of content that is returned by the API. If the developer does not specify a type, all content types (i.e., articles, partner articles, funds, PDFs) will be returned.

Media Types: This parameter refers to the selection of supported media types. Media type options include text, audio, and video.

Data Items: Data items refers to the specific components of the content being returned. This parameter allows the developer to customize the data items (image, title, excerpt) to be returned after the search is complete.

Sort Order and Page Size: This allows the developer to determine the manner in which search results are displayed. Sorting options include by: Date (most recent first), Popularity (most views first), and Shares (most shares first).