SYSTEM all green source irs.gov queue 11,402 pages p99 latency 318ms dataflirt.com · scraper/irs-gov
RUN - 41 active pipelines - irs.gov live

Federal tax data,
at warehouse scale.

We extract TEOS records, Form 990 metadata, AFR tables, and tax professional directories from irs.gov. Delivered as clean JSON, CSV, or Parquet to S3, BigQuery, or Snowflake on your cadence.

Form 990s extracted
1.2M /month
AFR updates
84 /year
Preparer records
412K /run
Active pipelines
41
Uptime
99.98%
Data Dictionary

Every field we extract from irs.gov

Structured, schema-consistent data across all major object types — delivered clean, typed, and ready to query.

Complete list of extractable fields for Form 990 (TEOS) objects from irs.gov. All fields typed and schema-versioned.

einorganization_namedoing_business_ascitystatecountrytax_periodform_typeasset_amountincome_amountrevenue_amountpdf_urlfiling_date
form_990 (teos)
● 200 OK
"ein": "12-3456789",
"organization_name": "GLOBAL HEALTH INITIATIVE",
"city": "WASHINGTON",
"state": "DC",
"tax_period": "2024-12",
"form_type": "990",
"asset_amount": 14500000.0,
"pdf_url": "https://apps.irs.gov/pub/epubs/990/123456789_202412_990.pdf"
# einorganization_namedoing_business_ascitystatecountry
1
2
3

Complete list of extractable fields for Tax Professionals objects from irs.gov. All fields typed and schema-versioned.

preparer_idfirst_namelast_namecredentialscitystatezip_codedistance_milesphone_numberenrollment_statusdisciplinary_actionslast_updated
tax_professionals
● 200 OK
"first_name": "JANE",
"last_name": "DOE",
"credentials": "['Enrolled Agent', 'CPA']",
"city": "AUSTIN",
"state": "TX",
"zip_code": "78701",
"enrollment_status": "Active",
"disciplinary_actions": false
# preparer_idfirst_namelast_namecredentialscitystate
1
2
3

Complete list of extractable fields for AFR Tables objects from irs.gov. All fields typed and schema-versioned.

revenue_rulingissue_dateperiodshort_term_afrshort_term_110short_term_120mid_term_afrmid_term_110mid_term_120long_term_afrlong_term_110long_term_120section_382_ratepdf_url
afr_tables
● 200 OK
"revenue_ruling": "2025-04",
"issue_date": "2025-03-15",
"period": "April 2025",
"short_term_afr": 4.12,
"mid_term_afr": 3.98,
"long_term_afr": 4.05,
"section_382_rate": 4.15
# revenue_rulingissue_dateperiodshort_term_afrshort_term_110short_term_120
1
2
3

Complete list of extractable fields for Forms & Pubs objects from irs.gov. All fields typed and schema-versioned.

product_numbertitlerevision_datecategoryformatfile_size_kbdownload_urlhistorical_versionslanguagelast_indexed
forms_& pubs
● 200 OK
"product_number": "Form 1040",
"title": "U.S. Individual Income Tax Return",
"revision_date": "2024",
"format": "PDF",
"file_size_kb": 245,
"download_url": "https://www.irs.gov/pub/irs-pdf/f1040.pdf",
"language": "English"
# product_numbertitlerevision_datecategoryformatfile_size_kb
1
2
3

Complete list of extractable fields for News & Bulletins objects from irs.gov. All fields typed and schema-versioned.

document_numbertitlepublication_datedocument_typeabstractfull_text_urlrelated_formsinternal_revenue_code_refsauthoring_office
news_& bulletins
● 200 OK
"document_number": "IR-2025-42",
"title": "IRS announces tax relief for severe storm victims",
"publication_date": "2025-02-14",
"document_type": "News Release",
"abstract": "The Internal Revenue Service today announced tax relief for individuals and businesses affected by severe storms...",
"related_forms": "['Form 4684', 'Form 1040']",
"internal_revenue_code_refs": "['Section 165(i)']"
# document_numbertitlepublication_datedocument_typeabstractfull_text_url
1
2
3

Capabilities

Extract public tax records without the government red tape

Our irs.gov scraper navigates government WAFs, CAPTCHAs, and legacy HTML structures to extract clean, structured data from the Tax Exempt Organization Search, preparer directories, and regulatory publications.

TEOS Database Extraction

Extract Form 990 metadata, asset amounts, income figures, and PDF links for millions of tax-exempt organisations.

Tax Preparer Directory Scraping

Index the public directory of federal tax return preparers with credentials and select qualifications.

Applicable Federal Rates (AFR)

