# NIH RePORTER · 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.

- Provider: Alexandria
- Category: Health
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `reporter-nih-gov/research-grants/search_projects`
- Page: https://spiral.ai/tools/alexandria/reporter-nih-gov/research-grants/search_projects

## Pricing

$0.00873 per call.

## Limits

- 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

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `sort` | one of | relevance, award_amount, fiscal_year, project_start_date, project_end_date | relevance | sort |
| `text` | text |  | — | 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. |
| `limit` | number | 1 to 50 | 10 | Projects per page. |
| `offset` | number | 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_name` | text |  | — | Principal investigator name, partial match on any name part, e.g. "Seung K Kim" or "Attardi". |
| `agencies` | list |  | — | Administering or funding institute/agency abbreviations, e.g. ["NCI", "NIGMS", "AHRQ"]. |
| `org_name` | text |  | — | Funded organization name; RePORTER matches it as a prefix/wildcard ("Stanford" also matches "Stanford Research Institute") unless org_name_exact is true. |
| `org_states` | list |  | — | Organization state or territory codes, e.g. ["CA", "MA"]. |
| `sort_order` | one of | asc, desc | desc | Applies to every sort except relevance. |
| `text_fields` | list |  | — | Limit the text search to these fields (default all three). Requires text. |
| `fiscal_years` | list |  | — | Federal fiscal years of the award records, e.g. [2024, 2025]. |
| `pi_profile_id` | number | 1 to … | — | RePORTER PI profile id from a previous result: every project of exactly that investigator. |
| `text_operator` | one of | and, or, advanced | and | How text words combine: and (all words), or (any word), advanced (RePORTER boolean syntax). Requires text. |
| `activity_codes` | list |  | — | NIH activity codes, e.g. ["R01", "R21", "P01"]. |
| `org_name_exact` | true or false |  | — | Match org_name exactly as RePORTER spells it, e.g. "STANFORD UNIVERSITY". Requires org_name. |
| `exclude_subprojects` | true or false |  | — | Drop the component subprojects of multi-project awards (P01, U54, ...) and keep their parent records. |

## Example

```bash
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"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=reporter-nih-gov%2Fresearch-grants%2Fsearch_projects

## Common questions

### NIH RePORTER · Search projects

**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.

