Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaHealthAvailable now

NIH RePORTER · Search projects

reporter-nih-gov/research-grants/search_projects

Get health and medical data with NIH RePORTER · Search projects from Alexandria through one Spiral API key. Find NIH grants for a topic, a researcher or an institution; get appl_id for project and core_project_num for publications. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

Pricing

$0.00873 per call.

Limits

Runs
In the background
Returns
json
Longest queue wait
1 hour
Run deadline
5 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
sortone of
relevance, award_amount, fiscal_year, project_start_date, project_end_date
relevance

sort

texttext—

Words searched in project titles, abstracts and RCDC terms. All words must match by default; wrap a phrase in double quotes for an exact match.

limitnumber
1 to 50
10

Projects per page.

offsetnumber
0 to 14999
0

Rows to skip; pass next_offset from the previous page with the same criteria. RePORTER pages no further than offset 14,999.

pi_nametext—

Principal investigator name, partial match on any name part, e.g. "Seung K Kim" or "Attardi".

agencieslist—

Administering or funding institute/agency abbreviations, e.g. ["NCI", "NIGMS", "AHRQ"].

org_nametext—

Funded organization name; RePORTER matches it as a prefix/wildcard ("Stanford" also matches "Stanford Research Institute") unless org_name_exact is true.

org_stateslist—

Organization state or territory codes, e.g. ["CA", "MA"].

sort_orderone of
asc, desc
desc

Applies to every sort except relevance.

text_fieldslist—

Limit the text search to these fields (default all three). Requires text.

fiscal_yearslist—

Federal fiscal years of the award records, e.g. [2024, 2025].

pi_profile_idnumber
1 to …
—

RePORTER PI profile id from a previous result: every project of exactly that investigator.

text_operatorone of
and, or, advanced
and

How text words combine: and (all words), or (any word), advanced (RePORTER boolean syntax). Requires text.

activity_codeslist—

NIH activity codes, e.g. ["R01", "R21", "P01"].

org_name_exacttrue or false—

Match org_name exactly as RePORTER spells it, e.g. "STANFORD UNIVERSITY". Requires org_name.

exclude_subprojectstrue or false—

Drop the component subprojects of multi-project awards (P01, U54, ...) and keep their parent records.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "reporter-nih-gov/research-grants/search_projects",
    "input": {
      "sort": "relevance"
    }
  }'

Frequently asked questions

How much does NIH RePORTER · Search projects cost?

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use NIH RePORTER · Search projects through an API?

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "reporter-nih-gov/research-grants/search_projects"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with Alexandria to use NIH RePORTER · Search projects?

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

Can my AI agent use NIH RePORTER · Search projects?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.