`, and a `statusCode`. Duplicate EINs are skipped.
Export the resulting dataset as JSON, CSV, or Excel from the Apify run.
### Output Fields
| Field | Type | Description |
|---|---|---|
| `ein` | integer | Organization EIN as an integer. |
| `einFormatted` | string | EIN formatted as `XX-XXXXXXX`, preserving leading zeros. |
| `name` | string | Organization name. |
| `city` | string | Organization city. |
| `state` | string | State or location code. |
| `nteeCode` | string | National Taxonomy of Exempt Entities code. |
| `subsectionCode` | integer | Applicable tax-exemption subsection code. |
| `revenueAmount` | integer | Revenue amount from the Business Master File. |
| `assetAmount` | integer | Asset amount from the Business Master File. |
| `latestFiling` | object | Latest filing's available financial totals and PDF link. |
| `filings` | array | Newest filings with financial information. |
| `pdfOnlyFilings` | array | Filing years for which only a PDF is available. |
| `latestTotalRevenue` | number | Revenue from the latest filing, when available. |
| `latestPdfUrl` | string | PDF link for the latest filing, when available. |
| `dataSource` | string | Source attribution included with each row. |
| `error` | string | Error information for failed inputs. |
| `statusCode` | integer | HTTP status code when available for a failed lookup. |
Some fields are mode-dependent and may be absent or null when the underlying record does not contain the relevant information.
### How It Works
1. **Searches by state:** Builds separate searches for the selected states and applies the configured organization filters.
2. **Retrieves result pages:** Processes available pages without exceeding the supported pagination range.
3. **Enriches financial records:** In financial modes, retrieves additional organization details and filing information for each new EIN.
4. **Normalizes filing data:** Sorts filings by tax period and maps form codes to `990`, `990-EZ`, or `990-PF`.
5. **Handles request failures:** Applies delays between requests and backs off when rate limits or server errors occur.
6. **Removes duplicate EINs:** Skips repeated organizations to reduce duplicate records.
7. **Exports the results:** Makes collected data available in JSON, CSV, and Excel formats.
#### Pagination and Search Limits
A single search can return a maximum of 10,000 organizations. When that limit is reached, the search may be truncated.
To explore more organizations, narrow the search using a state, NTEE major group, or 501(c) subsection. Pagination errors are recorded, and the affected search is stopped rather than continuing beyond the supported range.
### Data Sources, Limits, and Attribution
The dataset combines nonprofit organization and financial information associated with:
- ProPublica Nonprofit Explorer
- IRS Exempt Organizations Business Master File (EO BMF)
- IRS Statistics of Income (SOI) annual extract
Important limitations:
- The free run limit is 5,000 organizations.
- The actor uses a default delay of 500 milliseconds between requests, with a minimum configurable delay of 250 milliseconds.
- Requests are processed sequentially, and retry delays are applied to HTTP 429 and 5xx responses.
- A single search cannot return more than 10,000 organizations.
- Form 990-N e-postcard filers are not included in this database.
- Financial summaries can reflect processed IRS data years, while newer filing information may be available only as a PDF.
- Financial fields missing from a filing are not guessed or fabricated.
- Form 990 PDF files are not downloaded; available links are stored in the dataset.
When publishing findings, credit the relevant data sources, including ProPublica Nonprofit Explorer and the IRS. Follow the applicable source terms governing attribution, reuse, and redistribution. In particular, review restrictions on republishing raw datasets, charging for access to the data, or reselling it.
### FAQ
#### What is an EIN?
An Employer Identification Number (EIN) is the IRS identification number assigned to an organization. You can provide it with or without a dash, such as `14-2007220` or `142007220`.
The output includes `einFormatted` to preserve the nine-digit format and leading zeros, so `01-0191203` remains correctly formatted.
#### What is an NTEE code?
The National Taxonomy of Exempt Entities (NTEE) classifies nonprofit organizations by purpose and activity.
The major-group filter covers categories such as arts, education, environment and animals, health, human services, international affairs, public benefit, religion, mutual benefit, and unknown or unclassified organizations. The output may contain a more specific code, such as `A20` or `K31`.
#### What is the difference between Form 990, Form 990-EZ, and Form 990-PF?
- **Form 990:** The standard annual information return for many tax-exempt organizations.
- **Form 990-EZ:** A shorter annual return for eligible smaller organizations. Some financial fields may be unavailable.
- **Form 990-PF:** The annual return used by private foundations.
The actor uses these labels in `formType` and does not invent figures for fields that a filing leaves blank.
#### Why do I see fewer than 10,000 results?
A single search is limited to 10,000 organizations, corresponding to the supported pagination range. Narrow your search by state, NTEE group, or 501(c) subsection to retrieve a more targeted dataset.
#### Does the actor download Form 990 PDFs?
No. It stores available PDF links in the output rather than downloading the documents.
#### Why do some organizations have missing financial fields?
Financial information depends on the available source records and filing type. Some records contain summary figures only, and some filings omit particular fields. Missing values are left unavailable rather than estimated.
### Trademark Notice
ProPublica and related names, logos, and trademarks belong to their respective owners. Their use in this documentation is solely to identify the data source and does not imply affiliation, sponsorship, endorsement, or partnership.
### Disclaimer
This actor is an independent tool and is not affiliated with, endorsed by, sponsored by, or officially associated with ProPublica.
### Is Web Scraping Legal?
Collecting information that is already public is generally legal. Scraping is not the same thing as hacking, and there is no single law that bans it. The limits are the usual ones: do not break into accounts, do not take private or confidential data, and be careful with personal data and copyrighted works. A site's terms can also restrict how you access it. Facts such as a public name, price, or rating are not the same thing as republishing someone's article or photo.
This actor collects information from public pages. It does not log in and it does not bypass access controls.
# Actor input Schema
## `mode` (type: `string`):
search returns organization summaries. search_with_financials adds Form 990 figures with one extra request per EIN. organizations looks up EINs you already have.
## `query` (type: `string`):
Name or keyword search. Supports "exact phrase", +required, and -excluded words. The default match is OR.
## `states` (type: `array`):
One search per state. Use a two-letter USPS code. ZZ means outside the US.
## `nteeCategory` (type: `string`):
National Taxonomy of Exempt Entities major group. Leave on Any to skip this filter.
## `subsectionCode` (type: `string`):
IRS subsection code. 3 means 501(c)(3) charities. 92 means 4947(a)(1). Leave blank for every subsection.
## `eins` (type: `array`):
Employer Identification Numbers for organizations mode, with or without a dash. Example: 14-2007220.
## `filingsToInclude` (type: `integer`):
How many Form 990 filings with financials to keep per organization, newest first. PDF-only filings are still listed separately.
## `includeAllFinancialFields` (type: `boolean`):
When on, each filing also keeps the raw IRS element names ProPublica returned. Reserved schema names are stored under an irs-prefixed alias.
## `minRevenue` (type: `integer`):
Drop organizations whose latest Form 990 total revenue is below this amount. Used in search_with_financials and organizations. Ignored in search.
## `maxItems` (type: `integer`):
Free cap of 5,000 organizations per run. One search returns at most 10,000 results (400 pages of 25).
## `requestDelayMs` (type: `integer`):
Pause between API calls. The default is 500 ms, about 2 requests per second. Requests run one at a time.
## `timeoutSecs` (type: `integer`):
Stop the run after this many seconds and keep the rows already saved.
## `requestTimeoutSecs` (type: `integer`):
How long to wait for a single ProPublica response before retrying.
## `proxyConfiguration` (type: `object`):
Optional proxy for API requests. Leave Apify Proxy off. The actor stays near 2 requests per second without a proxy.
## Actor input object example
```json
{
"mode": "search",
"query": "food bank",
"nteeCategory": "",
"subsectionCode": "",
"filingsToInclude": 3,
"includeAllFinancialFields": false,
"maxItems": 100,
"requestDelayMs": 500,
"timeoutSecs": 300,
"requestTimeoutSecs": 30,
"proxyConfiguration": {
"useApifyProxy": false
}
}
```
# Actor output Schema
## `overview` (type: `string`):
Name, city, state, NTEE code, revenue, latest Form 990 revenue, and PDF link.
## `errors` (type: `string`):
EINs and searches that failed, with the error code and HTTP status.
## `dataset` (type: `string`):
Every organization and error row from the run, without a table view applied.
# 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 = {
"query": "food bank",
"proxyConfiguration": {
"useApifyProxy": false
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("zerobreak/nonprofit-explorer-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 = {
"query": "food bank",
"proxyConfiguration": { "useApifyProxy": False },
}
# Run the Actor and wait for it to finish
run = client.actor("zerobreak/nonprofit-explorer-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"query": "food bank",
"proxyConfiguration": {
"useApifyProxy": false
}
}' |
apify call zerobreak/nonprofit-explorer-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"type": "http",
"url": "https://mcp.apify.com/?tools=fetch-actor-details,zerobreak/nonprofit-explorer-scraper"
}
}
}
```
The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).
## OpenAPI specification
Download the OpenAPI definition: https://api.apify.com/v2/actors/uqNVEez8IO7cfccyS/builds/emWclVcgddXdbGXxa/openapi.json