ProPublica Nonprofit Form 990 & Financial Intelligence Scraper

Extract verified US 501(c)(3) nonprofit and private foundation financial profiles, annual revenues, total assets, functional expenses, executive officer compensation, and official IRS Form 990 PDF download links directly from ProPublica Nonprofit Explorer.

---

🎯 Key Features & Capabilities

• IRS Tax Filing Intelligence: Access official Form 990, 990-EZ, and 990-PF tax return disclosures filed by US tax-exempt organizations.
• Granular Financial Metrics: Extracts Total Revenue, Total Functional Expenses, Total Assets (End of Year), Net Income, and historical financial trends over multiple tax years.
• Direct Form 990 PDF Links: Retrieve verified direct URLs to the original IRS PDF filings for immediate compliance, auditing, or due diligence.
• Targeted Search & Filtering: Filter by keyword (e.g. foundation, hospital, university, cancer, animal rescue), US state (e.g. NY, CA, TX), 501(c) subsection, and minimum annual revenue thresholds.

---

💼 Commercial Use Cases

• Wealth Management & Private Banking: Identify large family foundations, trustees, and board members with substantial philanthropic endowments.
• Executive Search & Compensation Benchmarking: Analyze executive salaries, officer compensation, and leadership structures across hospital systems and universities.
• B2B Non-Profit Tech & SaaS Sales: Qualify nonprofit leads based on verifiable annual operating budgets and cash reserves before initiating sales conversations.
• Philanthropy & Grant Due Diligence: Evaluate financial health, program-to-expense ratios, and asset stability of potential grant recipients.

---

📥 Input Parameters

Parameter	Type	Default	Description
searchQuery	String	"foundation"	Organization name or keyword (e.g., foundation, hospital, university).
state	String	"NY"	US state 2-letter code (e.g., NY, CA, MA, TX). Leave blank for nationwide.
cCode	Integer	3	IRS 501(c) subsection code (e.g., 3 for 501(c)(3) charities and foundations).
minRevenue	Integer	100000	Filter out organizations with annual revenue below this dollar amount (set to 0 for all).
fetchFilingDetails	Boolean	true	Fetch multi-year IRS filing records, assets, expenses, and PDF download URLs.
maxItems	Integer	25	Maximum number of organizations to extract (1 to 500).

---

📤 Output Dataset Format

{
  "ein": 237305157,
  "formattedEin": "23-7305157",
  "name": "Harvard Conservation Trust",
  "subName": null,
  "city": "Harvard",
  "state": "MA",
  "nteeCode": "C340",
  "propublicaUrl": "https://projects.propublica.org/nonprofits/organizations/237305157",
  "address": "PO Box 31",
  "zipCode": "01451-0031",
  "website": "www.harvardconservationtrust.org",
  "rulingDate": "1974-06-01",
  "latestTaxYear": 2023,
  "latestRevenue": 1537626,
  "latestExpenses": 526616,
  "latestAssets": 12029204,
  "latestForm990PdfUrl": "https://projects.propublica.org/nonprofits/download-filing?path=IRS%2F237305157_202312_990_2025021423096316.pdf",
  "historicalFilings": [
    {
      "taxYear": 2023,
      "formType": "990",
      "totalRevenue": 1537626,
      "totalExpenses": 526616,
      "totalAssets": 12029204,
      "totalLiabilities": 0,
      "netIncome": 1011010,
      "officerCompensation": null,
      "pdfUrl": "https://projects.propublica.org/nonprofits/download-filing?path=IRS%2F237305157_202312_990_2025021423096316.pdf"
    }
  ]
}

---

🚀 How to Run Locally

cd nonprofit-form-990-scraper
python -m src.main