Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.givingcompass.org/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The Giving Compass Insights API provides access to nonprofit data, impact stories, financial information, and AI-powered search capabilities.

​
Authentication

All endpoints require an API key passed via the X-API-Key header. 
X-API-Key: your_api_key_here

​
Core Capabilities

Search and filter nonprofits by location, revenue, expenses, cause areas, and Charity Navigator ratings. Use Natural language search for nonprofits and content. Example queries:
  • Find articles about clean water
  • Find nonprofits in Chicago with revenue over 100k
  • Show nonprofits in TX that help the blind
  • Nonprofits that are similar to JDRF
  • Nonprofits that focus on SDG 5 with revenue between 1M and 5M

​
Impact Data

Access AI-extracted impact stories and metrics from nonprofit annual reports:
  • Stories: Human transformation narratives with emotional hooks, quotes, and before/after states
  • Metrics: Quantitative measures (people served, meals distributed, volunteers, etc.)

​
Feed Data

Access and filter nonprofit posts (articles, events, videos, job postings) from organizations:
  • Content Types: Filter by classification (articles, videos, events, podcasts, job postings, volunteer opportunities)
  • Location Filtering: Filter posts by nonprofit’s city, county, state, ZIP code, or geographic radius (lat/lng)
  • Cause Area Filtering: Filter by NTEE codes to find posts from organizations working in specific cause areas

​
Base URL

https://api.givingcompass.org/insights

​
Getting Started

Feed Endpoints

Access nonprofit-generated content including articles, videos, and events

Nonprofit Impact Endpoints

Access impact stories and metrics extracted from nonprofit annual reports