PubMed Literature Watch & Research Report

Biomedical research, evidence, and research-operations teams enter PubMed queries or PMIDs. The first-run value path returns a source-linked literature report and optional citation export, with recurring new-publication alerts afterward. Outputs are descriptive citation metadata from official NCBI E-utilities, not medical conclusions or treatment guidance. This independent Actor is not affiliated with, sponsored by, or endorsed by NCBI or PubMed.

Store Quickstart

{
  "searchTerms": ["cancer immunotherapy"],
  "fromDate": "2026",
  "sort": "most_recent",
  "maxResultsPerQuery": 25,
  "maxArticles": 25,
  "runMode": "audit",
  "emitRawRows": false,
  "generateReport": true,
  "generateExport": true,
  "maxChargeUsd": 7,
  "dryRun": false
}

This report-first example is the buyer deliverable: a grouped literature update plus a citation-metadata export. Set runMode to monitor for a recurring alert workflow after the initial report. With the configured prices, a non-empty report plus export plans $7.00 total ($2.00 + $5.00); a query with no matches emits no value rows and creates no value-event charge. The matching starter and full-report files are available in docs/starter-sample-output.json and docs/full-report-input.json.

Low-cost starter path

Use docs/full-report-input.json when the goal is the full report/export deliverable. For a low-cost first signal, use the monitor starter below instead of trying to force the $2.00 report event under a $1.00 cap:

{
  "searchTerms": ["machine learning healthcare"],
  "sort": "most_recent",
  "maxResultsPerQuery": 10,
  "maxArticles": 10,
  "runMode": "monitor",
  "monitorKey": "starter-machine-learning-healthcare",
  "initialRunMode": "emit_backfill",
  "emitRawRows": false,
  "generateReport": false,
  "generateExport": false,
  "maxChargeUsd": 0.30,
  "dryRun": false
}

This starter can emit up to ten new-publication-alert rows at the configured $0.03 each, for a maximum planned value charge of $0.30. An unchanged follow-up poll emits zero rows and zero charges. It is a discovery signal, not a literature report or medical recommendation.

Run the next report

• Start broad discovery with OpenAlex Research Intelligence, then confirm a focused PubMed query.
• Compare the related award landscape with NIH RePORTER Funding Landscape Report.

Input examples

Current literature report

{
  "searchTerms": ["GLP-1 obesity"],
  "fromDate": "2025",
  "maxResultsPerQuery": 25,
  "maxArticles": 50,
  "runMode": "audit",
  "emitRawRows": false,
  "generateReport": true,
  "dryRun": false
}

PMID metadata export

{
  "pmids": ["39763750", "39763800"],
  "runMode": "extract",
  "emitRawRows": true,
  "generateReport": false,
  "generateExport": true,
  "dryRun": false
}

Use raw extraction only when an integration explicitly needs article, author, or journal metadata rows. Raw rows use the configured $0.004 dataset event; they are not the report-first value path.

New-publication monitor

{
  "searchTerms": ["CAR-T solid tumor"],
  "sort": "most_recent",
  "maxArticles": 100,
  "runMode": "monitor",
  "monitorKey": "car-t-solid-tumor-watch",
  "initialRunMode": "baseline_only",
  "emitRawRows": false,
  "generateReport": true,
  "generateExport": false,
  "dryRun": false
}

The first baseline-only monitor emits no rows. Later runs emit only newly observed PMIDs; an unchanged run writes zero rows and creates zero charges.

Sample output

{
  "rowType": "literature_update_report",
  "billingEventName": "literature-update-report",
  "query": {
    "searchTerms": ["cancer immunotherapy"],
    "fromDate": "2026"
  },
  "articleCount": 12,
  "pmids": ["39763750", "39763800"],
  "topJournals": [{"value": "Cancer Research", "count": 3}],
  "summary": "12 PubMed publications matched this literature update.",
  "sourceUrl": "https://pubmed.ncbi.nlm.nih.gov/"
}

An export uses the same matched citations in a reusable citations array. A monitor run adds one new-publication-alert for each newly observed PMID; the first baseline_only run and an unchanged run emit zero rows and zero charges.

Pricing

Event	Price	Emitted when
apify-default-dataset-item	$0.004	A citation, author, or journal metadata row is requested
new-publication-alert	$0.03	A saved monitor observes a new PMID
literature-update-report	$2.00	A non-empty literature report is generated
systematic-review-export	$5.00	A citation metadata export is generated

There is no start charge. The default input is report-first (audit, raw rows off, report and export on). Use maxChargeUsd to cap the complete planned delivery: if the cap is too low, no rows are delivered and monitor state is not committed. A monitor baseline-only run and an unchanged monitor poll both cost $0.00.

Source and limits

• Uses official NCBI ESearch and ESummary JSON endpoints; no browser scraping or login is required.
• An optional free NCBI API key increases the documented request allowance. Keyless mode is paced conservatively.
• This Actor exports citation metadata, not article full text or abstracts.
• PubMed records can be incomplete or updated after publication.

Compliance

Outputs support literature research and screening workflows. They are not medical advice, clinical efficacy claims, or a substitute for reviewing the source publication. Keep NCBI attribution and source URLs in downstream reports. PubMed and NCBI are public data sources used by this independent Actor; they do not sponsor, approve, or endorse it.