Charity Navigator Scraper

Scrape 1.8M+ US nonprofit charities from the ProPublica Nonprofit Explorer database. Search by keyword, cause category, state, or tax status — or look up any charity directly by EIN to get its full financial history, IRS Form 990 filings, and PDF links.

What you get

Each record includes:

Field	Description
name	Official charity name
ein	IRS Employer Identification Number (9-digit)
einFormatted	EIN in XX-XXXXXXX format
city, state	Location
zipCode	ZIP code (detail mode)
address	Street address (detail mode)
nteeCode	NTEE category code (e.g. B20 = Elementary Education)
subsectionCode	IRS subsection code (3 = 501c3, 4 = 501c4, etc.)
assetAmount	Total assets (USD)
incomeAmount	Total income (USD)
revenueAmount	Total revenue (USD)
totalRevenue	Revenue from latest filing (detail mode)
totalExpenses	Expenses from latest filing
totalAssets	Assets from latest filing
totalLiabilities	Liabilities from latest filing
totalContributions	Contributions & grants received
programRevenue	Program service revenue
officerCompensation	Officer compensation amount
pdfUrl	Direct link to IRS Form 990 PDF
filingYear	Year of the filing
rulingDate	IRS ruling date
sourceUrl	ProPublica organization page URL
scrapedAt	Timestamp of data collection

Input options

Mode: Search (mode=search)

Search charities by keyword with optional filters:

{
  "mode": "search",
  "query": "food bank",
  "state": "TX",
  "nteeCode": "K",
  "maxItems": 50
}

Mode: Lookup by EIN (mode=byEIN)

Fetch full org details + latest filing data for specific charities:

{
  "mode": "byEIN",
  "eins": ["53-0196605", "13-1837418"],
  "includeFilings": true,
  "maxItems": 100
}

Mode: Top by Revenue (mode=topByRevenue)

Get largest nonprofits sorted by revenue:

{
  "mode": "topByRevenue",
  "state": "CA",
  "nteeCode": "E",
  "maxItems": 25
}

Input parameters

Parameter	Type	Description
mode	string	Required. search, byEIN, or topByRevenue
query	string	Search query for search mode
eins	array	List of EINs for byEIN mode
state	string	Filter by state (2-letter code)
nteeCode	string	NTEE major category (A–Z)
cCode	string	Tax status code (3=501c3, 4=501c4, etc.)
includeFilings	boolean	Emit individual filing records in byEIN mode
maxItems	integer	Max records to return (1–10,000, default 100)

Use cases

• Donor research — Find vetted nonprofits in a specific cause area and geography
• Fundraising intelligence — Identify top-revenue charities in your sector
• Grant prospecting — Research foundations by NTEE code and financial size
• Competitive analysis — Compare similar nonprofits by revenue, assets, and programs
• Due diligence — Pull full IRS filing history for any charity by EIN
• Data journalism — Analyze nonprofit sector trends across states and categories

NTEE categories

Code	Category
A	Arts, Culture & Humanities
B	Education
C	Environment
D	Animal-Related
E	Health Care
F	Mental Health
G	Medical Diseases & Disorders
H	Medical Research
K	Food, Agriculture & Nutrition
L	Housing & Shelter
O	Youth Development
P	Human Services
T	Philanthropy & Grantmaking

FAQ

Is this free to use? Yes — no API key or login required. Data is sourced from ProPublica's publicly accessible Nonprofit Explorer, which covers all IRS-registered tax-exempt organizations.

How many charities are available? Over 1.8 million IRS-recognized tax-exempt organizations in the United States.

How current is the data? Data is updated as new IRS Form 990 filings are processed. Most records include filings through 2022–2023.

What is an NTEE code? The National Taxonomy of Exempt Entities (NTEE) classifies nonprofits into 26 major categories (A–Z) with subcategories (e.g. B20 = Elementary & Secondary Education).

Can I get PDF copies of Form 990 filings? Yes — use mode=byEIN to retrieve pdfUrl for each filing year.

What's the difference between incomeAmount and totalRevenue? incomeAmount is the IRS master file value (search mode); totalRevenue comes from the detailed Form 990 filing (byEIN mode). They represent the same metric but from different data sources.

Data source

Data is sourced from ProPublica's Nonprofit Explorer, which aggregates IRS Form 990 filings for all registered US tax-exempt organizations.