Grants.gov Funding Opportunities

Grants.gov scraper returns federal funding opportunity records with source dates, agency data, eligibility, and available funding fields.

Grants.gov scraper uses the public source named below and writes its results to the Actor dataset.

The Actor calls the public Grants.gov search2 and fetchOpportunity APIs. No source login, API key or proxy is required. Official API guide.

What you receive

Fields vary by result type and optional enrichment. The examples below are from sample_output.json.

Output field	Type	Example value or excerpt from saved sample
opportunityId	string	"361754"
opportunityNumber	string	"PA-FPH-27-001"
title	string	"Title X Family Planning Services Grants"
agency	string	"Office of the Assistant Secretary for Health"
agencyCode	string	"HHS-OPHS"
status	string	"posted"
documentType	string	"synopsis"
opportunityCategory	string	"Discretionary"
postedDate	string	"2026-04-03"
closeDate	string	"2027-01-11"
closeDateNotes	string or null	"Applications must be submitted electronically no later than 6:00 pm Eastern Time."
archiveDate	string	"2027-07-31"
lastUpdatedDate	string	"2026-07-09"
estimatedPostDate	null	null
estimatedCloseDate	null	null
estimatedCloseDateNotes	null	null
estimatedAwardDate	null	null
estimatedProjectStartDate	null	null
awardCeiling	integer	22000000
awardFloor	integer	200000
estimatedFunding	integer	257000000
numberOfAwards	integer	90
costSharing	boolean	false
description	string	"The Office of Population Affairs (OPA) announces the anticipated availability of funds for Fiscal Y…
eligibility	array	[{"code": "12"}]
eligibilityNotes	string	"Any public or private nonprofit entity is eligible to apply."
categories	array	[{"code": "HL", "description": "Health"}]
fundingInstruments	array	[{"code": "G", "description": "Grant"}]
assistanceListingNumbers	array	["93.217"]
contactName	string	"Office of the Assistant Secretary for Health"
contactEmail	string	"Eric.West@hhs.gov"
contactPhone	string	"240-453-883"
attachments	array	[{"id": 350973}]
url	string	"https://www.grants.gov/search-results-detail/361754"
source	string	"Grants.gov"
retrievedAt	string	"2026-10-05T14:52:55.733904+00:00"
detailsIncluded	boolean	true
recordStatus	string	"ok"
errors	array	[]

One row per unique opportunity, with four dataset views for browsing results, funding, eligibility and source diagnostics. JSON results retain nested lists; export the overview view for a compact table.

Fields	Meaning
opportunityId, opportunityNumber, title	Official identifier, funding notice number and title
agency, agencyCode	Official funding agency name and exact agency code
status, documentType, opportunityCategory	Source status, synopsis/forecast type and opportunity category
postedDate, closeDate, closeDateNotes, archiveDate, lastUpdatedDate	ISO calendar dates; notes preserve source cutoff instructions
estimatedPostDate, estimatedCloseDate, estimatedCloseDateNotes, estimatedAwardDate, estimatedProjectStartDate	Anticipated dates from forecast records, kept separate from actual deadlines
awardFloor, awardCeiling, estimatedFunding, numberOfAwards, costSharing	Numeric USD funding, award count and boolean cost-sharing flag; missing values stay null
description	Synopsis or forecast text with HTML removed
eligibility, eligibilityNotes	Applicant code/description objects and extra eligibility conditions
categories, fundingInstruments, assistanceListingNumbers	Funding category/instrument code objects and ALN/CFDA strings
contactName, contactEmail, contactPhone	Public contacts published for the funding notice
attachments	Attachment metadata: id, fileName, description, mimeType, sizeBytes, folder; files are not downloaded
url, source, retrievedAt	Official opportunity page, source name and UTC retrieval timestamp
detailsIncluded, recordStatus, errors	Detail-fetch flag, ok/error outcome and an array of source/processing errors

Summary mode (includeDetails=false) keeps the search identifiers, agency, status, dates and assistance listings; detailed funding/contact/eligibility values remain absent or null. A failed detail fetch retains the search summary with recordStatus=error and an identifiable error message.

Input example

{
  "keyword": "health",
  "agencies": "HHS-NIH11",
  "categories": "HL",
  "eligibilities": "06,12",
  "status": "posted",
  "includeDetails": true,
  "maxItems": 100,
  "concurrency": 3,
  "pageSize": 50
}

Input	Default	Accepted values
keyword	Empty	Full-text query; blank browses by filters
agencies	Empty	Comma-separated exact official codes, e.g. NSF,HHS-NIH11
categories	Empty	Comma-separated category codes from the table below
eligibilities	Empty	Comma-separated applicant codes; preserve leading zeros
status	posted	posted, forecasted, closed, archived, all
includeDetails	true	Boolean; fetching details has no extra event fee
maxItems	100	Integer 1–10000; cap includes error rows
concurrency	3	Integer 1–10 for simultaneous detail requests
pageSize	50	Integer 1–100; reduced when fewer rows remain under the cap

All string inputs accept at most 500 characters. Multiple codes within a filter are combined by the source; different filter fields narrow the search together. The Actor converts comma-separated input codes to the pipe separator required by the official API. Agency filtering uses exact codes: HHS does not automatically include HHS-NIH11 or other child agencies. With status=all, results follow the source ordering and can include older closed/archived notices.

Category codes

