# Charity Navigator Nonprofit Ratings Scraper (`parseforge/charitynavigator-scraper`) Actor Scrape nonprofit charity ratings and financial data from Charity Navigator. Get organization names, EIN numbers, star ratings, scores, causes, revenue, assets, and donation eligibility. Search by keyword or browse all charities. Filter by cause, size, state, and minimum rating. - **URL**: https://apify.com/parseforge/charitynavigator-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Other, Automation, Developer tools - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ![ParseForge Banner](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg) ## 🏛️ Charity Navigator Nonprofit Ratings Scraper Whether you're a donor researching charities, a nonprofit benchmarking your performance, or a researcher analyzing the nonprofit sector, this tool makes it easy to collect structured charity data from Charity Navigator, the world's largest charity evaluator. > **The Charity Navigator Scraper collects nonprofit data including names, ratings, scores, financial information, causes, leadership details, and IRS data. Search by keyword, cause, size, state, and rating.** ### ✨ What Does It Do - ⭐ **Charity ratings** - collect star ratings (1-4) and overall scores for thousands of nonprofits - 💰 **Financial data** - extract revenue, assets, expenses, and program spending from IRS filings - 🏷️ **Cause categories** - health, education, environment, human services, and 20+ categories - 📍 **Location data** - city, state, and full address information - 📋 **IRS details** - EIN numbers, NTEE codes, tax status, and filing information - 👥 **Leadership info** - staff details, board composition, and governance policies ### 🔧 Input - **Search Query** - search for charities by name or keyword (e.g., 'Red Cross', 'cancer', 'education') - **Max Items** - how many charities to collect (free users get 10 items, paid users up to 1,000,000) - **Cause** - filter by cause category (Health, Education, Environment, etc.) - **Organization Size** - filter by annual revenue (Small, Medium, Large, Super) - **State** - filter by US state (2-letter code) - **Minimum Rating** - only include charities with at least this star rating (1-4) - **Include Full Details** - fetch financial data, IRS information, and leadership details ```json { "searchQuery": "cancer", "maxItems": 50, "cause": "Health", "minRating": 3, "includeDetails": true } ```` ### 📊 Output Each charity record includes up to 35+ data fields. Download as JSON, CSV, or Excel. | Field | Description | |-------|-------------| | url | Charity Navigator profile page | | name | Organization name | | ein | IRS Employer Identification Number | | rating | Overall score (0-100%) | | starRating | Star rating (1-4) | | causes | Cause categories | | size | Revenue size (Small/Medium/Large/Super) | | totalRevenue | Annual total revenue | | totalAssets | Total assets | | programExpenses | Program service expenses | | totalEmployees | Number of employees | | mission | Organization mission statement | | website | Official website | ```json { "url": "https://www.charitynavigator.org/ein/530196605", "name": "American Red Cross", "ein": "530196605", "city": "Washington", "state": "DC", "rating": 99, "starRating": 4, "causes": ["International development", "Disasters and emergency management"], "size": "SUPER", "subsection": "501(c)(03)", "totalRevenue": 3804377344, "totalAssets": 4565143729, "programExpenses": 3219189859, "totalEmployees": 18957, "mission": "Since its founding in 1881 by Clara Barton...", "website": "http://www.redcross.org", "scrapedAt": "2026-04-07T12:00:00.000Z" } ``` ### 💎 Why Choose the Charity Navigator Scraper? | Feature | Our Tool | Manual Charity Navigator | |---------|----------|------------------------| | Batch collection | Up to 1M charities | Browse one at a time | | Multiple filters | Cause, size, state, rating | Limited search | | Financial data | Revenue, assets, expenses | Click each profile | | Structured output | JSON, CSV, Excel | Web pages only | | Automated scheduling | Daily/weekly monitoring | Manual visits | | IRS data | NTEE codes, tax status | Scattered across pages | ### 📋 How to Use 1. **Sign Up** - [Create a free account w/ $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) 2. **Configure** - set your search query, filters, and how many charities you want 3. **Run It** - click "Start" and get structured charity data in seconds No coding, no setup, no manual browsing required. ### 🎯 Business Use Cases - 💝 **Donors** - research and compare charities before donating to find the most effective organizations - 🏢 **Nonprofits** - benchmark your ratings, financials, and governance against peer organizations - 📊 **Researchers** - analyze nonprofit sector trends, funding patterns, and organizational health - 🏦 **Foundations** - evaluate potential grantees using financial efficiency and governance metrics - 📰 **Journalists** - investigate nonprofit finances, executive compensation, and organizational changes - 🤝 **CSR teams** - identify high-performing charities for corporate giving and partnership programs ### ❓ FAQ 🏛️ **What is Charity Navigator?** Charity Navigator is the world's largest and most-utilized independent charity evaluator, rating over 200,000 nonprofits based on financial health, accountability, and transparency. ⭐ **How does the rating system work?** Charities receive 1-4 stars based on an overall score (0-100%) that evaluates financial health, accountability, leadership, culture, and impact measurement. 📋 **What financial data is available?** With details enabled, you get total revenue, assets, liabilities, net assets, contributions, program expenses, management expenses, fundraising expenses, employee count, and board composition. ⏱️ **How long does a run take?** Basic mode: 100 charities in about 10 seconds. With details enabled, each charity takes an additional 0.5-1 second for the full profile fetch. 🔍 **What NTEE codes are?** National Taxonomy of Exempt Entities codes classify nonprofits by type and purpose (e.g., P21 for Red Cross, E30 for Health Care Facilities). ### 🔗 Integrate Charity Navigator Scraper with any app - [Make](https://docs.apify.com/platform/integrations/make) - Automate charity research workflows - [Zapier](https://docs.apify.com/platform/integrations/zapier) - Get alerts when charity ratings change - [Slack](https://docs.apify.com/platform/integrations/slack) - Get notified about charity updates - [Google Drive](https://docs.apify.com/platform/integrations/drive) - Export charity data to spreadsheets - [Webhooks](https://docs.apify.com/platform/integrations/webhooks) - Trigger actions when runs complete ### 💡 Recommended Actors Looking for more data collection tools? Check out these related actors: | Actor | Description | Link | |-------|-------------|------| | Grants.gov Scraper | Collect federal grant opportunities | [Link](https://apify.com/parseforge/grants-gov-scraper) | | GSA eLibrary Scraper | Government contract data from GSA | [Link](https://apify.com/parseforge/gsa-elibrary-scraper) | | PR Newswire Scraper | Collect press releases and news | [Link](https://apify.com/parseforge/pr-newswire-scraper) | | FINRA BrokerCheck Scraper | Look up broker registration data | [Link](https://apify.com/parseforge/finra-brokercheck-scraper) | | Smart Apify Actor Scraper | Scrape Apify actor metadata and quality | [Link](https://apify.com/parseforge/smart-apify-actor-scraper) | **Pro Tip:** Browse our complete collection of [data collection actors](https://apify.com/parseforge) to find the perfect tool for your needs. ### 🆘 Need Help? - Check the FAQ section above for common questions - Visit the [Apify documentation](https://docs.apify.com) for platform guides - Contact us at [Tally contact form](https://tally.so/r/BzdKgA) ### ⚠️ Disclaimer > This Actor is an independent tool and is not affiliated with, endorsed by, or connected to Charity Navigator or any nonprofit organization. It accesses only publicly available data from the Charity Navigator website. # Actor input Schema ## `searchQuery` (type: `string`): Search for charities by name or keyword (e.g., 'Red Cross', 'cancer', 'education'). ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## `cause` (type: `string`): Filter by cause category. ## `size` (type: `string`): Filter by annual revenue size. ## `state` (type: `string`): Filter by US state (2-letter code, e.g., 'CA', 'NY', 'TX'). Leave empty for all. ## `minRating` (type: `integer`): Only include charities with at least this star rating (0 = any, 1-4). ## `includeDetails` (type: `boolean`): Fetch detailed financial data, ratings breakdown, leadership info, and IRS data for each charity. Slower but much more data. ## Actor input object example ```json { "searchQuery": "Red Cross", "maxItems": 10, "minRating": 0, "includeDetails": false } ``` # Actor output Schema ## `overview` (type: `string`): Overview of charities with key fields ## `fullData` (type: `string`): Complete dataset with all scraped fields # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQuery": "Red Cross", "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/charitynavigator-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQuery": "Red Cross", "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("parseforge/charitynavigator-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQuery": "Red Cross", "maxItems": 10 }' | apify call parseforge/charitynavigator-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/charitynavigator-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Charity Navigator Nonprofit Ratings Scraper", "description": "Scrape nonprofit charity ratings and financial data from Charity Navigator. Get organization names, EIN numbers, star ratings, scores, causes, revenue, assets, and donation eligibility. Search by keyword or browse all charities. Filter by cause, size, state, and minimum rating.", "version": "1.0", "x-build-id": "SBnCFurRxgTDFJeIt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~charitynavigator-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-charitynavigator-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/parseforge~charitynavigator-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-charitynavigator-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/parseforge~charitynavigator-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-charitynavigator-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Search for charities by name or keyword (e.g., 'Red Cross', 'cancer', 'education')." }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "cause": { "title": "Cause", "enum": [ "", "Health", "Education", "Human services", "International development", "Environment", "Animals", "Arts and culture", "Community development", "Disasters and emergency management", "Research" ], "type": "string", "description": "Filter by cause category." }, "size": { "title": "Organization Size", "enum": [ "", "SMALL", "MEDIUM", "LARGE", "SUPER" ], "type": "string", "description": "Filter by annual revenue size." }, "state": { "title": "State", "type": "string", "description": "Filter by US state (2-letter code, e.g., 'CA', 'NY', 'TX'). Leave empty for all." }, "minRating": { "title": "Minimum Star Rating", "minimum": 0, "maximum": 4, "type": "integer", "description": "Only include charities with at least this star rating (0 = any, 1-4).", "default": 0 }, "includeDetails": { "title": "Include Full Details", "type": "boolean", "description": "Fetch detailed financial data, ratings breakdown, leadership info, and IRS data for each charity. Slower but much more data.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```