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
TableJSON 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 | Rows per page (1-100). | |
| 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). A code includes its sub-agencies. Case-insensitive. Any listed agency matches. | |
| statuses | No | Lifecycle statuses to include: forecasted, posted, closed, archived. 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), as strings or numbers. 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). 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). 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
TableJSON 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 rows exist past this page. | |
| totalCount | No | Total matching opportunities (the closing-window count in closing_within_days mode). | |
| next_offset | No | Offset for the next page; absent on the last page. | |
| opportunities | No | Matching opportunities, deadline first. | |
| applied_filters | No | Filters as the server applied them, including defaults and expansions. | |
| effective_keyword | No | The keyword as compiled and sent upstream. |