# Get Feed Posts
Source: https://docs.givingcompass.org/api-reference/endpoints/feed-posts
GET /feed/posts
Get posts from all nonprofits for the global feed, sorted by newest first.
Organization names are guaranteed to be populated via SQL lookup.
Supports optional filtering by classification and search.
# Browse Metrics
Source: https://docs.givingcompass.org/api-reference/endpoints/impact-metrics-browse
GET /impact/metrics
Browse impact metrics across multiple nonprofits.
Filter by EINs to retrieve metrics from specific organizations.
# Get Metrics for a Nonprofit
Source: https://docs.givingcompass.org/api-reference/endpoints/impact-metrics-by-ein
GET /impact/metrics/{ein}
Get impact metrics for a single nonprofit by EIN.
Returns quantitative measures (e.g., people served, meals distributed, volunteers engaged) extracted from annual reports.
# Browse Stories
Source: https://docs.givingcompass.org/api-reference/endpoints/impact-stories-browse
GET /impact/stories
Browse impact stories across multiple nonprofits.
Supports semantic search via the `q` parameter and filtering by EINs and power score.
# Get Stories for a Nonprofit
Source: https://docs.givingcompass.org/api-reference/endpoints/impact-stories-by-ein
GET /impact/stories/{ein}
Get impact stories for a single nonprofit by EIN.
Returns human transformation narratives with emotional hooks, quotes, and before/after states extracted from annual reports.
# Get Nonprofit Details
Source: https://docs.givingcompass.org/api-reference/endpoints/nonprofit-details
GET /nonprofits/details/{ein}
# Search Nonprofits
Source: https://docs.givingcompass.org/api-reference/endpoints/nonprofit-search
GET /beta/nonprofits/search
# Typeahead Nonprofits
Source: https://docs.givingcompass.org/api-reference/endpoints/nonprofit-typeahead
GET /typeahead/nonprofits
Search-as-you-type nonprofit suggestions matched by name or EIN
Search-as-you-type nonprofit lookup. Prefix-matches active 501(c)(3) legal names and IRS Business Master File alternate names using a weighted completion suggester, tolerating a single typo. Input that looks like an EIN—with or without dashes—returns that nonprofit directly.
## Authorizations
API key authentication. Required for all endpoints.
## Query Parameters
What the user typed (2–100 characters): a nonprofit name prefix, or an EIN with or without dashes (e.g. `12-3456789` or `123456789`).
Maximum number of suggestions to return (1–25).
2-letter state code. Accepted for forward-compatibility but **currently ignored**—results are not state-filtered yet.
## Response
The query string that was matched, echoed back.
Number of suggestions returned.
Ranked nonprofit suggestions, best match first.
The organization's 9-digit EIN as a string, with leading zeros preserved (e.g. `"030179419"`). Never coerce to an integer.
Display-ready, title-cased organization name.
Organization city, when available.
2-letter state code, when available.
Completion-suggester ranking weight, exposed for ranking and debugging only—don't surface it to end users.
Requests that fail validation (e.g. `q` shorter than 2 characters, `limit` outside 1–25) return a `422` validation error.
```bash cURL theme={null}
curl --request GET \
--url 'https://api.givingcompass.org/insights/typeahead/nonprofits?q=red%20cro&limit=5' \
--header 'X-API-Key: '
```
```python Python theme={null}
import requests
response = requests.get(
"https://api.givingcompass.org/insights/typeahead/nonprofits",
params={"q": "red cro", "limit": 5},
headers={"X-API-Key": ""},
)
print(response.json())
```
```javascript JavaScript theme={null}
const response = await fetch(
"https://api.givingcompass.org/insights/typeahead/nonprofits?" +
new URLSearchParams({ q: "red cro", limit: "5" }),
{ headers: { "X-API-Key": "" } }
);
const data = await response.json();
```
```json 200 theme={null}
{
"query": "red cro",
"count": 2,
"results": [
{
"ein": "530196605",
"name": "American National Red Cross",
"city": "Washington",
"state": "DC",
"score": 42.0
},
{
"ein": "030179419",
"name": "Red Crow Foundation",
"city": "Burlington",
"state": "VT",
"score": 18.5
}
]
}
```
```json 422 theme={null}
{
"detail": [
{
"loc": ["query", "q"],
"msg": "String should have at least 2 characters",
"type": "string_too_short"
}
]
}
```
# API Reference
Source: https://docs.givingcompass.org/api-reference/overview
Access nonprofit data, impact stories, financial information, and AI-powered search capabilities
## 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.
```bash theme={null}
X-API-Key: your_api_key_here
```
## Core Capabilities
### Nonprofit Search
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
Access nonprofit-generated content including articles, videos, and events
Access impact stories and metrics extracted from nonprofit annual reports
# Nonprofit Feed
Source: https://docs.givingcompass.org/documentation/feed
Access nonprofit-generated content including articles, videos, events, and job postings
## Overview
The Nonprofit Feed endpoint provides access to content posted by nonprofit organizations. This includes articles, videos, events, podcasts, job postings, and volunteer opportunities.
## Features
* **Content Filtering**: Filter by classification type (articles, videos, events, etc.)
* **Location-Based**: Filter posts by nonprofit location (city, state, county, ZIP)
* **Cause Area Filtering**: Filter by NTEE codes to find content from organizations in specific cause areas
* **Search**: Full-text search across post titles and content
* **Pagination**: Efficiently browse through large result sets
## Endpoint
`GET /feed/posts`
Retrieve posts from nonprofits with flexible filtering options
## Common Use Cases
### Get Latest Articles
```bash theme={null}
GET /feed/posts?classification=article&size=20
```
### Filter by Location
```bash theme={null}
GET /feed/posts?state=CA&city=San%20Francisco
```
### Search for Specific Topics
```bash theme={null}
GET /feed/posts?search=climate%20change
```
### Filter by Cause Area
```bash theme={null}
GET /feed/posts?ntee_codes=A20,B25
```
## Response Format
The endpoint returns paginated results with the following structure:
```json theme={null}
{
"results": [
{
"id": "string",
"title": "string",
"content": "string",
"classification": "article",
"organization_name": "string",
"ein": "123456789",
"published_date": "2024-01-01T00:00:00Z",
"url": "string"
}
],
"total": 100,
"page": 1,
"size": 20
}
```
# Nonprofit Impact
Source: https://docs.givingcompass.org/documentation/impact
Access nonprofit impact stories and metrics extracted directly from annual reports
## Overview
The Nonprofit Impact product provides access to AI-extracted impact data from nonprofit annual reports. Get both compelling human stories and quantitative metrics that demonstrate real-world outcomes.
## What You Get
### Impact Stories
Human transformation narratives extracted from annual reports, including:
* **Emotional Hooks**: Compelling story openings that capture attention
* **Direct Quotes**: Authentic voices from beneficiaries and stakeholders
* **Transformation Arcs**: Before/after states showing real change
* **Power Scores**: AI-generated quality ratings (0-10) to surface the most compelling narratives
* **Source Attribution**: Links back to original annual reports
### Impact Metrics
Quantitative measures that demonstrate organizational effectiveness:
* **Outcome Metrics**: People served, meals distributed, lives changed
* **Geographic Impact**: Where the impact occurred
* **Time Frames**: Annual, quarterly, or program-specific measurements
* **Metric Types**: Automatically categorized for easy filtering
* **Source Context**: Original text snippets from reports
## Key Features
* **Semantic Search**: Find relevant stories using natural language queries like "education outcomes" or "community health"
* **Multi-Organization Browsing**: Discover impact data across thousands of nonprofits
* **Quality Filtering**: Filter stories by power score to find the most compelling narratives
* **EIN-Based Lookup**: Retrieve all impact data for specific organizations
* **Direct Report Links**: Access original source documents for verification
## Use Cases
### Donor Platforms
Help donors discover nonprofits with proven impact through authentic stories and verified metrics.
### Grant Management
Evaluate nonprofit effectiveness using standardized impact data extracted from annual reports.
### Research & Analytics
Aggregate impact metrics across cause areas to identify trends and benchmark performance.
### Marketing & Communications
Source compelling impact stories with proper attribution for campaigns and content.
### Impact Measurement
Track and compare outcomes across similar organizations using consistent data extraction.
## Endpoints
Explore the full API reference for browsing impact stories, retrieving metrics, and filtering by organization or impact type.
# Nonprofit Details
Source: https://docs.givingcompass.org/documentation/nonprofit-details
Retrieve a complete nonprofit profile by EIN, including mission, location, financials, and impact
## Overview
The Nonprofit Details product gives you the full profile of any U.S. nonprofit using its EIN (Employer Identification Number). One request returns everything you need to display or evaluate an organization: identity, mission summary, address, cause areas, financials, IRS filing information, and Giving Compass vetting status.
## Key Features
* **Complete Profiles**: Name, mission summary, original mission statement, website, and contact address (including county) in a single response
* **Financial Snapshot**: Latest reported total revenue, total expenses, net assets, employee count, and filing year from IRS data
* **Organization Details**: Organization type, legal form, category group, and principal and business officer contacts
* **Cause Classification**: NTEE code with its plain-language description and definition, issue area, and mapped UN Sustainable Development Goals (SDGs)
* **Trust Signals**: Giving Compass vetting status, IRS ruling date, and a link to the source IRS filing
* **Impact Context**: An AI-generated impact summary describing the organization's outcomes
* **Geolocation**: Latitude and longitude for mapping and proximity features
## How It Works
Every U.S. nonprofit is identified by a unique 9-digit EIN assigned by the IRS. Pass that EIN in the request path and the API returns the organization's full profile:
```bash theme={null}
GET /nonprofits/details/530196605
```
The EIN must be exactly 9 digits with no hyphens or spaces. For example, use `530196605`, not `53-0196605`. Requests with any other format are rejected with a validation error.
## Use Cases
### Organization Profile Pages
Build rich nonprofit profile pages in your product—mission, location, financials, and donation link—from a single API call.
### Due Diligence
Verify an organization's identity, IRS standing, and financial scale before recommending it to donors or approving a grant.
### Search-to-Detail Workflows
Pair with [Nonprofit Search](/documentation/nonprofit-search): search results return EINs, then fetch full details for the organization a user selects.
### Data Enrichment
Enrich your existing donor or grantee records with cause classifications, SDG mappings, and up-to-date financials keyed by EIN.
## Response Format
The endpoint returns a single nonprofit profile:
```json theme={null}
{
"ein": "530196605",
"name": "AMERICAN NATIONAL RED CROSS & ITS CONSTITUENT CHAPTERS AND BRANCHES",
"altName": "SHARED SERVICES CENTER",
"url": "www.redcross.org",
"summary": "The American National Red Cross provides national and international disaster relief, collects and distributes approximately 40 percent of the nation's blood supply...",
"originalMissionStatement": "THE AMERICAN RED CROSS PREVENTS AND ALLEVIATES HUMAN SUFFERING IN THE FACE OF EMERGENCIES BY MOBILIZING THE POWER OF VOLUNTEERS AND THE GENEROSITY OF DONORS.",
"streetAddress": "430 17TH ST NW",
"city": "WASHINGTON",
"county": "District of Columbia",
"state": "DC",
"zipCode5": "20006",
"ntee": "P210",
"nteeDetails": {
"code": "P21",
"description": "American Red Cross",
"definition": "Separately incorporated, local chapters of the American Red Cross."
},
"issueArea": "Human Services: General",
"yearFounded": 1900,
"filingYear": 2024,
"expensesGrandTotal": 3285860000.0,
"revenueGrandTotal": 3916980000.0,
"netAssets": 4116230000.0,
"foundation": false,
"inactive": false,
"gcVetted": false,
"irsRulingDate": "1938-12-01",
"irsFilingUrl": null,
"categoryGroup": "Human Services",
"deductibility": "1",
"organizationForm": "Corporation",
"employees": 17907.0,
"organizationType": "501(C)(3)",
"principalOfficerName": null,
"businessOfficerName": null,
"businessOfficerPhone": null,
"sdgs": [3, 11],
"formType": "990",
"gcVideoUrl": null,
"gcDonationUrl": "https://www.redcross.org/donate/donation.html",
"gcImpactUrl": null,
"lat": 38.8985,
"lng": -77.0412,
"sources": {
"ai": {
"website_url": {
"value": "https://www.example.org",
"source": "https://www.example.org",
"reasoning": "Explanation of how the value was verified...",
"date_updated": "2026-01-01T00:00:00Z"
},
"donation_url": {
"value": "https://www.example.org/donate",
"source": "https://www.example.org/donate",
"reasoning": "Explanation of how the value was verified...",
"date_updated": "2026-01-01T00:00:00Z"
}
},
"irs": {
"website_url": {
"value": "WWW.EXAMPLE.ORG"
}
},
"manual": null
},
"socialAccounts": {
"tiktok": "@americanredcross",
"threads": "@americanredcross",
"twitter": "@redcross",
"facebook": "redcross",
"linkedin": "company/american-red-cross",
"instagram": "americanredcross"
},
"cnScore": 91.0,
"cnRating": 4,
"cnSize": "SUPER",
"vectorScore": null,
"impactSummary": null
}
```
Fields that are not available for a given organization are returned as `null`.
`nteeDetails` describes the organization's NTEE category. Codes longer than 3 characters resolve to their 3-character parent category, so `nteeDetails.code` may differ from `ntee`. It is `null` when the code isn't in the NTEE list.
## Endpoint
`GET /nonprofits/details/{ein}`
Retrieve the full profile of a nonprofit by its 9-digit EIN
# Nonprofit Search
Source: https://docs.givingcompass.org/documentation/nonprofit-search
Find nonprofits using natural language queries with AI-powered search
## Overview
The Nonprofit Search product lets you find organizations using plain English queries. Instead of building complex filter combinations, describe what you're looking for and the AI extracts intent, location, financial criteria, and cause areas automatically.
## Key Features
* **Natural Language Queries**: Search using phrases like "education nonprofits in Texas with revenue over \$1M"
* **AI Intent Processing**: Automatically extracts filters from your query—location, revenue ranges, cause areas, and more
* **Flexible Filtering**: Combine natural language with explicit filters for precise results
* **Session Context**: Maintain conversation context across multiple queries for refined searches
* **Relevance Scoring**: Results ranked by semantic similarity to your query
## How It Works
When you submit a query, the API:
1. Parses your natural language input using an LLM
2. Extracts structured filters (location, revenue, NTEE codes, SDGs)
3. Performs a vector search against nonprofit descriptions
4. Returns ranked results with extracted intent details
## Use Cases
### Prospect Research
Quickly identify potential grantees or partners matching specific criteria without building complex queries.
```bash theme={null}
GET /beta/nonprofits/search?q=youth mentoring programs in urban areas with budget under 500k
```
### Portfolio Analysis
Find organizations similar to ones you already work with by describing their characteristics.
```bash theme={null}
GET /beta/nonprofits/search?q=nonprofits similar to food banks serving rural communities
```
### Geographic Discovery
Locate organizations in specific regions for targeted outreach or reporting.
```bash theme={null}
GET /beta/nonprofits/search?q=environmental conservation groups in the Pacific Northwest
```
### Financial Screening
Filter by organization size to match your funding criteria or partnership requirements.
```bash theme={null}
GET /beta/nonprofits/search?q=healthcare nonprofits with revenue between 1M and 10M
```
## Example Queries
The AI understands a variety of query patterns:
| Query | Extracted Filters |
| - | - |
| "Animal shelters in Los Angeles" | cause: animal welfare, city: Los Angeles |
| "Large education nonprofits in NY" | cause: education, state: NY, size: large |
| "Climate organizations with 4-star rating" | cause: environment, min\_rating: 4 |
| "SDG 4 focused nonprofits under \$500k revenue" | SDG: 4, max\_revenue: 500000 |
## Response Format
The endpoint returns matched nonprofits along with the interpreted intent:
```json theme={null}
{
"intentDetails": {
"intent": "nonprofit_search",
"cause": "education",
"state": "CA",
"min_revenue": 100000
},
"nonprofits": [
{
"ein": "123456789",
"name": "Example Education Foundation",
"summary": "Providing educational resources...",
"city": "San Francisco",
"state": "CA",
"revenueGrandTotal": 250000,
"vectorScore": 0.85
}
]
}
```
## Endpoint
`GET /beta/nonprofits/search`
Search nonprofits using natural language with AI-powered intent extraction
This endpoint is in beta. Parameters and response format may change.
# Nonprofit Typeahead
Source: https://docs.givingcompass.org/documentation/nonprofit-typeahead
Search-as-you-type nonprofit suggestions by name or EIN for autocomplete experiences
## Overview
The Nonprofit Typeahead product powers autocomplete in your application. As a user types, each keystroke returns ranked nonprofit suggestions matched by organization name—or by EIN, with or without dashes. It's built for speed and forgiving input, so users find the right organization in a few characters even with a typo.
## Key Features
* **Search-as-You-Type**: Fast prefix matching designed to run on every keystroke
* **Name and EIN Matching**: Matches organization names and alternate names, or an EIN typed as `12-3456789` or `123456789`
* **Typo Tolerance**: A single typo still finds the intended organization
* **Alternate Names Included**: Matches IRS Business Master File alternate names, not just legal names
* **Display-Ready Results**: Names come back title-cased and ready to render in a dropdown
* **Active Organizations Only**: Suggestions cover active 501(c)(3) organizations
## How It Works
Send the user's input as the `q` parameter (2–100 characters) and render the ranked suggestions:
```bash theme={null}
GET /typeahead/nonprofits?q=red cro&limit=5
```
Behind the scenes, the API runs a weighted completion suggester over active 501(c)(3) legal names and BMF alternate names, tolerating one typo. If the input looks like an EIN, the matching nonprofit is returned directly—making this a fuzzy EIN lookup as well.
## Use Cases
### Donation and Grant Forms
Let donors or grant managers pick the right organization from a dropdown instead of typing a full legal name.
### Fuzzy EIN Lookup
Accept an EIN in any format the user types—`12-3456789` or `123456789`—and resolve it to an organization. Then pass the returned EIN to [Nonprofit Details](/documentation/nonprofit-details) for the full profile.
### Data Entry Validation
Confirm an organization exists (and is active) as users enter it, catching misspellings before records are saved.
## Response Format
```json theme={null}
{
"query": "red cro",
"count": 2,
"results": [
{
"ein": "530196605",
"name": "American National Red Cross",
"city": "Washington",
"state": "DC",
"score": 42.0
},
{
"ein": "030179419",
"name": "Red Crow Foundation",
"city": "Burlington",
"state": "VT",
"score": 18.5
}
]
}
```
EINs are returned as strings and may carry leading zeros (e.g. `"030179419"`). Never convert them to integers. The `score` field is a ranking weight for debugging—don't display it to end users.
A `state` parameter is accepted for forward-compatibility but is currently ignored—results are not state-filtered yet.
## Pairs Well With
Typeahead returns the EIN; Nonprofit Details returns everything else. A typical flow: the user picks a suggestion from your dropdown, then your app fetches the full profile.
Fetch the complete profile for a selected suggestion using its EIN
## Endpoint
`GET /typeahead/nonprofits`
Ranked search-as-you-type suggestions matched by nonprofit name or EIN
# Introduction
Source: https://docs.givingcompass.org/index
The intelligence layer for philanthropic platforms—nonprofit discovery, impact intelligence, and live nonprofit content in one API
The Giving Compass Insights API turns nonprofit data into donor confidence. Whether you're building a donor-advised fund platform, a grant management system, or a wealth management tool, the API answers the three questions behind every giving decision: *who is this organization, do they deliver, and what are they doing right now?*
## What You Can Do
Every way to find a nonprofit—a plain-English question, a few keystrokes, or an EIN—and the complete verified profile once you have it.
The story the 990 can't tell: AI-extracted impact narratives and outcome metrics straight from nonprofit annual reports.
What nonprofits are publishing right now—articles, events, videos, jobs, and volunteer opportunities.
## Built on Complete, Current Data
The entire, most current picture of every U.S. nonprofit—anchored in official IRS records and enriched with what organizations say about themselves.
* **IRS filings**: Form 990 series, the Business Master File (BMF), SOI extracts, and Publication 78 tax-exempt verification
* **Nonprofit-provided data**: annual reports (the source of our impact stories and metrics) and content organizations publish on their own channels
* **Growing context**: we're expanding coverage with census data and additional datasets to place every organization in its community context
## Quick Start
Get up and running in minutes:
[Request an API key](https://solutions.givingcompass.org/request-api-key) to authenticate your requests.
Include your key in the `X-API-Key` header:
```bash theme={null}
curl -X GET "https://api.givingcompass.org/insights/beta/nonprofits/search?q=education nonprofits in California" \
-H "X-API-Key: your_api_key_here"
```
Browse the [API Reference](/api-reference/overview) for all available endpoints and parameters.