Codes	Categories
AG, AR, BC, CD, CP	Agriculture; Arts; Business/Commerce; Community Development; Consumer Protection
DPR, ED, ELT, EN, ENV	Disaster Prevention/Relief; Education; Employment/Labor/Training; Energy; Environment
FN, HL, HO, HU, ISS	Food/Nutrition; Health; Housing; Humanities; Income Security/Social Services
IIJ, LJL, NR, OZ, O	Infrastructure Investment/Jobs Act; Law/Justice/Legal Services; Natural Resources; Opportunity Zone Benefits; Other
RT, RD, ST, T	Recreation/Tourism; Regional Development; Science/Technology/Research; Transportation

Eligibility codes

Codes	Applicants
00, 01, 02, 04, 05	State; County; City/Township; Special District governments; Independent School Districts
06, 20	Public/state-controlled universities; Private universities
07, 11	Federally recognized tribal governments; Other tribal organizations
08	Public/Indian housing authorities
12, 13	Nonprofits with 501(c)(3); Nonprofits without 501(c)(3), excluding universities
21, 22, 23	Individuals; For-profit organizations other than small businesses; Small businesses
25, 99	Other applicants (check eligibilityNotes); Unrestricted (subject to source conditions)

Output example

Actual sample projection from sample_output.json; the full rows also contain descriptions, contacts, eligibility and attachment metadata.

{
  "opportunityId": "361754",
  "opportunityNumber": "PA-FPH-27-001",
  "title": "Title X Family Planning Services Grants",
  "agency": "Office of the Assistant Secretary for Health",
  "agencyCode": "HHS-OPHS",
  "status": "posted",
  "postedDate": "2026-04-03",
  "closeDate": "2027-01-11",
  "awardFloor": 200000,
  "awardCeiling": 22000000,
  "estimatedFunding": 257000000,
  "detailsIncluded": true,
  "recordStatus": "ok",
  "errors": [],
  "url": "https://www.grants.gov/search-results-detail/361754"
}

Pricing

Proposed event opportunity: $0.000008 per successful saved opportunity ($0.008 per 1,000 events). Details are included in the same event. Duplicate IDs, error rows and results excluded by maxItems produce no custom opportunity charge. Publication and pricing activation are pending; see PRICING.md for the dated Store API comparison and configuration.

The Actor checks the available opportunity budget before searching and stops publishing when the budget is reached. Source requests already in progress may complete. Platform usage charges depend on the owner's pricing setup and are separate from this proposed event rate.

Limits and measured validation

• Temporary network errors, HTTP 408/429 and server errors receive at most three attempts with backoff; a Retry-After wait is capped at 30 seconds. Each HTTP request times out after 30 seconds.
• Search/API-wide failures fail the run with a diagnostic row. Per-opportunity detail/normalization failures produce uncharged error rows while other opportunities continue.
• 5 health/posted opportunities were saved in 3.5 seconds inside the Actor (4.172 seconds for the Python process) on this Windows machine, 2026-10-05. This is a local observation, not a cloud performance guarantee.
• 52 passed in 1.83s (unit and live API tests); the Apify input and dataset schemas passed CLI validation. Logs are in evidence/.
• Forecast dates and posted statuses can be stale in Grants.gov. A posted status does not by itself establish that a notice is accepting applications. Read deadline notes and the linked official announcement.
• The full announcement determines eligibility and application instructions. This Actor does not assess your organization's eligibility, submit applications or download attachments.
• The Docker image and actual cloud payment settlement have not been exercised. The proposed low event rate needs a cloud cost check before publication.

FAQ

What limits a search? maxItems caps all saved rows, including errors. includeDetails adds an opportunity detail request for available records.

Do I need a proxy, login, or API key? No. The actor uses the public Grants.gov read APIs without source authentication.

How is it priced? The proposed pay-per-event model charges opportunity for each successfully saved opportunity; detail enrichment is included. Error and duplicate rows have no custom event charge.

How are source limits handled? Requests use bounded concurrency and retry transient failures, including source rate responses, using Retry-After when available.

How fresh are deadlines? The actor reads Grants.gov during the run and records retrievedAt. Check status, closeDate, and any source notes before relying on a deadline.

Are forecast deadlines final? No. Forecast timing is kept in estimated date fields, separate from actual deadline fields.

Use with AI agents / MCP

After the owner publishes this Actor, connect it through Apify's MCP server. Give the agent the input schema, then ask it to search by keyword, exact agency codes, categories, eligibility and status. For example: “Find posted NIH health grants with applicant codes 06 or 12; return at most 25 opportunities with official links and deadline notes.”

Agents should distinguish estimated deadlines from actual dates, preserve null values, check recordStatus/errors and cite the official url when discussing an opportunity. Do not interpret a matching applicant code as confirmation of eligibility.

Local development

Use the existing project virtual environment; no additional packages were installed. Docker installs the two pinned dependencies in requirements.txt.

PowerShell example (from this Actor directory; prepare INPUT.json before running):

$env:APIFY_LOCAL_STORAGE_DIR = "$PWD/storage"
C:/GritWork/earn/.venv/Scripts/python -m src
C:/GritWork/earn/.venv/Scripts/python -m pytest tests -q
apify validate-schema

Put input in storage/key_value_stores/default/INPUT.json. Read result rows in storage/datasets/default/ and RUN_SUMMARY in the default key-value store. Ordinary local runs call the charge method but do not make real payments; the SDK warns that charging is inactive. The controlled local billing proofs in evidence/ enable the SDK's test mode and use no Apify cloud calls.