NIH RePORTER Funding Landscape Report

Research funding teams enter topic, institution, fiscal-year, agency, activity-code, or project-number watches. The Actor queries the official NIH RePORTER v2 Project API and keeps an isolated per-watch baseline. It returns source-linked award-change alerts, funding landscape reports, and compact exports; the baseline and unchanged checks emit zero rows and zero charges.

Store Quickstart

The first scheduled run should use baseline_only. It records the current public project snapshots without charging a row.

{
  "watches": [
    {
      "id": "oncology-r01",
      "terms": ["immunotherapy", "oncology"],
      "fiscalYears": [2025, 2026],
      "activityCodes": ["R01"]
    }
  ],
  "monitorKey": "oncology-r01-watch",
  "initialRunMode": "baseline_only",
  "generateReport": true,
  "emitRawRows": false,
  "emitExport": false,
  "emitUnchanged": false,
  "maxProjectsPerWatch": 50,
  "maxChargeUsd": 25,
  "dryRun": false
}

After the baseline, run the same input on a schedule. Only new or changed public award records produce alert/report/export rows. An unchanged run always produces zero dataset rows and zero PPE charges, even when emitUnchanged is true.

Run the next report

Use a narrow watch and emit_backfill when you explicitly want the current matching records and a funding landscape report immediately.

{
  "watches": [
    {
      "id": "rare-disease-portfolio",
      "terms": ["rare disease"],
      "institutions": ["Example Research Institute"],
      "fiscalYears": [2026]
    }
  ],
  "monitorKey": "rare-disease-report-2026",
  "initialRunMode": "emit_backfill",
  "generateReport": true,
  "emitRawRows": false,
  "emitExport": true,
  "maxProjectsPerWatch": 20,
  "maxChargeUsd": 25,
  "dryRun": false
}

Input examples

Institution and activity portfolio

{
  "watches": [
    {
      "id": "university-u01",
      "institutions": ["Example University"],
      "activityCodes": ["U01", "P01"],
      "fiscalYears": [2024, 2025, 2026]
    }
  ],
  "monitorKey": "university-u01",
  "initialRunMode": "baseline_only",
  "generateReport": true,
  "maxProjectsPerWatch": 50,
  "maxChargeUsd": 25,
  "dryRun": false
}

Agency and topic watch

{
  "watches": [
    {
      "id": "nci-cell-therapy",
      "terms": ["cell therapy"],
      "agencies": ["NCI"],
      "activityCodes": ["R01", "R35"],
      "includeActiveProjects": true
    }
  ],
  "monitorKey": "nci-cell-therapy",
  "initialRunMode": "baseline_only",
  "generateReport": true,
  "emitExport": false,
  "maxProjectsPerWatch": 50,
  "maxChargeUsd": 25,
  "dryRun": false
}

Changed-record report and export

{
  "watches": [
    {
      "id": "brain-r01",
      "terms": ["brain imaging"],
      "fiscalYears": [2026],
      "activityCodes": ["R01"]
    }
  ],
  "monitorKey": "brain-r01",
  "initialRunMode": "baseline_only",
  "generateReport": true,
  "emitRawRows": true,
  "emitExport": true,
  "emitUnchanged": false,
  "maxProjectsPerWatch": 25,
  "maxChargeUsd": 25,
  "dryRun": false
}

Sample output

See docs/sample-output.json for representative award, alert, report, and export rows. The sample is illustrative and is not a live NIH result.

A report includes the matched project count, new/changed counts, observed award amount totals, fiscal-year distribution, organization distribution, activity-code distribution, agency distribution, and the official source URL. Project records intentionally contain descriptive public funding fields only.

Pricing

Event	Price	Delivered when
nih-award-row	$0.005	Optional normalized public award row for a new or changed observation
nih-funding-change-alert	$0.20	A new or changed award snapshot is detected
nih-funding-landscape-report	$12.00	A selected change set is summarized into a landscape report
nih-funding-export	$8.00	A selected change set is packaged as a compact export

The Actor estimates every configured event before the first push. If the estimate exceeds maxChargeUsd, it stops before delivery. A baseline or unchanged run has zero rows and zero charge.

Data source and safeguards

• Source: NIH RePORTER v2 Project API.
• Requests are sequential and spaced at least one second apart.
• Every request uses a limit no greater than 500; the default per-watch limit is 50.
• State is isolated by monitorKey and caller identity. A state read or write failure stops the run and does not mark the monitor successful.
• The output excludes investigator identity and direct communication fields. It is not a directory or prospecting tool.
• Records are observations of public NIH data. They are not financial, medical, clinical, legal, grant-writing, award-probability, or institutional-performance advice.
• No NIH, HHS, or agency endorsement is implied.

See also

• PubMed Research Intelligence for publication metadata and saved-query literature updates.
• OpenAlex Research Intelligence for broader scholarly metadata analysis.
• Government Tender & Grants Alert Report for public opportunity monitoring.

Development

npm test
npm start

The Store package includes a reviewed 1024x1024 RGB thumbnail with no text, agency logo, or official seal.