# Changelog of PubMed KOL Profile Builder — Medical Affairs Edition (`azureblue/pubmed-kol-profile-builder`) Actor

- **URL**: https://apify.com/azureblue/pubmed-kol-profile-builder/changelog.md
- **Full Actor documentation**: https://apify.com/azureblue/pubmed-kol-profile-builder.md

## Changelog — PubMed KOL Profile Builder

All notable changes following [Keep a Changelog](https://keepachangelog.com/).

### \[1.0.0] — 2026-05-12

#### Added

- Initial public release on the Apify Store.
- PubMed E-utilities pipeline: `esearch` for indication × time window → `efetch` in 100-PMID batches → composite KOL scoring.
- Composite KOL score: recency-weighted publication volume + log-scaled total citations + log-scaled co-author breadth + log-scaled journal diversity.
- Country filter (best-effort affiliation parsing, 24 countries supported).
- Three modes: `delta` (rental tier — fires `monthly-access` charge once/month), `snapshot` (one-shot full ranking), `trial` (5 profiles free).
- Optional HMAC-signed webhook delivery per ranked profile with dead-letter queue.
- Unified `azureblue/medical-core` envelope (`scrapedAt`, `sourceUrl`, `sourceDomain`, `actorVersion`, `dataHash`) for join compatibility with all sister azureblue Actors.

#### Pricing

- PAY_PER_EVENT: `monthly-access` $149/month + `dataset-item` $0.05/profile.

#### Known limitations

- `totalCitations` defaults to 0 — Europe PMC citation-count enrichment is queued for v1.1. Ranking accuracy unaffected (recency-volume + co-author breadth + journal diversity carry the signal).
- Author canonicalisation is the literal PubMed `LastName F` format — does not currently merge spelling variants (Smith J vs J Smith vs Smith JE).
- Country is parsed from the most recent affiliation string with a 24-country regex list; ~80% recall on records with a country token.