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

Start with a bounded value report when you need the current funding landscape. This example returns change alerts, an aggregate report, and a compact export. For a recurring schedule, switch the same watch to baseline_only after the first report.

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

The report/export are the primary buyer deliverables; alerts provide the source-linked change detail. After this first value report, run the same input on a schedule with initialRunMode: "baseline_only". Only new or changed public award records produce rows; an unchanged run always produces zero dataset rows and zero PPE charges, even when emitUnchanged is true.

Run the next report

After the landscape report, use the buyer workflow below to connect selected projects to publication output and literature discovery.

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
}

After this award-landscape report, pass selected project numbers or linked publication identifiers to NIH Grant Publication Linkage & Output Report, then continue to PubMed Literature Watch & Research Report. On the PubMed step, generateReport: true produces the literature update and generateExport: true with emitRawRows: false produces the systematic-review screening/reference export. This is the same buyer workflow from funding landscape to publication linkage to literature evidence.

Buyer workflow

1. Start with a bounded award landscape report and export from this Actor.
2. Review selected project identifiers and public source links before extending the evidence set.
3. Continue to PubMed Literature Watch & Research Report for the literature update and systematic-review export, then widen discovery with OpenAlex Research Intelligence.

See also

• NIH Grant Publication Linkage & Output Report for public grant-to-publication linkage.
• PubMed Literature Watch & Research Report for the next literature update or systematic-review export.

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 report, export, alert, and award 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.

Development

npm test
npm start

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