bmiles PubMed Trends API
Pay-per-query research intelligence from 37M+ PubMed articles. No API keys, no subscriptions — just USDC micropayments on Base via x402.
Base URL: https://pubmed.sekgen.xyz
Companion skill: Install x402 from coinbase/agentic-wallet-skills for payment commands.
Endpoints
GET /api/v1/snapshot — $0.01
Single-year publication count. Cheapest option for quick lookups.
| Parameter | Required | Default | Description |
|---|---|---|---|
query |
Yes | — | PubMed search query |
year |
No | current year | Year to query |
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/snapshot?query=CRISPR&year=2025'
Returns count, total_pubmed, proportion (share of all PubMed articles).
GET /api/v1/trends — $0.01
Year-by-year publication counts with growth analytics over a range.
| Parameter | Required | Default | Description |
|---|---|---|---|
query |
Yes | — | PubMed search query |
start_year |
No | current - 10 | First year |
end_year |
No | current year | Last year |
source |
No | pubmed | pubmed or openalex |
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/trends?query=GLP-1+agonist&start_year=2015'
Returns yearly count, yoy_growth, plus analytics: cagr, trend_direction (growing/declining/stable/emerging), peak_year, acceleration.
GET /api/v1/compare — $0.02
Compare publication trends across 2–5 search terms. Identifies which field is growing fastest and detects crossover points.
| Parameter | Required | Default | Description |
|---|---|---|---|
terms |
Yes | — | Comma-separated search terms (2–5) |
start_year |
No | current - 10 | First year |
end_year |
No | current year | Last year |
source |
No | pubmed | pubmed or openalex |
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/compare?terms=CAR-T,bispecific+antibodies,antibody+drug+conjugate'
Returns per-term series with cagr and trend_direction, plus ranking_by_growth and crossover_years (when one term overtook another).
GET /api/v1/pulse — $0.02
Real-time publication pulse with 7d/30d/90d windows and year-over-year change.
| Parameter | Required | Default | Description |
|---|---|---|---|
query |
Yes | — | PubMed search query |
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/pulse?query=prime+editing'
Returns current and year_ago counts for 7d/30d/90d windows, plus change (fractional, e.g. 0.35 = 35% increase YoY).
GET /api/v1/keypapers — $0.03
Scored key papers for a query within a time window. Papers are ranked by a composite score based on journal prestige, publication type, MeSH relevance, and citation impact (via OpenAlex).
| Parameter | Required | Default | Description |
|---|---|---|---|
query |
Yes | — | PubMed search query |
start_year |
No | current - 5 | First year |
end_year |
No | current year | Last year |
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/keypapers?query=base+editing&start_year=2023&end_year=2025'
Returns scored papers with pmid, title, journal, pub_year, pub_type, score, score_breakdown (top_journal, review_or_trial, mesh_major_topic, multi_strategy_hit, relevance_rank, citation_impact), cited_by_count, fwci (field-weighted citation impact), open_access status, and authors_enriched (name, institution, country).
GET /api/v1/digest — $0.08
Full research digest combining scored key papers, MeSH term landscape, and frequent authors. The most comprehensive single-call endpoint.
| Parameter | Required | Default | Description |
|---|---|---|---|
query |
Yes | — | PubMed search query |
start_year |
No | current - 5 | First year |
end_year |
No | current year | Last year |
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/digest?query=NF2+schwannomatosis+treatment&start_year=2022&end_year=2025'
Returns everything from /keypapers plus mesh_terms (array of MeSH descriptors across the result set) and authors (recurring authors with appearance counts).
GET /api/v1/hottest-weekly — $0.05
Hottest topics in a category ranked by weekly spike ratio (last 7d vs 30d average). Use category for PubMed curated terms (default) or topic + source=openalex for free-text search.
| Parameter | Required | Default | Description |
|---|---|---|---|
category |
Yes* | — | See categories below |
topic |
Yes* | — | Free-text topic (when source=openalex) |
source |
No | pubmed | pubmed or openalex |
*One of category or topic required depending on source.
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/hottest-weekly?category=oncology'
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/hottest-weekly?topic=microbiome&source=openalex'
Returns topics sorted by spike_ratio. Values >1.0 mean more activity than usual this week.
GET /api/v1/emerging — $0.05
Scan a category for topics with accelerating publication rates. Use category for PubMed curated terms (default) or topic + source=openalex for free-text search.
| Parameter | Required | Default | Description |
|---|---|---|---|
category |
Yes* | — | See categories below |
topic |
Yes* | — | Free-text topic (when source=openalex) |
source |
No | pubmed | pubmed or openalex |
window_years |
No | 3 | Years to evaluate growth |
min_growth_rate |
No | 0.3 | Minimum CAGR threshold (0.3 = 30%) |
limit |
No | 10 | Max results |
*One of category or topic required depending on source.
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/emerging?category=gene+therapy&min_growth_rate=0.5'
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/emerging?topic=CRISPR&source=openalex'
Returns topics meeting the growth threshold, sorted by recent_cagr.
GET /api/v1/trending-subtopics — $0.05
Discover which sub-topics within a research field are growing fastest. Uses OpenAlex topic breakdown over a multi-year window.
| Parameter | Required | Default | Description |
|---|---|---|---|
query |
Yes | — | Research field to decompose |
window |
No | 3 | Window size in years (2–5) |
limit |
No | 10 | Max results (1–25) |
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/trending-subtopics?query=ulcerative+colitis&window=3'
Returns sub-topics with topic_id, topic_name, per-year counts, cagr, trend_direction, latest_year_count, and growth_score.
GET /api/v1/explore — $0.10
Discover interesting research signals. Two modes:
- With
topicsparam — OpenAlex multi-domain scan: searches topics, computes spike_ratio x CAGR, ranks by explore_score. - Without
topics— D1 MeSH anomaly detection: z-score anomalies from stored baselines.
| Parameter | Required | Default | Description |
|---|---|---|---|
topics |
No | — | Comma-separated research topics to scan (max 4) |
limit |
No | 5 | Max results (1–20) |
min_z_score |
No | 2.0 | Minimum z-score for anomaly mode (without topics) |
days |
No | 7 | Lookback days for anomaly mode (1–30, without topics) |
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/explore?topics=neurodegeneration,epigenetics&limit=5'
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/explore'
Returns ranked results with explore_score, spike_ratio, cagr_3y, trend_direction, and latest_year_count.
GET /api/v1/author — $0.02
Author analytics profile powered by OpenAlex. Returns citation metrics, institutional affiliation, and publication trajectory.
| Parameter | Required | Default | Description |
|---|---|---|---|
name |
Yes* | — | Author name to look up |
orcid |
Yes* | — | ORCID identifier (alternative to name) |
*One of name or orcid required.
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/author?name=David+Liu'
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/author?orcid=0000-0001-8277-943X'
Returns name, orcid, works_count, cited_by_count, h_index, i10_index, current_institution (name, country), top_topics, counts_by_year (works, cited_by per year).
POST /api/v1/feature-request — $0.01
Submit a feature request or data-source suggestion to the maintainers. The only POST endpoint. Send a JSON body. The x402 payment attributes the submission — the verified payer wallet is recorded as the submitter identity, so no separate account or auth is needed.
| Field | Required | Default | Description |
|---|---|---|---|
title |
Yes | — | Short summary (1–120 chars) |
description |
Yes | — | Full request (1–2000 chars) |
category |
No | — | One of endpoint, data, pricing, bug, other |
contact |
No | — | Optional contact string (≤200 chars) if you want a reply |
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/feature-request' --method POST --data '{"title":"Add clinical-trial phase breakdown","description":"Return publication counts split by clinical trial phase (I-IV) for a query.","category":"data"}'
Returns ok, id, and a message. Validation failures return 400 before settlement, so a rejected submission is never charged.
Categories
Used by /hottest-weekly and /emerging (PubMed mode):
- oncology — CAR-T, bispecific antibodies, ADCs, checkpoint inhibitors, liquid biopsy, KRAS inhibitors, PARP inhibitors, radiopharmaceuticals, cancer vaccines, spatial transcriptomics
- neuroscience — anti-amyloid antibodies, brain-computer interfaces, psychedelic therapy, GLP-1 neurodegeneration, antisense oligonucleotides, deep brain stimulation
- immunology — mRNA vaccines, CAR-T autoimmune, JAK inhibitors, regulatory T cells, microbiome immunotherapy, complement inhibitors
- gene therapy — CRISPR, base editing, prime editing, AAV gene therapy, lipid nanoparticle mRNA, epigenome editing, RNA interference
- cardiology — PCSK9 inhibitors, SGLT2 inhibitors, cardiac gene therapy, lipoprotein(a) inhibitors, AI cardiac imaging, wearable ECG
Free Endpoints
These do not require payment:
GET /— Service info and pricingGET /health— Health checkGET /docs— Interactive documentation (HTML, or Markdown withAccept: text/markdown)GET /llms.txt— Machine-readable documentation
Example Workflows
Quick fact check ($0.01):
"How much CRISPR research was published in 2025?"
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/snapshot?query=CRISPR&year=2025'
Technology race ($0.02):
"Is base editing overtaking traditional CRISPR?"
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/compare?terms=CRISPR+gene+editing,base+editing,prime+editing&start_year=2018'
Weekly research briefing ($0.10):
"What's spiking in oncology and neuroscience right now?"
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/hottest-weekly?category=oncology'
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/hottest-weekly?category=neuroscience'
Drug target validation ($0.03):
"Is GLP-1 for neurodegeneration actually gaining traction?"
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/trends?query=GLP-1+agonist+neurodegeneration&start_year=2018'
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/pulse?query=GLP-1+agonist+neurodegeneration'
Deep dive into a disease area ($0.13):
"What are the key papers and sub-topics for NF2 schwannoma treatment?"
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/keypapers?query=NF2+schwannoma+treatment&start_year=2022&end_year=2025'
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/trending-subtopics?query=neurofibromatosis+type+2&window=3'
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/pulse?query=NF2+schwannoma+treatment'
Full research digest ($0.08):
"Give me a comprehensive overview of NF2 schwannomatosis treatment research"
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/digest?query=NF2+schwannomatosis+treatment&start_year=2022&end_year=2025'
Author profiling ($0.02):
"Who is Scott Plotkin and what's his publication record?"
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/author?name=Scott+Plotkin'
Discovery mode ($0.10):
"What's interesting happening across neurodegeneration and epigenetics?"
awal x402 pay 'https://pubmed.sekgen.xyz/api/v1/explore?topics=neurodegeneration,epigenetics&limit=5'
Error Handling
- 402 — Payment required. Ensure you're authenticated (
awal auth login) with USDC balance. - 400 — Invalid parameters. Check required fields and constraints (max 50-year range, 2–5 terms for compare).
- 502 — Upstream NCBI error. Retry after a moment.
- 503 — Service temporarily unavailable. Retry after a moment.