ParseForge Scrapers

Unofficial GuideStar / ProPublica Nonprofit Scraper

parseforge/guidestar-scraper

Developer toolsOther

Access detailed nonprofit data from ProPublica's Nonprofit Explorer. For grant researchers, fundraising teams, and due diligence professionals who need accurate nonprofit financials without manual lookup. Unofficial tool, not affiliated with or endorsed by Candid, GuideStar, or ProPublica, Inc.

Run this scraper See the API call
Total users
20
Monthly active
0
Total runs
259
Bookmarked
0
Rating
Not rated yet
Last modified
12 days ago

Overview

ParseForge

GuideStar / ProPublica Nonprofit Scraper

Scrape nonprofit profiles from GuideStar and ProPublica by keyword, state, or NTEE category, up to a million per run. Every organization returns its EIN, revenue, assets, filing history, and GuideStar profile link. No login or API key. Export to CSV, JSON, Excel, or XML.

ProPublica's Nonprofit Explorer is the largest public database of IRS Form 990 filings, but searching it manually or through its API requires navigating rate limits and pagination. This Actor reads the public profiles directly, filtered by location, classification, revenue, assets, and filing status, and returns each match in one fixed schema.

Who uses it What they scrape GuideStar / ProPublica for
Grant makers and foundations Find nonprofits by mission area and financial size to identify potential grantees.
Nonprofit researchers Analyze the financial health and filing compliance of organizations in a specific sector or region.
Fundraising consultants Build prospect lists of organizations with recent 990 filings and stable revenue.
Journalists and investigators Scrape public charity data for stories on nonprofit spending, executive compensation, or sector trends.

What it does

This Actor collects nonprofit profiles from GuideStar and ProPublica by keyword, state, city, NTEE category, 501(c) subsection, revenue range, asset range, and filing year, and returns each one as a flat row.

  • ๐Ÿ” Keyword search: Enter an organization name, alternate name, or city to find specific nonprofits.
  • ๐Ÿ“ Location filters: Narrow results by two-letter state code and city name.
  • ๐Ÿ“‚ Classification filters: Filter by NTEE category (Arts, Education, Health, etc.) and 501(c) subsection (charitable, social welfare, etc.).
  • ๐Ÿ’ฐ Financial filters: Set minimum and maximum annual revenue and total assets to target organizations of a specific size.
  • ๐Ÿ“… Filing filters: Require a recent Form 990 filing (within 3 years) or a minimum filing year.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

What you can do with GuideStar / ProPublica data

๐Ÿ“Š Build a grant prospect list.

A foundation filters by NTEE category B (Education) and minimum revenue of $1M to find mid-sized educational nonprofits with recent filings.

๐Ÿ” Research nonprofit financial health.

A researcher collects all organizations in a state with assets over $10M and analyzes their revenue trends over time.

๐Ÿ“‹ Monitor sector compliance.

A journalist scrapes nonprofits in a city with no recent 990 filing to investigate lapsed reporting.

๐Ÿ“ˆ Identify fundraising targets.

A consultant uses location and classification filters to find human services nonprofits in a specific region for a campaign.

Why choose this scraper

What you get
EIN and IRS data Every row includes the organization's Employer Identification Number, tax-exempt status, and subsection code.
Financial metrics Annual revenue, total assets, and income from the latest Form 990 filing.
Filing history Year of most recent filing and a flag for recent 990 submissions.
GuideStar profile link Direct URL to the GuideStar profile for deeper research.
No API key needed Scrapes public ProPublica pages without registration or rate limits.

How it compares

This Actor is the only GuideStar/ProPublica scraper on Apify that combines keyword search with location, classification, financial, and filing filters in a single run.

Feature ParseForge GuideStar / ProPublica Nonprofit Scraper
Keyword search by organization name Yes Yes
Location filters (state, city) Yes Not listed
NTEE category filter Yes Not listed
501(c) subsection filter Yes Not listed
Revenue and asset range filters Yes Not listed
Recent 990 filing filter Yes Not listed
GuideStar profile link Yes Not listed

Configure the run

Drive the Actor from a keyword search, or combine location, classification, financial, and filing filters to narrow results. Filters run as each profile is read so only matches reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

{
  "maxItems": 10,
  "state": "CA",
  "nteeCategory": "B",
  "subsectionCode": "3"
}

A larger pull:

{
  "maxItems": 200,
  "state": "CA",
  "nteeCategory": "B",
  "subsectionCode": "3"
}

Pricing

Pay-per-result: $0.1 per result collected. You pay only for the results written to your dataset.

