# Grants.gov Search: US Federal Grant Opportunities (`frenchdatalab/us-federal-grants`) Actor

Every US federal grant opportunity from the official Grants.gov API: open and forecasted grants with award ceiling and floor, total funding, number of awards, eligibility, deadline and agency contact. Filter by keyword, category, eligibility, agency; weekly alerts.

- **URL**: https://apify.com/frenchdatalab/us-federal-grants.md
- **Developed by:** [French Data lab](https://apify.com/frenchdatalab) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 1,000 grant opportunities

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Grants.gov Search: US Federal Grant Opportunities

Every **US federal grant opportunity** from the official **Grants.gov** API, open and forecasted, with what matters to decide quickly: **award ceiling and floor, total funding, number of awards, eligible applicants, deadline, agency contact**.

Filter by keyword, funding category, eligible applicant type, agency, posting date, deadline or minimum award, and schedule it to get **only the new opportunities** every week.

### What can you do with it?

- 💰 **Find funding**: nonprofits, universities, cities, tribes, small businesses: *"open grants for 501(c)(3) nonprofits closing in the next 30 days"*.
- 🔔 **Weekly alerts** for grant writers and consultants: *"new health and education opportunities posted this week"*.
- 🔭 **Prepare early** with **forecasted** opportunities, announced before they open.
- 📊 **Market research**: who funds what, how much, how many awards.

### Why this Actor?

| | This Actor | Typical Grants.gov tools |
|---|---|---|
| Award ceiling and floor, total funding, number of awards | ✅ (details fetched for every opportunity) | ⚠️ search list only: title, number, dates |
| Eligibility | ✅ applicant types + eligibility text | ❌ |
| Several keywords in one run | ✅ results merged, no duplicates | ❌ one search |
| Deadline window and minimum award filters | ✅ "closing within 30 days", "at least $1M" | ❌ |
| Agencies by code or name | ✅ "HHS" covers NIH, CDC, SAMHSA, HRSA… | ⚠️ |
| Weekly monitoring | ✅ only opportunities you have not received | ❌ |
| Clean data | ✅ ISO dates, amounts as numbers, plain-text descriptions | ⚠️ |

### Input

| Field | Description | Example |
|---|---|---|
| `keywords` | One search per keyword, results merged | `["climate", "water"]` |
| `statuses` | `posted` (open), `forecasted`, `closed`, `archived` | `["posted"]` |
| `fundingCategories` | Health, Education, Environment, Science & R\&D… | `["HL", "ED"]` |
| `eligibilities` | Nonprofits, universities, small businesses, governments, tribes, individuals… | `["12"]` (501(c)(3) nonprofits) |
| `agencies` | Codes or names | `["HHS", "NSF"]` |
| `postedWithinDays` | New opportunities | `7` |
| `closingWithinDays` | Deadline within N days | `30` |
| `minAwardCeiling` | Largest award at least this amount (USD) | `1000000` |
| `includeDetails` | Amounts, eligibility, contact… (default `true`) | `true` |
| `onlyNewSinceLastRun` | Monitoring mode | `true` |
| `maxResults` | Maximum opportunities (newest first) | `200` |

### Output

Real example (shortened):

```json
{
    "opportunityId": "334326",
    "opportunityNumber": "21-595",
    "title": "Tribal Colleges and Universities Program (TCUP)",
    "agencyCode": "NSF",
    "agency": "U.S. National Science Foundation",
    "status": "posted",
    "postedDate": "2021-06-24",
    "closeDate": "2026-10-14",
    "awardCeiling": 3500000,
    "awardFloor": 100000,
    "estimatedTotalFunding": 10799836,
    "expectedAwards": 55,
    "fundingInstruments": ["Grant"],
    "url": "https://www.grants.gov/search-results-detail/334326"
}
```

Other fields: `documentType`, `assistanceListings` (CFDA numbers), `description`, `costSharing`, `fundingCategories`, `eligibleApplicants`, `eligibilityDetails`, `closeDateDescription`, `agencyContactName`, `agencyContactEmail`, `agencyContactPhone`, `additionalInfoUrl`, `lastUpdated`, `documents`.

### Notes

- Dates are converted to YYYY-MM-DD, amounts to numbers and descriptions from HTML to plain text; the content itself is not modified.
- Without details (`includeDetails: false`) a run takes seconds; with details, about 3 opportunities per second.

### Pricing

You only pay for the results returned. No subscription.

| Results | Price |
|---|---|
| 1 grant opportunity | $0.004 |
| 100 grant opportunities | $0.40 |
| 1,000 grant opportunities | $4.00 |

A start fee of a fraction of a cent applies per run. Set a **maximum cost per run** and the Actor stops exactly at your budget.

### Use it in your tools

- **No code**: run it from the Apify Console, download the results as Excel, CSV or JSON, and **schedule** it (daily, weekly…).
- **Integrations**: send the results to Google Sheets, Slack, email, webhooks, Make, Zapier or n8n with Apify's integrations.
- **API**: start runs and read the results with the Apify API or the official Python and JavaScript clients.
- **AI agents**: assistants and agents that support MCP can call this Actor as a tool through Apify's MCP server (mcp.apify.com).

### Related Actors

- [USAspending Federal Awards: Contract & Grant Winners](https://apify.com/frenchdatalab/usaspending-federal-awards): Who wins US federal contracts and grants (USAspending)
- [Federal Register Monitor: US Rules, Proposed Rules & Notices](https://apify.com/frenchdatalab/federal-register-monitor): US rules, proposed rules and notices (Federal Register)
- [Public Tenders Monitor: TED (EU) + BOAMP (France)](https://apify.com/frenchdatalab/eu-france-public-tenders): EU (TED) and French (BOAMP) public tenders, with alerts

### Source

This product uses the Grants.gov API but is not endorsed or certified by the U.S. Department of Health and Human Services.

# Actor input Schema

## `keywords` (type: `array`):

One search per keyword, results merged: e.g. "climate", "mental health", "STEM education", "small business innovation". Leave empty for all opportunities.

## `statuses` (type: `array`):

Posted = open for applications. Forecasted = announced, opening soon (prepare early).

## `fundingCategories` (type: `array`):

Leave empty for all.

## `eligibilities` (type: `array`):

Opportunities open to at least one of these applicant types. Leave empty for all.

## `agencies` (type: `array`):

Agency codes or names: "HHS" (all Health and Human Services), "HHS-NIH11", "NSF", "DOE", "National Science Foundation"…

## `postedWithinDays` (type: `integer`):

New opportunities only (e.g. 7 for a weekly alert).

## `closingWithinDays` (type: `integer`):

Opportunities whose application deadline is within the next N days.

## `minAwardCeiling` (type: `integer`):

Largest single award at least this amount (or total funding when no ceiling is published).

## `includeDetails` (type: `boolean`):

Description, award ceiling and floor, total funding, number of awards, eligibility, deadline text, agency contact, documents (one extra call per opportunity).

## `onlyNewSinceLastRun` (type: `boolean`):

Monitoring: schedule the Actor (e.g. every Monday) and receive only the opportunities you have not received yet.

## `maxResults` (type: `integer`):

Maximum number of opportunities returned (newest first).

## Actor input object example

```json
{
  "keywords": [
    "climate"
  ],
  "statuses": [
    "forecasted",
    "posted"
  ],
  "includeDetails": true,
  "onlyNewSinceLastRun": false,
  "maxResults": 30
}
```

# Actor output Schema

## `grants` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "climate"
    ],
    "maxResults": 30
};

// Run the Actor and wait for it to finish
const run = await client.actor("frenchdatalab/us-federal-grants").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keywords": ["climate"],
    "maxResults": 30,
}

# Run the Actor and wait for it to finish
run = client.actor("frenchdatalab/us-federal-grants").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "climate"
  ],
  "maxResults": 30
}' |
apify call frenchdatalab/us-federal-grants --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,frenchdatalab/us-federal-grants"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/gGfZUndB1xnYU1DT5/builds/FWtjuP4x4ZsmstVP7/openapi.json