Monitor and extract monthly AFR tables, Section 382 rates, and low-income housing rates from Revenue Rulings.

IRS Forms & Publications

Track revisions to tax forms, instructions, and publications. Download PDFs and extract metadata automatically.

Internal Revenue Bulletins

Parse IRBs for new regulations, notices, announcements, and revenue procedures with cross-referenced tax codes.

Revoked Exemption Monitoring

Track organisations that have lost their tax-exempt status due to failure to file Form 990 for three consecutive years.

Regulatory Change Detection

Run continuous pipelines to detect updates in tax manuals or procedural guidelines, outputting only the diffs.

Historical Data Backfills

Extract legacy Form 990s and historical AFR tables from IRS archives to build comprehensive time-series datasets.

Scheduled Execution

Configure pipelines at monthly, weekly, or daily cadences to align with IRS publication schedules.

PDF Metadata Parsing

Extract text and form field metadata from IRS-published PDFs to normalise unstructured regulatory documents.

// engagement pipeline

From IRS portal to warehouse record

Brief in. Clean data out.

Define Scope
d 0

Specify target datasets: TEOS records by EIN list, AFR tables, or preparer directories by zip code.

Pipeline Build
d 2–4

We configure Scrapy crawlers, proxy rotation, and CAPTCHA solvers to navigate Akamai and IRS rate limits.

Validation & QA
d 4–6

Schema validation, null-rate checks, and cross-referencing against public IRS indices before launch.

Delivery
ongoing

JSON, CSV, or Parquet pushed to your S3 bucket, BigQuery dataset, or Snowflake stage on agreed cadence.

Under the hood

How our IRS pipeline handles government infrastructure

Government websites are notorious for strict WAFs, aggressive rate limiting, and legacy architectures. Here is how we ensure reliable extraction.

pipeline-monitor · irs.gov · live ● active
// fingerprinting
Identity rotation
TLS fingerprintrandomised
User-agentrotated
IP poolresidential
Challenges blocked0
// pagination
Page coverage
48,291 pages queued running
// observability
Pipeline health
99.9%
uptime
142ms
p99 lat
0.3%
null rate
2
alerts
WAF traversal
Navigating Akamai bot protection

The IRS uses enterprise WAFs that block standard datacenter IPs and headless browsers. We route requests through US-based residential proxies and apply realistic TLS fingerprints to maintain uninterrupted access.

CAPTCHA handling
Automated TEOS portal access

The Tax Exempt Organization Search requires solving CAPTCHAs for bulk queries. Our pipeline integrates automated solver APIs to process high-volume EIN lookups without manual intervention.

Legacy HTML parsing
Normalising inconsistent DOM structures

Historical IRS bulletins and older forms are hosted on legacy HTML pages with inconsistent formatting. We maintain extensive fallback selectors to normalise data across decades of changing web standards.

Rate limit management
Throttled concurrency

Government servers drop connections under heavy load. We optimise concurrency limits and implement exponential backoff retry policies to respect server capacity while meeting delivery SLAs.

Data completeness
Handling pagination limits

Public directories often restrict pagination depth. We use recursive geographic or chronological search parameters to bypass UI limits and extract the complete underlying dataset.

Applications

Who uses IRS data and how

Teams across industries use irs.gov data to build competitive products and smarter operations.

01
Non-Profit Intelligence

Philanthropic platforms aggregate Form 990 data to evaluate charity financials, executive compensation, and program efficiency.

02
Tax Software Integration

Fintech and tax preparation software ingest monthly AFR tables and updated form instructions to keep calculation engines compliant.

03
Wealth Management

Advisors analyse foundation filings and charitable contributions to identify high-net-worth individuals and corporate donors.

04
Regulatory Compliance

Corporate compliance teams track Internal Revenue Bulletins to monitor changes in tax codes and revenue procedures.

05
Academic Research

Economists and policy researchers build time-series databases of non-profit revenues and federal interest rates to study economic trends.

06
Verification Services

Background check providers query the Enrolled Agent directory to verify the credentials and disciplinary history of tax professionals.

Why DataFlirt

"The IRS publishes massive datasets on non-profits, tax preparers, and federal rates, but the interfaces are built for single queries, not bulk extraction."

Extracting data from irs.gov requires navigating strict government WAFs, solving complex CAPTCHAs on the TEOS portal, and parsing inconsistent HTML formats from historical archives. DataFlirt handles the extraction, normalisation, and delivery so your analysts can focus on tax intelligence rather than infrastructure maintenance.

Technical Spec

IRS scraper technical capabilities

Everything supported by our irs.gov scraper — rendered SPA elements, auth walls, rate-limit evasion and beyond.