Results collected Approximate cost
100 results $10.00
1,000 results $100.00
10,000 results $1000.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

  1. Create a free Apify account with $5 in credit.
  2. Open the GuideStar / ProPublica Nonprofit Scraper.
  3. Set your inputs and any filters, then click Start.
  4. 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 GuideStar / ProPublica 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/guidestar-scraper"

Then prompt it in plain language to run the scraper and read back the results.

Troubleshooting

Why am I getting no results?

Check that your filters are not too restrictive. Try removing location or classification filters, or expanding the revenue range. Also verify the state code is two uppercase letters.

The search by name returns zero matches.

Try a broader keyword or a partial name. The search is case-insensitive but may not match exact phrases if the organization uses an alternate name.

Why are some fields empty?

Not all organizations have complete data in ProPublica. Financial fields like revenue and assets may be missing if the organization has not filed a recent 990.

The run is taking too long.

Reduce the maxItems limit or narrow your filters. Large runs over millions of records can take time due to pagination.

FAQ

Question Answer
Do I need a GuideStar or ProPublica API key? No. This Actor reads public ProPublica Nonprofit Explorer pages directly, no registration or API key required.
What data does each row contain? Each row includes the organization's EIN, name, address, NTEE category, 501(c) subsection, annual revenue, total assets, most recent filing year, and a link to its GuideStar profile.
Can I search by organization name? Yes. Enter a keyword in the searchQuery field to find organizations by name, alternate name, or city.
How do I filter by state? Enter a two-letter US state code (e.g., CA, TX, NY) in the state field. Leave empty for all states.
What is an NTEE category? The National Taxonomy of Exempt Entities classifies nonprofits by mission. Common codes include A (Arts), B (Education), C (Environment), E (Health), and P (Human Services).
What does the 'Has Recent 990 Filing' filter do? When enabled, it returns only organizations that filed a Form 990 within the last three years.
Can I set a minimum or maximum revenue? Yes. Use the minRevenue and maxRevenue fields to filter by annual revenue in USD.
How many nonprofits can I scrape in one run? Up to 1,000,000. Set the maxItems field to your desired limit.
What is a 501(c) subsection? It indicates the specific IRS tax-exempt classification. Common values: 3 for charitable, 4 for social welfare, 5 for labor/agricultural.
Does this scrape GuideStar directly? It scrapes ProPublica's Nonprofit Explorer, which aggregates IRS 990 data and includes links to GuideStar profiles.

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 ProPublica, Inc. 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

FieldTypeWhat it doesDefault
searchQuery string Keyword search for organization name, alternate name, or city. Leave empty to search all organizations using letter-based enumeration for maximum coverage. not set
maxItems integer Maximum number of nonprofits to collect per run. 10
state string Two-letter US state code (e.g., CA, TX, NY, FL, IL, PA, OH, GA, NC, MI). Leave empty for all states. CA
city string City name to filter results (e.g., New York, Los Angeles, Chicago). Leave empty for all cities. not set
nteeCategory string (27 options) National Taxonomy category letter (A-Z). Examples: A=Arts, B=Education, C=Environment, D=Animal, E=Health, P=Human Services. Leave empty for all categories. B
subsectionCode string (12 options) Tax-exempt subsection. Common values: 3=Charitable, 4=Social Welfare, 5=Labor/Agricultural, 6=Business Leagues, 7=Social/Recreational. 3
minRevenue integer Minimum annual revenue in USD. Filter organizations by revenue size. Leave empty for no minimum. not set
maxRevenue integer Maximum annual revenue in USD. Filter organizations by revenue size. Leave empty for no maximum. not set
minAssets integer Minimum total assets in USD. Filter organizations by asset size. Leave empty for no minimum. not set
maxAssets integer Maximum total assets in USD. Filter organizations by asset size. Leave empty for no maximum. not set
hasRecentFiling boolean Filter to only include organizations with recent Form 990 filings (within last 3 years). false
minFilingYear integer Minimum year of most recent filing (e.g., 2020). Leave empty for no minimum. not set

Pricing

from $1.00 per 1,000 results

Charged forWhat it isPrice each
Actor Start Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event). $0.05 to $0.1
result Single result in the default dataset. $0.001 to $0.019

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.

POST ยท run and get results
curl -X POST "https://api.apify.com/v2/acts/parseforge~guidestar-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "helloWorld": 123
  }'

Examples

Input that runs as-is.

input.json
{
  "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.

Related scrapers

Run Unofficial GuideStar / ProPublica Nonprofit Scraper on Apify All scrapers