Skip to main content
POST
/
api
/
pubmed
/
articles
/
search
/pubmed/articles/search
curl --request POST \
  --url https://api.anysite.io/api/pubmed/articles/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "term": "<string>",
  "count": 2,
  "timeout": 300,
  "sort": "relevance",
  "mindate": "2018",
  "maxdate": "2022",
  "datetype": "pdat"
}
'
[
  {
    "pmid": "<string>",
    "@type": "@pubmed_article",
    "doi": "<string>",
    "pmcid": "<string>",
    "pii": "<string>",
    "title": "",
    "vernacular_title": "<string>",
    "abstract": "<string>",
    "author_string": "<string>",
    "last_author": "<string>",
    "authors": [],
    "journal": {
      "@type": "@pubmed_journal",
      "title": "<string>",
      "iso_abbreviation": "<string>",
      "medline_abbreviation": "<string>",
      "nlmid": "<string>",
      "issn": "<string>",
      "essn": "<string>",
      "issn_linking": "<string>",
      "volume": "<string>",
      "issue": "<string>",
      "pages": "<string>",
      "country": "<string>",
      "pub_date": "<string>"
    },
    "pub_year": 123,
    "pub_date": "<string>",
    "epub_date": "<string>",
    "language": "<string>",
    "pub_model": "<string>",
    "publication_status": "<string>",
    "pub_types": [],
    "keywords": [],
    "mesh_headings": [],
    "chemicals": [],
    "grants": [],
    "data_banks": [],
    "coi_statement": "<string>",
    "citation_subset": "<string>",
    "history": [],
    "date_completed": "<string>",
    "date_revised": "<string>",
    "record_status": "<string>",
    "pmc_ref_count": 0,
    "web_url": ""
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
term
string
required

Search query in PubMed query syntax. Supports free text, fielded search (Smith J[Author], cancer[Title], [Affiliation], [Journal], [MeSH Terms], [Publication Type]), boolean AND/OR/NOT, and year ranges (2018:2022[PDAT])

Minimum string length: 1
Examples:

"crispr cancer"

"Iadecola C[Author] AND hypertension[Title]"

"COVID-19 AND 2020:2021[PDAT]"

​
count
integer
required

Number of articles to return

Required range: x >= 1
​
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
sort
enum<string>
default:relevance

Result ordering

Available options:
relevance,
pub_date,
Author,
JournalName,
Title
​
mindate
string | null

Start of date range (YYYY, YYYY/MM or YYYY/MM/DD); used with maxdate

Example:

"2018"

​
maxdate
string | null

End of date range (YYYY, YYYY/MM or YYYY/MM/DD); used with mindate

Example:

"2022"

​
datetype
enum<string>
default:pdat

Which date the range applies to

Available options:
pdat,
edat,
mdat

Response

Successful Response

​
pmid
string
required
​
@type
string
default:@pubmed_article
​
doi
string | null
​
pmcid
string | null
​
pii
string | null
​
title
string
default:""
​
vernacular_title
string | null
​
abstract
string | null
​
author_string
string | null
​
last_author
string | null
​
authors
PubmedAuthor · object[]
​
journal
PubmedJournal · object
​
pub_year
integer | null
​
pub_date
string | null
​
epub_date
string | null
​
language
string | null
​
pub_model
string | null
​
publication_status
string | null
​
pub_types
string[]
​
keywords
string[]
​
mesh_headings
PubmedMeshHeading · object[]
​
chemicals
PubmedChemical · object[]
​
grants
PubmedGrant · object[]
​
data_banks
PubmedDataBank · object[]
​
coi_statement
string | null
​
citation_subset
string | null
​
history
PubmedHistoryEvent · object[]
​
date_completed
string | null
​
date_revised
string | null
​
record_status
string | null
​
pmc_ref_count
integer
default:0
​
web_url
string
default:""