Form 990 PDF download
Bulk download of Form 990 PDFs linked from TEOS search results
Supported
TEOS CAPTCHA bypass
Automated solving for Tax Exempt Organization Search queries
Supported
AFR table parsing
Extraction of structured rate tables from HTML Revenue Rulings
Supported
Preparer directory pagination
Geographic iteration to bypass 50-result display limits
Supported
Historical IRB extraction
Parsing legacy bulletin formats dating back to 1995
Supported
Government WAF traversal
US residential proxies and TLS fingerprinting to bypass Akamai
Supported
Change detection (diffs)
Hash-based diffs to identify new publications or revoked exemptions
Supported
Where's My Refund status
Requires SSN, DOB, and exact refund amount (PII restricted)
Partial
Individual tax transcripts
Requires ID.me authentication and explicit taxpayer consent
Partial
Webhook delivery
HTTP POST for immediate notification of new regulatory bulletins
Supported
Infrastructure

Infrastructure powering the IRS pipeline

Open-source tooling on proven cloud infra — no vendor lock-in, full observability.

ScrapyPlaywrightPython 3.12RedisPostgreSQLApache AirflowAWS LambdaS3CloudWatch2CaptchaCapSolverResidential ProxiesDockerKubernetesGrafanaPrometheus
Scrapy + Playwright Stack

Scrapy manages concurrency and retry logic for static document archives, while Playwright handles JavaScript execution and CAPTCHA rendering on the TEOS portal.

US Residential Proxies

Government sites aggressively block foreign and datacenter IPs. We route all irs.gov traffic through US-based residential ISP proxies to ensure consistent access.

Cloud-Native Orchestration

Pipelines run on Kubernetes with Airflow handling scheduling for monthly AFR updates and daily TEOS refreshes. State is managed in PostgreSQL.

Output & Delivery

Your data, your destination

Data delivered to where your team already works — no new tooling required.

JSON
Nested structures for complex tax professional records
CSV
Flat files ideal for AFR tables and exemption lists
XLS
Excel format for financial analysts reviewing Form 990 data
Parquet
Columnar format for ingestion into BigQuery or Snowflake
AWS S3
Direct delivery to your cloud storage buckets
Webhook
Real-time alerts for new Internal Revenue Bulletins
API
Query extracted datasets via REST endpoints
PostgreSQL
Direct database inserts for continuous directory updates
S3
Direct bucket delivery — compatible with any data lake
// faq

Common questions.

About irs.gov scraping, legality, and pipeline operations.

Ask us directly →
Is scraping irs.gov legal?

Yes. DataFlirt extracts only publicly available information such as Form 990 filings, AFR tables, and public directories. We do not access authenticated systems, bypass ID.me, or extract non-public Personally Identifiable Information (PII). Scraping public government records is generally protected, though clients should ensure their specific use case complies with relevant regulations.

How do you handle CAPTCHAs on the TEOS portal?

We integrate automated CAPTCHA solving services (CapSolver and 2Captcha) directly into our Playwright automation scripts. This allows us to process thousands of EIN lookups without manual intervention.

Can you extract data from the Form 990 PDFs?

Yes. While the primary TEOS pipeline extracts the metadata and PDF URLs, we can configure secondary processing pipelines using OCR and PDF parsing libraries to extract specific line items from the documents themselves.

How quickly are Applicable Federal Rates (AFR) updated?

The IRS typically publishes AFRs around the 20th of each month for the following month. Our pipelines can be scheduled to run daily to detect the new Revenue Ruling and extract the tables within hours of publication.

Do you provide historical IRS data?

Yes. We can configure backfill pipelines to extract historical Form 990s, past AFR tables, and legacy Internal Revenue Bulletins dating back to the earliest available records on the irs.gov archives.

Can you access individual tax transcripts?

No. Accessing individual or corporate tax transcripts requires authenticated access via ID.me and explicit taxpayer consent. DataFlirt strictly targets public, unauthenticated datasets.

What is the minimum viable engagement?

Engagements typically start with a defined extraction scope, such as monitoring a list of 10,000 EINs for Form 990 updates or a one-off scrape of the entire tax professional directory. Contact us with your specific data requirements for a quote.

$ dataflirt scope --new-project --source=irs.gov ready

Tell us what
to extract.
We do the rest.

20-minute scoping call. Pilot dataset within the week. Production within two. Whether you need a complete dump of the tax professional directory or continuous monitoring of Form 990 filings, we build and operate the infrastructure. Tell us what you need.

hello@dataflirt.com · Bengaluru · IST · typical reply < 4h
Related Scrapers

More in government and public data

Services

Data Extraction for Every Industry

View All Services →