IRS Exempt Organizations Scraper
parseforge/irs-eo-master-file-scraper
OtherLead generation
Scrapes the IRS Exempt Organizations Master File by state and optional subsection code. Returns each organization as a flat row with EIN, name, and status.
- Total users
- 1
- Monthly active
- 0
- Total runs
- 96
- Bookmarked
- 0
- Rating
- Not rated yet
- Last modified
- 12 days ago
Overview
IRS Exempt Organizations Scraper
Scrape the IRS Exempt Organizations Master File for every tax-exempt organization in any US state or territory. Each row includes the organization name, EIN, subsection code, and filing status, ready for CSV, JSON, Excel, or XML export.
The IRS publishes the Exempt Organizations Master File as bulk data, but the raw files are split by state and hard to query. This Actor reads the public master file directly, filters by state and subsection code, and returns each organization as one flat row. No API key, no registration, no rate limits.
| Who uses it | What they scrape IRS Exempt Organizations Master File for |
|---|---|
| Nonprofit researchers | Build a complete list of 501(c)(3) organizations in a state for a landscape study. |
| Grantmakers | Identify new nonprofits in a region that match a funding priority. |
| Sales teams | Generate leads of tax-exempt organizations that may need software or services. |
| Data journalists | Analyze the distribution of nonprofit types across states or subsections. |
| Compliance officers | Verify an organization's tax-exempt status and subsection code. |
What it does
This Actor collects tax-exempt organizations from the IRS Exempt Organizations Master File by state and optional subsection code, and returns each one as a flat row.
- πΊοΈ State selector: Pick any US state or territory, from AL to WY, including DC and PR.
- π’ Subsection filter: Narrow results to a specific 501(c) subsection, like 03 for public charities.
- π Flat rows: Every organization comes back as one record with its name, EIN, and status.
- β‘ Bulk export: Download up to a million organizations per run in CSV, JSON, Excel, or XML.
Results export to CSV, JSON, Excel, or XML, or straight from the API.
What you can do with IRS Exempt Organizations Master File data
π Build a nonprofit prospect list.
A grantmaker runs the Actor for California with subsection 03 to get every 501(c)(3) in the state, then filters by name and EIN to shortlist new grantees.
πΊοΈ Map the nonprofit landscape.
A researcher collects all exempt organizations in Texas and groups them by subsection to see the mix of charities, social clubs, and business leagues.
π§Ύ Verify tax-exempt status.
A compliance officer enters a state and subsection to confirm an organization's EIN and filing status before approving a donation or contract.
π Feed a data pipeline.
A data engineer schedules the Actor to pull the latest master file for New York each month and loads the flat rows into a warehouse for trend analysis.
Why choose this scraper
| What you get | |
|---|---|
| No API key | Reads the public IRS master file directly, so you skip registration and rate limits. |
| State by state | Collect every exempt organization in a state, or focus on one subsection like 501(c)(3). |
| Clean schema | Each organization is a flat row with consistent fields, ready for analysis or CRM import. |
| Scales to a million | Set maxItems up to 1,000,000 to pull a full state file in one run. |
How it compares
No other Store actor targets IRS Exempt Organizations Master File the same way, so the honest comparison is with the alternatives teams actually weigh.
| IRS Exempt Organizations Scraper | Build it in-house | By hand | |
|---|---|---|---|
| Setup | Run it now, zero config | Days of engineering | None, but hours per pull |
| When IRS Exempt Organizations Master File changes | Maintained for you | You fix it | You re-learn the page |
| Proxies, retries, anti-bot | Built in | Your problem | Browser only |
| Output | Fixed JSON schema, CSV/Excel export | Whatever you build | Copy-paste |
| Cost | Pay per result | Engineering time | Analyst hours |
Configure the run
Drive the Actor with a two-letter state code and an optional subsection filter, and set a maximum number of organizations to collect per run. The Input tab lists every parameter.
A first run with the defaults:
{
"maxItems": 10
}
A larger pull:
{
"maxItems": 200
}
Pricing
Pay-per-result: $0.021 per result collected. You pay only for the results written to your dataset.
| Results collected | Approximate cost |
|---|---|
| 100 results | $2.10 |
| 1,000 results | $21.00 |
| 10,000 results | $210.00 |
New Apify accounts start with $5 in free credit.
Free users
Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.
Run it
- Create a free Apify account with $5 in credit.
- Open the IRS Exempt Organizations Scraper.
- Set your inputs and any filters, then click Start.
- Export the results as CSV, Excel, JSON, or XML from the Dataset tab.
Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.
Use with AI agents (MCP)
Give an AI agent live access to IRS Exempt Organizations Master File through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:
claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/irs-eo-master-file-scraper"
Then prompt it in plain language to run the scraper and read back the results.
Troubleshooting
Why am I getting no results?
Check your subsection filter. If you entered a code that does not exist in that state, the Actor returns nothing. Try leaving the subsection blank to see all organizations.
The run is slow or times out.
Lower the maxItems value. Pulling a full state file with a million organizations can take time. Start with a smaller number and increase as needed.
I see duplicate organizations.
The master file should not contain duplicates, but if you see any, deduplicate on the EIN field in your downstream process.
The state dropdown is empty.
Make sure you are using the latest version of the Actor. The state list is fixed and includes all US states and territories.
Can I get organizations by city or ZIP code?
No, this Actor filters by state and subsection only. For geographic detail, you would need a different data source or post-process the results with address data.
FAQ
| Question | Answer |
|---|---|
| What is the IRS Exempt Organizations Master File? | It is the official IRS list of organizations that have been recognized as tax-exempt. It includes the organization name, EIN, subsection code, and other details. |
| Do I need an IRS API key? | No. This Actor reads the public master file data directly, so there is no registration or key required. |
| Can I filter by subsection code? | Yes. Enter a subsection code like 03 for 501(c)(3) organizations, or leave it blank to get all subsections in the state. |
| Which states are supported? | All 50 states, the District of Columbia, and Puerto Rico. Pick from the dropdown in the input. |
| How many organizations can I get in one run? | You can set maxItems up to 1,000,000. The default is 10 for quick tests. |
| What format is the output? | Each organization is a flat row in the dataset. You can export to CSV, JSON, Excel, or XML from the Apify platform. |
| Does this include Form 990 data? | No, this Actor returns the master file listing, not the detailed financial data from Form 990 filings. For 990 data, look for a dedicated 990 scraper. |
| Can I get organizations from multiple states at once? | This Actor takes one state per run. To cover multiple states, run it once per state or use a scheduler. |
| Is the data current? | The Actor reads the latest master file available from the IRS at the time of the run. The IRS updates the file periodically. |
| What is an EIN? | An Employer Identification Number is a unique nine-digit number the IRS assigns to organizations for tax purposes. It is included in each row. |
Related actors
Browse the full ParseForge collection for more scrapers.
π Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.
β οΈ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Internal Revenue Service. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.
Input
| Field | Type | What it does | Default |
|---|---|---|---|
| state | string (52 options) | Two-letter US state/territory code (e.g. CA, DC, PR). Defaults to DC for fast tests. | DC |
| maxItems | integer | How many organizations to collect per run. | 10 |
| subsection | string | Optional. Filter by IRS subsection code (e.g. 03 for 501(c)(3)). Leave blank for all. | not set |
Pricing
from $19.00 per 1,000 results
| Charged for | What it is | Price each |
|---|---|---|
| result | Single result in the default dataset. | $0.019 to $0.021 |
Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.
API
One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.
curl -X POST "https://api.apify.com/v2/acts/parseforge~irs-eo-master-file-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"helloWorld": 123
}' Examples
Input that runs as-is.
{
"helloWorld": 123
} Reviews
No reviews yet. Be the first.
Issues
We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.
Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.
