Search Grants.gov Opportunities
grantsgov_search_opportunitiesRead-onlyIdempotent
Search federal funding opportunities on Grants.gov by keyword, agency, applicant eligibility, funding category, funding instrument, assistance listing, opportunity number, posting window (posted_within_days), or closing window (closing_within_days). Returns forecasted and posted opportunities unless statuses says otherwise, each row led by its close date and days remaining, plus facet counts for narrowing. Bare keyword terms are all required; join alternatives with OR, in parentheses when other terms stay required. Rows carry no award amounts or eligibility detail; read those with grantsgov_get_opportunity. Filter codes come from grantsgov_list_reference.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Result order: relevance (best keyword match; needs keyword, otherwise the order is arbitrary), open_date_desc/open_date_asc (posting date), close_date_asc/close_date_desc (close date; no close date sorts last on asc), opportunity_number_asc/_desc, agency_asc/_desc. Default: relevance with a keyword, else open_date_desc. | |
| limit | No | Requested rows per page (1-1,000; default 25). Values above 100 return 100 rows with a notice. | |
| offset | No | Zero-based row offset for paging; use next_offset from the previous page. | |
| keyword | No | Full-text search over title, description, opportunity number, and agency. Bare terms are all required (rural broadband = rural AND broadband); join alternatives with OR, quote phrases ("mental health"), exclude with NOT or -term, and use a trailing * for prefixes (broad*). OR mixed with AND or with bare terms must be grouped in parentheses, e.g. (rural OR tribal) broadband; an ungrouped mix is rejected. A word with an internal hyphen or period (COVID-19, K-12) is matched as a phrase. Field prefixes (agency:NSF, cfda:93.866) are rejected: use the agencies, assistance_listing, or other filter instead. See grantsgov_list_reference topic keyword_syntax. | |
| agencies | No | Agency codes from grantsgov_list_reference topic agencies (e.g. HHS, HHS-NIH11, NSF). One whole string or an array, up to 10 nonblank entries. A code includes its sub-agencies. Case-insensitive. Any listed agency matches. | |
| statuses | No | Lifecycle statuses to include: forecasted, posted, closed, archived. One whole string or an array, up to 4 nonblank entries. Default: forecasted and posted. | |
| eligibilities | No | Two-digit applicant-type codes from grantsgov_list_reference topic eligibilities (e.g. 12 = nonprofits with 501(c)(3) status, 07 = federally recognized tribal governments). One whole string or an array of strings or numbers, up to 17 nonblank entries. A single digit is zero-padded (7 = 07). Any listed type matches. | |
| include_facets | No | Include facet counts per filter value. Set false when paging to save space. | |
| assistance_listing | No | One assistance listing number (ALN, formerly CFDA), e.g. 93.866 or 93866, in any case. Only one value is supported. | |
| funding_categories | No | Funding category codes from grantsgov_list_reference topic funding_categories (e.g. HL = Health, ED = Education). One whole string or an array, up to 28 nonblank entries. Case-insensitive. Any listed category matches. | |
| opportunity_number | No | Exact agency-assigned opportunity number (e.g. HRSA-27-005), matched case-insensitively; one pair of surrounding double quotes is removed. Numbers are not unique across agencies, so several rows can match. To look up a number across every status, prefer grantsgov_get_opportunity with opportunity_numbers. | |
| posted_within_days | No | Only opportunities posted in the last N days (1-3650). Works only with the forecasted and posted statuses. | |
| closing_within_days | No | Only posted opportunities closing between today and N days from today, US Eastern (0-365; 0 = closing today). Searches posted opportunities in close-date order, so statuses may only be posted and sort only close_date_asc. | |
| funding_instruments | No | Funding instruments: G (grant), CA (cooperative agreement), PC (procurement contract), O (other). One whole string or an array, up to 4 nonblank entries. Any listed instrument matches. | |
| include_unrestricted | No | When eligibilities is set, also match opportunities open to any applicant type (code 99), which the specific codes do not cover. Set false to see only opportunities targeted at the listed types. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The limit applied. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Rows returned on this page. | |
| facets | No | Counts per filter value for the current filters. Omitted when include_facets is false. | |
| notice | No | Zero-hit or window guidance naming the next call. | |
| truncated | No | True when more scanned matches remain after this page or a closing-window scan is incomplete, including on an empty page. | |
| totalCount | No | Matching opportunities counted. In closing_within_days mode, total_count_kind says whether this is exact or a lower bound. | |
| next_offset | No | Offset for the next reachable page of scanned matches; absent when none remain, even if the closing-window scan is incomplete. | |
| opportunities | No | Matching opportunities, deadline first. | |
| applied_filters | No | Filters as the server applied them, including defaults and expansions. | |
| reference_cache | No | Degraded reference-cache provenance when a filter uses stale vocabulary. | |
| total_count_kind | No | Closing-window count precision: exact after exhaustion or an observed boundary; lower_bound when unscanned rows may still qualify. Omitted in other modes. | |
| effective_keyword | No | The keyword as compiled and sent upstream. |