Search PubMed
Search PubMed's 38M+ biomedical citations with PubMed's own query syntax (fields such as [mh], [au], [ta], boolean operators) plus filters: author, journal, publication type, free full text, has abstract, language and a date range on publication, entry or modification date; sort by relevance, newest, author, journal or title. Each result has PMID, title, authors, journal, dates, volume, issue, pages, languages, publication types, DOI, PMCID and PMC citation count. Pass next_page back as page (first 10,000 results).
Every response includes credits_used: the credits this call cost.
Parameters
| name | type | description |
|---|---|---|
q | string | Search words or a PubMed query (e.g. asthma[mh] AND children). Example: crispr gene therapy |
author | string | Author name (e.g. Doudna JA). |
journal | string | Journal title or abbreviation (e.g. Nature, N Engl J Med). |
type | review | systematic_review | meta_analysis | clinical_trial | randomized_controlled_trial | case_report | editorial | letter | comment | guideline | practice_guideline | observational_study | journal_article | preprint | news | book | retracted | retraction | Publication type. |
free_full_text | boolean | Only articles with free full text. |
has_abstract | boolean | Only articles with an abstract. |
language | string | Article language in English (e.g. english, french, german). |
from | string | Start date: YYYY, YYYY-MM or YYYY-MM-DD. |
to | string | End date: YYYY, YYYY-MM or YYYY-MM-DD. |
date_type | pdat | edat | mdat | Which date from/to apply to (default pdat publication; edat added to PubMed; mdat modified). |
sort | relevance | newest | author | journal | title | Order (default relevance). |
limit | integer | Results per page (default 20, max 100). |
page | integer | Page number (default 1). |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/pubmed/v1/search?q=crispr+gene+therapy" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/pubmed/v1/search",
params={"q": "crispr gene therapy"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/pubmed/v1/search");
url.searchParams.set("q", "crispr gene therapy");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).