Gov Grants Federal Scraper

Scrape federal grant opportunities from Grants.gov — the official U.S. government portal listing thousands of federal funding opportunities from agencies like NIH, NSF, DOE, USDA, and more.

Uses the official Grants.gov v1 public API. No login, no API key, no proxy required.

---

Features

• Search grants by keyword (e.g. "education", "climate change", "biomedical")
• Filter by category — 25+ categories including Health, Education, Energy, Agriculture, Science & Technology
• Filter by agency — narrow to specific agencies like NIH, NSF, USDA, HHS
• Filter by status — posted (open), forecasted (upcoming), closed, or archived
• Get grant details by opportunity ID — full synopsis, deadlines, funding amounts
• Full metadata — award ceiling/floor, CFDA numbers, total program funding, eligibility, deadline

---

Input Parameters

Parameter	Type	Description	Default
mode	Select	searchGrants or getGrantDetails	searchGrants
keyword	String	Search keyword for searchGrants mode	"education"
category	Select	Filter by category code (ED, HL, AG, ENV, etc.)	All
agency	String	Filter by agency code or name (e.g. HHS, NASA)	—
oppStatus	Select	posted, forecasted, closed, archived	posted
opportunityIds	Array	List of opportunity IDs for getGrantDetails mode	—
maxItems	Integer	Maximum records to return (1–1000)	50

---

Output Fields

Each record contains:

Field	Type	Description
opportunityId	String	Grants.gov opportunity ID
opportunityNumber	String	Official grant number (e.g. NIH-NIMH-2024-001)
opportunityTitle	String	Grant opportunity title
agencyCode	String	Agency code (e.g. HHS, USDA)
agencyName	String	Full agency name
opportunityCategory	String	Category code (e.g. HL, ED)
opportunityCategoryLabel	String	Category label (e.g. Health, Education)
fundingInstrumentType	String	Funding instrument (G=Grant, CA=Cooperative Agreement, etc.)
opportunityStatus	String	Current status: posted, forecasted, closed, archived
postDate	String	Date opportunity was posted
applicationDeadline	String	Application close date
lastUpdatedDate	String	Last modification date
awardCeiling	Integer	Maximum award amount in USD
awardFloor	Integer	Minimum award amount in USD
estimatedTotalProgramFunding	Integer	Total estimated program funding in USD
expectedNumberOfAwards	Integer	Expected number of awards
cfdaNumbers	Array	CFDA (Assistance Listings) numbers
description	String	Grant synopsis / description
eligibleApplicants	String	Who is eligible to apply
moreInfoUrl	String	Direct link to Grants.gov opportunity page
scrapedAt	String	ISO 8601 timestamp of when the record was scraped

---

Supported Categories

Code	Category
ED	Education
HL	Health
AG	Agriculture
AR	Arts
EN	Energy
ENV	Environment
ST	Science and Technology
T	Transportation
HR	Housing
HU	Humanities
MH	Mental Health
FN	Food and Nutrition
LJL	Law, Justice and Legal Services
ISS	Income Security and Social Services
BC	Business and Commerce
...and more	See input schema for full list

---

Example Use Cases

Search for education grants

{
  "mode": "searchGrants",
  "keyword": "education",
  "oppStatus": "posted",
  "maxItems": 50
}

Search for health research grants

{
  "mode": "searchGrants",
  "keyword": "clinical research",
  "category": "HL",
  "maxItems": 100
}

Find NASA grants

{
  "mode": "searchGrants",
  "agency": "NASA",
  "oppStatus": "posted",
  "maxItems": 50
}

Get details for specific opportunities

{
  "mode": "getGrantDetails",
  "opportunityIds": ["12345678", "87654321"]
}

Browse upcoming (forecasted) energy grants

{
  "mode": "searchGrants",
  "category": "EN",
  "oppStatus": "forecasted",
  "maxItems": 50
}

---

Data Source

Data is fetched from the Grants.gov official API (api.grants.gov/v1), which is the U.S. federal government's centralized platform for grant information. The API is publicly accessible without authentication.

Grants.gov is managed by the U.S. Department of Health and Human Services (HHS) on behalf of federal grant-making agencies.

---

FAQs

Does this require an API key? No. The Grants.gov API is publicly accessible without registration or authentication.

How many grants can I scrape? Up to 1,000 per run. Grants.gov typically has 5,000–10,000 active opportunities at any time.

What is a CFDA number? A Catalog of Federal Domestic Assistance (CFDA) number is a unique identifier for federal assistance programs. It's now called the Assistance Listings number.

What's the difference between posted and forecasted?

• posted — The opportunity is currently accepting applications
• forecasted — The opportunity is expected to be posted in the future

Can I filter by multiple agencies? Currently the scraper supports a single agency text filter. Search for a broad keyword and filter results afterward for multiple agencies.

How often is the data updated? Grants.gov is updated daily by federal agencies. Run the scraper daily to capture new and updated opportunities.