Tools (5)

search_projects
get_project
get_publications
get_funding_trends
report_feedback

search_projects

Search NIH-funded research projects across all NIH institutes.

Covers 2.9M+ projects with $50B+/year in funding. Includes project details,
principal investigators, award amounts, and abstracts. Data from NIH RePORTER.

Args:
query: Search term for project titles, abstracts, and terms.
fiscal_years: Fiscal years to filter by.
org_names: Organization names to filter by.
pi_name: Principal investigator name to filter by.
activity_codes: NIH activity codes to filter by.
limit: Number of results (1–50, default 20).

Returns:
List of matching projects with title, PI, organization, funding amount, and abstract excerpt.
Use project_num with get_project or get_publications for more details.

Parameter	Type	Required	Description
`query`	`string`	required	Search term for NIH-funded projects (e.g. "cancer immunotherapy", "CRISPR gene editing", "Alzheimer biomarkers").
`fiscal_years`	`any`	optional	Fiscal years to filter by (e.g. [2023, 2024]). Omit for all years.
`org_names`	`any`	optional	Organization names to filter by (e.g. ["Harvard", "MIT"]).
`pi_name`	`any`	optional	Principal investigator name to filter by.
`activity_codes`	`any`	optional	NIH activity codes (e.g. ["R01", "R21", "U01"]). R01=standard research, R21=exploratory, K=career development, U=cooperative agreement, P=program project.
`limit`	`integer`	optional	Number of results (1–50, default 20). (default: 20)

Request Body

{
  "query": "example"
}

get_project

Get detailed information about a specific NIH-funded project.

Returns the full project record including abstract, investigators, funding,
dates, and MeSH terms. Use the project_num from search_projects results.

Args:
project_num: NIH project number.

Returns:
Project details with abstract, investigators, organization, funding amount,
activity dates, and research terms. Returns found=false if project not found.

Parameter	Type	Required	Description
`project_num`	`string`	required	NIH project number (e.g. "R01CA227622", "5R01AI123456-03"). Found in search_projects results.

Request Body

{
  "project_num": "123456789"
}

get_publications

Get PubMed publications linked to an NIH-funded project.

Returns PubMed IDs (PMIDs) for papers that acknowledged NIH funding from the
specified project. Use PMIDs with PubMed for full paper details.

Args:
project_num: NIH core project number.
limit: Number of results (1–50, default 20).

Returns:
List of PubMed IDs linked to the project. Use with pubmed server for full paper details.

Parameter	Type	Required	Description
`project_num`	`string`	required	NIH core project number (e.g. "R01CA227622"). Found in search_projects results.
`limit`	`integer`	optional	Number of results (1–50, default 20). (default: 20)

Request Body

{
  "project_num": "123456789"
}

get_funding_trends

Track NIH funding trends for a research topic across fiscal years.

Shows how many projects were funded and total sampled award amounts for each year.
Useful for understanding research funding priorities and growth areas.

Args:
query: Research topic to track.
fiscal_years: Fiscal years to compare.

Returns:
Per-year project counts and sampled funding totals. Note: funding totals are
based on up to 500 sampled projects per year, not exhaustive sums.

Parameter	Type	Required	Description
`query`	`string`	required	Research topic to track funding for (e.g. "machine learning", "mRNA vaccines", "climate health").
`fiscal_years`	`list[integer]`	required	Fiscal years to compare (e.g. [2020, 2021, 2022, 2023, 2024]). Minimum 1, maximum 20.

Request Body

{
  "query": "example",
  "fiscal_years": [
    1
  ]
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

Request Body

{
  "feedback": "example"
}

Quick Start

Shell

curl -X POST "https://context.gnist.ai/rest/nih-reporter/search_projects" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"query": "example"}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/rest/nih-reporter/search_projects",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={
  "query": "example"
},
)
print(resp.json())