# NIH RePORTER Funding Landscape Report (`taroyamada/nih-research-funding-landscape-report`) Actor Monitor official NIH RePORTER awards by topic, institution, fiscal year, agency, and activity code. Receive source-linked funding change alerts, landscape reports, and exports from public award data. Baseline and unchanged checks are free. - **URL**: https://apify.com/taroyamada/nih-research-funding-landscape-report.md - **Developed by:** [naoki anzai](https://apify.com/taroyamada) (community) - **Categories:** Business, Education - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 nih award rows This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 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. ```json { "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. ```json { "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 ```json { "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 ```json { "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 ```json { "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`](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](https://api.reporter.nih.gov/?urls.primaryName=V2.0). - 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](https://apify.com/taroyamada/pubmed-research-intelligence) for publication metadata and saved-query literature updates. - [OpenAlex Research Intelligence](https://apify.com/taroyamada/openalex-research-intelligence) for broader scholarly metadata analysis. - [Government Tender & Grants Alert Report](https://apify.com/taroyamada/government-tender-grants-monitor) for public opportunity monitoring. ### Development ```text npm test npm start ``` The Store package includes a reviewed 1024x1024 RGB thumbnail with no text, agency logo, or official seal. # Actor input Schema ## `watches` (type: `array`): One or more bounded searches by terms, institutions, fiscal years, activity codes, agencies, or project numbers. ## `monitorKey` (type: `string`): Stable isolated state namespace for a recurring saved funding watch. ## `initialRunMode` (type: `string`): baseline\_only stores the first observation with zero rows; emit\_backfill emits the current matching records for an explicit first report. ## `generateReport` (type: `boolean`): Generate one aggregate landscape report only when new or changed observations are emitted. ## `emitRawRows` (type: `boolean`): Emit one normalized NIH award observation for each new or changed project. Raw rows are the low-priced event. ## `emitExport` (type: `boolean`): Generate a compact JSON-ready project export when new or changed observations are emitted. ## `emitUnchanged` (type: `boolean`): Accepted for compatibility, but unchanged monitoring observations always remain zero rows and zero charge for billing safety. ## `maxProjectsPerWatch` (type: `integer`): Maximum records collected per watch. The NIH API request limit is never greater than 500. ## `maxChargeUsd` (type: `number`): Fail closed before pushing any row if the planned PPE charges exceed this cap. ## `dryRun` (type: `boolean`): Return representative event rows without calling NIH, saving state, or charging PPE events. ## Actor input object example ```json { "watches": [ { "id": "oncology-immunotherapy", "terms": [ "immunotherapy", "oncology" ], "fiscalYears": [ 2025, 2026 ], "activityCodes": [ "R01" ] } ], "monitorKey": "nih-funding-watch", "initialRunMode": "baseline_only", "generateReport": true, "emitRawRows": false, "emitExport": false, "emitUnchanged": false, "maxProjectsPerWatch": 50, "maxChargeUsd": 25, "dryRun": false } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "watches": [ { "id": "oncology-immunotherapy", "terms": [ "immunotherapy", "oncology" ], "fiscalYears": [ 2025, 2026 ], "activityCodes": [ "R01" ] } ] }; // Run the Actor and wait for it to finish const run = await client.actor("taroyamada/nih-research-funding-landscape-report").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "watches": [{ "id": "oncology-immunotherapy", "terms": [ "immunotherapy", "oncology", ], "fiscalYears": [ 2025, 2026, ], "activityCodes": ["R01"], }] } # Run the Actor and wait for it to finish run = client.actor("taroyamada/nih-research-funding-landscape-report").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "watches": [ { "id": "oncology-immunotherapy", "terms": [ "immunotherapy", "oncology" ], "fiscalYears": [ 2025, 2026 ], "activityCodes": [ "R01" ] } ] }' | apify call taroyamada/nih-research-funding-landscape-report --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=taroyamada/nih-research-funding-landscape-report", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "NIH RePORTER Funding Landscape Report", "description": "Monitor official NIH RePORTER awards by topic, institution, fiscal year, agency, and activity code. Receive source-linked funding change alerts, landscape reports, and exports from public award data. Baseline and unchanged checks are free.", "version": "0.1", "x-build-id": "eiUrlabDdCpzkQN50" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/taroyamada~nih-research-funding-landscape-report/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-taroyamada-nih-research-funding-landscape-report", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/taroyamada~nih-research-funding-landscape-report/runs": { "post": { "operationId": "runs-sync-taroyamada-nih-research-funding-landscape-report", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/taroyamada~nih-research-funding-landscape-report/run-sync": { "post": { "operationId": "run-sync-taroyamada-nih-research-funding-landscape-report", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "watches" ], "properties": { "watches": { "title": "Funding watches", "type": "array", "description": "One or more bounded searches by terms, institutions, fiscal years, activity codes, agencies, or project numbers.", "items": { "type": "object", "properties": { "id": { "title": "Watch ID", "type": "string", "description": "Stable watch identifier." }, "terms": { "title": "Research terms", "type": "array", "items": { "type": "string" }, "description": "Research terms searched in project titles, terms, and abstracts." }, "institutions": { "title": "Institutions", "type": "array", "items": { "type": "string" }, "description": "Organization names or fragments." }, "fiscalYears": { "title": "Fiscal years", "type": "array", "items": { "type": "integer", "minimum": 2000, "maximum": 2100 }, "description": "NIH fiscal years." }, "activityCodes": { "title": "Activity codes", "type": "array", "items": { "type": "string" }, "description": "NIH activity codes such as R01, R35, or U01." }, "agencies": { "title": "Agencies", "type": "array", "items": { "type": "string" }, "description": "NIH administering or funding agency codes." }, "projectNumbers": { "title": "Project numbers", "type": "array", "items": { "type": "string" }, "description": "Exact or wildcard project numbers supported by RePORTER." }, "includeActiveProjects": { "title": "Include active projects", "description": "Restrict the watch to projects NIH RePORTER currently marks as active.", "type": "boolean", "default": true } }, "additionalProperties": false }, "default": [] }, "monitorKey": { "title": "Monitor key", "type": "string", "description": "Stable isolated state namespace for a recurring saved funding watch.", "default": "nih-funding-watch" }, "initialRunMode": { "title": "Initial run mode", "enum": [ "baseline_only", "emit_backfill" ], "type": "string", "description": "baseline_only stores the first observation with zero rows; emit_backfill emits the current matching records for an explicit first report.", "default": "baseline_only" }, "generateReport": { "title": "Generate funding landscape report", "type": "boolean", "description": "Generate one aggregate landscape report only when new or changed observations are emitted.", "default": true }, "emitRawRows": { "title": "Emit award rows", "type": "boolean", "description": "Emit one normalized NIH award observation for each new or changed project. Raw rows are the low-priced event.", "default": false }, "emitExport": { "title": "Generate funding export", "type": "boolean", "description": "Generate a compact JSON-ready project export when new or changed observations are emitted.", "default": false }, "emitUnchanged": { "title": "Emit unchanged observations", "type": "boolean", "description": "Accepted for compatibility, but unchanged monitoring observations always remain zero rows and zero charge for billing safety.", "default": false }, "maxProjectsPerWatch": { "title": "Maximum projects per watch", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum records collected per watch. The NIH API request limit is never greater than 500.", "default": 50 }, "maxChargeUsd": { "title": "Maximum charge USD", "minimum": 0.005, "maximum": 250, "type": "number", "description": "Fail closed before pushing any row if the planned PPE charges exceed this cap.", "default": 25 }, "dryRun": { "title": "Dry run", "type": "boolean", "description": "Return representative event rows without calling NIH, saving state, or charging PPE events.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```