Skip to main content
POST
Searches PubMed, the US National Library of Medicine’s index of biomedical papers, newest or most relevant first: title, journal, dates, first three authors, DOI, PubMed Central id, publication types and link. Only citation fields are returned, never an abstract or full text. The answer lists what a public index holds: it is for research and is not medical advice.

​
Authentication

Requires x402 payment in the payment-signature header.

​
Request Body

​
string
required
PubMed search text, for example semaglutide AND kidney; field tags such as [Title] or [MeSH Terms] and AND/OR/NOT are allowed. 2 to 300 characters.
​
integer
Only papers published in this year or later, no later than the current year. At least 1800.
​
integer
Only papers published in this year or earlier, no later than the current year. At least 1800.
​
string
newest (by publication date) or relevance. One of newest, relevance. Defaults to "newest".
​
integer
The most papers to return. From 1 to 20. Defaults to 10.

​
Response (200 OK)

Top-level envelope: success (boolean) and data (object). All fields below are nested under data.
​
string
Durable job ID for audit and lookup
​
string
Job status: completed
​
string
Always record_publications_find
​
object
The answer, described under Result below
​
object
Where the answer came from and when
​
string
The public body the data comes from. Always US National Library of Medicine (PubMed).
​
string
public when the data comes from a public body, commercial otherwise
​
string
When the lookup was made, as an ISO 8601 UTC time
​
string | null
The newest published date among the papers returned; null when nothing matched.

​
Result

Nested under data.result.
​
integer
How many papers matched, including any beyond limit.
​
string
The search as the source expanded and ran it, for example with MeSH terms and the year range.
​
object[]
The papers returned, in the order asked for.
​
string
The PubMed id.
​
string | null
The title. null when the source gives no value.
​
string | null
The journal’s abbreviated name; null for a book chapter.
​
string | null
The journal’s full name. null when the source gives no value.
​
string | null
The publication date the source sorts by, as YYYY-MM-DD. null when the source gives no value.
​
string | null
The publication date as the source prints it, for example “2026 Dec 1” or “2026 Dec”. null when the source gives no value.
​
string[]
The first three author names, as the source abbreviates them; book editors listed on a chapter are not authors and are left out.
​
integer
How many authors the paper has.
​
string | null
The DOI; null when the source lists none.
​
string | null
The PubMed Central id; null when the paper is not in PubMed Central.
​
string[]
The publication types, for example “Journal Article” or “Meta-Analysis”.
​
string
The paper’s page on PubMed.
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers 200.

​
Notes

  • total is how many papers matched in all, including any beyond limit, and is 0 when none did. query_translation shows how the source expanded the search (MeSH terms, plurals, the year range).
  • Field tags such as [Title] or [MeSH Terms] and AND, OR and NOT are passed to the source as written.
  • Give from_year, to_year or both to keep papers published in those years; one alone is open on the other side.
  • sort is newest (by publication date, the default) or relevance. Each paper also gives its author count.
  • Registered studies are in record_clinical_trials_find; the papers NCBI links to one gene are in gene_publications.
  • Results return inline. The finished job stays available at /v1/requests/{request_id}