# Europe PMC

> Search over 45 million life-science papers, preprints and patents, and read an article's record, citations, references, linked data, text-mined genes and diseases, open-access full text and preprint reviews. Check articles for retractions, search research grants, and start a workflow when a new paper matches a search.

App · 15 actions. Web page: https://docs.lodol.com/docs/integrations/europe-pmc

## Actions

### Check for retractions

Check up to 1000 articles at once for retractions and other status updates since they were published, with the notice behind each. Handy for vetting a reference list.

**Inputs**

- Article IDs (`article_ids`, list, required): Up to 1000 articles to check: PubMed IDs, PMCIDs or preprint IDs, or SOURCE:ID such as AGR:IND606063813.

**Outputs**

- `checked` (number): Articles checked.
- `flagged` (list): Articles with a status update.
- `flagged_count` (number): How many were flagged.
- `found` (number): Of those, the ones Europe PMC knows.
- `not_found` (list): Articles Europe PMC does not know, as SOURCE:ID.
- `summary` (text): The result in one line.

**Example output**

```json
{
  "checked": 2,
  "flagged": [
    {
      "id": "28585698",
      "notices": [
        {
          "id": "40177840",
          "source": "MED",
          "type": "Retraction notice article",
          "url": "https://europepmc.org/article/MED/40177840"
        }
      ],
      "published_date": "2017-06-30",
      "source": "MED",
      "status": "Retracted",
      "statuses": [
        "RETRACTED"
      ],
      "title": "Lycopene Protects Keratinocytes Against UVB Radiation-Induced Carcinogenesis.",
      "url": "https://europepmc.org/article/MED/28585698"
    }
  ],
  "flagged_count": 1,
  "found": 2,
  "not_found": [],
  "summary": "1 of 2 articles flagged: MED:28585698 retracted"
}
```

### Count publications

Count how many publications match a search, in all and per source (PubMed, preprints, patents...), with how many are open access, have full text, are reviews or are books.

**Inputs**

- Search (`query`, text, required): Words to search for. Europe PMC's search syntax works too, such as TITLE:"gene editing" AND AUTH:"Doudna J" (see 'List search fields').
- Include synonyms (`synonyms`, true/false): Also match synonyms of the words searched for, such as 'myocardial infarction' for 'heart attack'.

**Outputs**

- `books_and_documents` (number): Those that are books or documents.
- `by_source` (list): How many come from each source.
- `full_text` (number): Those with full text in Europe PMC.
- `open_access` (number): Those that are open access.
- `query` (text): The search counted.
- `reviews` (number): Those that are reviews.
- `summary` (text): The counts in one line.
- `total` (number): Publications matching in all.

**Example output**

```json
{
  "books_and_documents": 152,
  "by_source": [
    {
      "count": 260380,
      "name": "PubMed / MEDLINE (MED)",
      "source": "MED"
    },
    {
      "count": 9856,
      "name": "Preprints (PPR)",
      "source": "PPR"
    }
  ],
  "full_text": 214536,
  "open_access": 149244,
  "query": "malaria",
  "reviews": 46678,
  "summary": "295,868 publications match 'malaria', 149,244 of them open access and 46,678 reviews",
  "total": 295868
}
```

### Find articles linking two terms

Find articles in which text mining found two terms related, such as a gene and a disease, with the sentences that relate them. Returns up to 8 articles a page.

**Inputs**

- First term (`first_term`, text, required): One of the two terms, such as a gene: BRCA1.
- Second term (`second_term`, text, required): The other term, such as a disease: breast cancer.
- Articles per page (`page_size`, number): How many articles to return, 1 to 8. Defaults to 4. From 1 to 8.
- Next page cursor (`cursor`, text): The 'next_cursor' from the previous page, to get the page after it.
- Sentences per article (`mentions_per_article`, number): How many of each article's matching sentences to include, 0 to 1000. Defaults to 5; the mention count is always the full number. From 0 to 1000.

**Outputs**

- `articles` (list): The articles, with the sentences relating the terms.
- `count` (number): Articles on this page.
- `first_term` (text): The first term.
- `next_cursor` (text): Pass as 'cursor' for the next page; blank on the last.
- `second_term` (text): The second term.

**Example output**

```json
{
  "articles": [
    {
      "id": "23216834",
      "mention_count": 1,
      "mentions": [
        {
          "after": null,
          "before": null,
          "provider": "Open Targets Platform",
          "section": "Title",
          "subtype": null,
          "tags": [
            {
              "name": "BRCA1",
              "uri": "http://purl.uniprot.org/uniprot/P38398"
            },
            {
              "name": "breast cancer",
              "uri": "http://purl.obolibrary.org/obo/MONDO_0007254"
            }
          ],
          "text": "breast cancer in patients from BRCA1",
          "type": "Gene Disease Relationship"
        }
      ],
      "pmcid": "PMC4053142",
      "source": "MED",
      "url": "https://europepmc.org/article/MED/23216834"
    }
  ],
  "count": 1,
  "first_term": "BRCA1",
  "next_cursor": "18.72295659",
  "second_term": "breast cancer"
}
```

### Find articles mentioning a term

Find articles in which text mining tagged a gene, disease, chemical or other term, with the sentences that mention it. Returns up to 8 articles a page.

**Inputs**

- Term (`term`, text, required): A gene, disease, chemical, organism or other term, as text mining tags it, such as BRCA1 or malaria.
- Articles per page (`page_size`, number): How many articles to return, 1 to 8. Defaults to 4. From 1 to 8.
- Next page cursor (`cursor`, text): The 'next_cursor' from the previous page, to get the page after it.
- Sentences per article (`mentions_per_article`, number): How many of each article's matching sentences to include, 0 to 1000. Defaults to 5; the mention count is always the full number. From 0 to 1000.

**Outputs**

- `articles` (list): The articles, with their mentions.
- `count` (number): Articles on this page.
- `next_cursor` (text): Pass as 'cursor' for the next page; blank on the last.
- `term` (text): The term searched for.

**Example output**

```json
{
  "articles": [
    {
      "id": "23216834",
      "mention_count": 1,
      "mentions": [
        {
          "after": null,
          "before": null,
          "provider": "Open Targets Platform",
          "section": "Title",
          "subtype": null,
          "tags": [
            {
              "name": "BRCA1",
              "uri": "http://purl.uniprot.org/uniprot/P38398"
            },
            {
              "name": "breast cancer",
              "uri": "http://purl.obolibrary.org/obo/MONDO_0007254"
            }
          ],
          "text": "breast cancer in patients from BRCA1",
          "type": "Gene Disease Relationship"
        }
      ],
      "pmcid": "PMC4053142",
      "source": "MED",
      "url": "https://europepmc.org/article/MED/23216834"
    }
  ],
  "count": 1,
  "next_cursor": "385.726121674",
  "term": "BRCA1"
}
```

### Get article

Get an article's full record: title, abstract, authors with ORCID iDs and affiliations, journal, MeSH terms, keywords, funding, licence, links to read it, and any retraction or erratum notices.

**Inputs**

- Source (`source`, text): The database the article is from. Leave blank to tell from the ID: digits are PubMed (MED), PMC... is PubMed Central, PPR... a preprint. One of: `MED` (PubMed / MEDLINE (MED)), `PMC` (PubMed Central (PMC)), `PPR` (Preprints (PPR)), `PAT` (Patents (PAT)), `AGR` (Agricola (AGR)), `CBA` (Chinese Biological Abstracts (CBA)), `CTX` (CiteXplore (CTX)), `ETH` (EThOS theses (ETH)), `HIR` (NHS Evidence (HIR)), `NBK` (NCBI Bookshelf (NBK)).
- Article ID (`article_id`, text, required): The article's ID in its source: a PubMed ID such as 28585529, a PMCID such as PMC5467160, or a preprint ID such as PPR842663. 'Search publications' shows each article's.

**Outputs**

- `abstract` (text): The abstract. Only in full records.
- `author_list` (list): Every author, with ORCID and affiliations.
- `authors` (text): The authors, as 'Smith J, Jones A.'.
- `cited_by_count` (number): How many publications in Europe PMC cite it.
- `corrections` (list): Retractions, errata and comments linked to it.
- `doi` (text): Its DOI, e.g. '10.1038/ncomms15708'.
- `full_text_links` (list): Where to read it.
- `grants` (list): The grants that funded it.
- `has_data_links` (true/false): True when 'Get linked data' has links for it.
- `has_full_text` (true/false): True when Europe PMC holds its full text.
- `has_lab_links` (true/false): True when 'Get Labs links' has links for it.
- `has_preprint_reviews` (true/false): True when it has published peer reviews.
- `has_references` (true/false): True when its reference list is available.
- `has_text_mined_terms` (true/false): True when it has text-mined terms.
- `id` (text): The article's ID in its source, e.g. '28585529' or 'PPR842663'.
- `indexed_date` (text): The date Europe PMC first added it, YYYY-MM-DD.
- `is_open_access` (true/false): True when it is open access.
- `issn` (text): The journal's ISSN.
- `issue` (text): The journal issue.
- `journal` (text): The journal (or book) it appeared in.
- `journal_abbreviation` (text): The journal's abbreviated title.
- `keywords` (list): The authors' keywords.
- `language` (text): The language, as a three-letter code ('eng').
- `license` (text): Its licence, e.g. 'cc by'.
- `mesh_terms` (list): Its MeSH subject headings, with qualifiers.
- `pages` (text): The pages, or article number.
- `pmcid` (text): Its PubMed Central ID (PMC...), when it has one.
- `pmid` (text): Its PubMed ID, when it has one.
- `pub_types` (list): Its publication types, e.g. 'review', 'preprint'.
- `pub_year` (text): The year it was published.
- `published_date` (text): The date it was first published, YYYY-MM-DD.
- `source` (text): The database the article is from: MED (PubMed), PMC, PPR...
- `summary` (text): One line: title, journal, year and citation count.
- `title` (text): The title.
- `url` (text): The article's page on europepmc.org.
- `volume` (text): The journal volume.

**Example output**

```json
{
  "abstract": "Rapid identification of agronomically important genes is of pivotal interest for crop breeding.",
  "author_list": [
    {
      "affiliations": [
        "CeBiTec & Faculty of Biology, Bielefeld University"
      ],
      "first_name": "D",
      "last_name": "Holtgr\u00e4we",
      "name": "Holtgr\u00e4we D",
      "orcid": "0000-0002-1062-4576"
    }
  ],
  "authors": "Capistrano-Gossmann GG, Ries D, Holtgr\u00e4we D, Kopisch-Obuch FJ.",
  "cited_by_count": 43,
  "corrections": [],
  "doi": "10.1038/ncomms15708",
  "full_text_links": [
    {
      "availability": "Open access",
      "format": "html",
      "site": "Europe_PMC",
      "url": "https://europepmc.org/articles/PMC5467160"
    }
  ],
  "grants": [],
  "has_data_links": true,
  "has_full_text": true,
  "has_lab_links": true,
  "has_preprint_reviews": false,
  "has_references": true,
  "has_text_mined_terms": true,
  "id": "28585529",
  "indexed_date": "2017-06-08",
  "is_open_access": true,
  "issn": "2041-1723",
  "issue": null,
  "journal": "Nature communications",
  "journal_abbreviation": "Nat Commun",
  "keywords": [],
  "language": "eng",
  "license": "cc by",
  "mesh_terms": [
    "Beta vulgaris / genetics",
    "Contig Mapping"
  ],
  "pages": "15708",
  "pmcid": "PMC5467160",
  "pmid": "28585529",
  "pub_types": [
    "research-article",
    "Journal Article"
  ],
  "pub_year": "2017",
  "published_date": "2017-06-06",
  "source": "MED",
  "summary": "Crop wild relative populations of Beta vulgaris allow direct mapping of agronomically important genes (Nat Commun, 2017), cited 43 times",
  "title": "Crop wild relative populations of Beta vulgaris allow direct mapping of agronomically important genes.",
  "url": "https://europepmc.org/article/MED/28585529",
  "volume": "8"
}
```

### Get full text

Get an open-access article's full text, as plain text (title, abstract, body and section headings) and as its original JATS XML. For an article that is not open access, 'available' is false and says why, rather than failing the step.

**Inputs**

- PMCID (`pmcid`, text, required): The article's PubMed Central ID, such as PMC5467160. 'Get article' and 'Search publications' show it as pmcid.

**Outputs**

- `abstract` (text): The abstract, as plain text.
- `available` (true/false): True when the full text was returned.
- `characters` (number): How long the plain text is.
- `pmcid` (text): The article's PMCID.
- `reason` (text): Why there is no full text, when there is none.
- `section_titles` (list): The body's section headings.
- `text` (text): The body as plain text: headings and paragraphs, separated by blank lines.
- `title` (text): The title.
- `url` (text): The article on europepmc.org.
- `xml` (text): The whole article as JATS XML.

**Example output**

```json
{
  "abstract": "Rapid identification of agronomically important genes...",
  "available": true,
  "characters": 43612,
  "pmcid": "PMC5467160",
  "reason": null,
  "section_titles": [
    "Results",
    "Discussion",
    "Methods"
  ],
  "text": "Crop wild relatives (CWRs) are an invaluable genetic resource...",
  "title": "Crop wild relative populations of Beta vulgaris allow direct mapping of agronomically important genes",
  "url": "https://europepmc.org/article/PMC/PMC5467160",
  "xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><article>...</article>"
}
```

### Get Labs links

Get the outside resources that link to an article through Europe PMC's Labs, such as Wikipedia pages, BioStudies records and protocols.

**Inputs**

- Source (`source`, text): The database the article is from. Leave blank to tell from the ID: digits are PubMed (MED), PMC... is PubMed Central, PPR... a preprint. One of: `MED` (PubMed / MEDLINE (MED)), `PMC` (PubMed Central (PMC)), `PPR` (Preprints (PPR)), `PAT` (Patents (PAT)), `AGR` (Agricola (AGR)), `CBA` (Chinese Biological Abstracts (CBA)), `CTX` (CiteXplore (CTX)), `ETH` (EThOS theses (ETH)), `HIR` (NHS Evidence (HIR)), `NBK` (NCBI Bookshelf (NBK)).
- Article ID (`article_id`, text, required): The article's ID in its source: a PubMed ID such as 28585529, a PMCID such as PMC5467160, or a preprint ID such as PPR842663. 'Search publications' shows each article's.

**Outputs**

- `article` (text): The article, as SOURCE:ID.
- `count` (number): Resources linking to it.
- `link_count` (number): Links in all.
- `providers` (list): The resources linking to it.

**Example output**

```json
{
  "article": "MED:28585529",
  "count": 1,
  "link_count": 1,
  "providers": [
    {
      "description": "The Free Encyclopedia",
      "link_count": 1,
      "links": [
        {
          "title": "Sugar beet",
          "url": "https://en.wikipedia.org/wiki/Sugar_beet"
        }
      ],
      "name": "Wikipedia",
      "provider_id": 1507
    }
  ]
}
```

### Get linked data

Get the data linked to an article: database records, sequences, protein structures, datasets, clinical trials and more, whether cited in the text or deposited with it.

**Inputs**

- Source (`source`, text): The database the article is from. Leave blank to tell from the ID: digits are PubMed (MED), PMC... is PubMed Central, PPR... a preprint. One of: `MED` (PubMed / MEDLINE (MED)), `PMC` (PubMed Central (PMC)), `PPR` (Preprints (PPR)), `PAT` (Patents (PAT)), `AGR` (Agricola (AGR)), `CBA` (Chinese Biological Abstracts (CBA)), `CTX` (CiteXplore (CTX)), `ETH` (EThOS theses (ETH)), `HIR` (NHS Evidence (HIR)), `NBK` (NCBI Bookshelf (NBK)).
- Article ID (`article_id`, text, required): The article's ID in its source: a PubMed ID such as 28585529, a PMCID such as PMC5467160, or a preprint ID such as PPR842663. 'Search publications' shows each article's.
- Category (`category`, text): Only links of this kind, such as Protein Structures. Leave blank for all.
- Found by (`obtained_by`, text): Only links found this way. Leave blank for all. One of: `tm_accession` (Accession numbers found in the text), `tm_term` (Terms found in the text), `ext_links` (Links added by other resources), `submission` (Deposited along with the data).

**Outputs**

- `article` (text): The article, as SOURCE:ID.
- `categories` (list): The kinds of data and how many of each.
- `count` (number): Links returned.
- `links` (list): The linked data.
- `total` (number): Links Europe PMC counts for the article.

**Example output**

```json
{
  "article": "MED:28585529",
  "categories": [
    {
      "count": 1,
      "name": "Nucleotide Sequences"
    }
  ],
  "count": 1,
  "links": [
    {
      "category": "Nucleotide Sequences",
      "database": "ENA",
      "id": "PRJNA328040",
      "linked_on": "2026-04-20",
      "obtained_by": "submission",
      "provider": "Europe PMC",
      "relationship": "IsReferencedBy",
      "title": "Sea beet genome sequencing",
      "type": "dataset",
      "url": "http://www.ebi.ac.uk/ena/data/view/PRJNA328040"
    }
  ],
  "total": 1
}
```

### Get preprint reviews

Get the peer reviews and evaluations published about a preprint version, with where each was published and a link to read it.

**Inputs**

- Source (`source`, text): Leave blank for a preprint (PPR...); pick the source otherwise. One of: `MED` (PubMed / MEDLINE (MED)), `PMC` (PubMed Central (PMC)), `PPR` (Preprints (PPR)), `PAT` (Patents (PAT)), `AGR` (Agricola (AGR)), `CBA` (Chinese Biological Abstracts (CBA)), `CTX` (CiteXplore (CTX)), `ETH` (EThOS theses (ETH)), `HIR` (NHS Evidence (HIR)), `NBK` (NCBI Bookshelf (NBK)).
- Article ID (`article_id`, text, required): The preprint version's ID, such as PPR842663. Reviews belong to the version reviewed, often the first.

**Outputs**

- `article` (text): The preprint, as SOURCE:ID.
- `count` (number): How many reviews there are.
- `reviews` (list): The reviews.

**Example output**

```json
{
  "article": "PPR:PPR842663",
  "count": 1,
  "reviews": [
    {
      "doi": "10.12688/openreseurope.17317.1",
      "platform": "F1000 Research Ltd",
      "reviewed_on": "2025-01-08",
      "reviewers": [],
      "title": "Peer Review Report For: Determinants of screening participation of disadvantaged populations in France",
      "type": "referee-report",
      "updated_at": "2026-05-22 10:45:15",
      "url": "https://doi.org/10.21956/openreseurope.18717.r47682"
    }
  ]
}
```

### Get text-mined terms

Get the genes, proteins, diseases, chemicals, organisms, methods and other terms text mining found in an article, each with how often and in which sections it is mentioned, and optionally every mention in context.

**Inputs**

- Source (`source`, text): The database the article is from. Leave blank to tell from the ID: digits are PubMed (MED), PMC... is PubMed Central, PPR... a preprint. One of: `MED` (PubMed / MEDLINE (MED)), `PMC` (PubMed Central (PMC)), `PPR` (Preprints (PPR)), `PAT` (Patents (PAT)), `AGR` (Agricola (AGR)), `CBA` (Chinese Biological Abstracts (CBA)), `CTX` (CiteXplore (CTX)), `ETH` (EThOS theses (ETH)), `HIR` (NHS Evidence (HIR)), `NBK` (NCBI Bookshelf (NBK)).
- Article ID (`article_id`, text, required): The article's ID in its source: a PubMed ID such as 28585529, a PMCID such as PMC5467160, or a preprint ID such as PPR842663. 'Search publications' shows each article's.
- Kinds of term (`types`, list): Only these kinds of term. Leave empty for every kind. One or more of: `Gene_Proteins` (Genes and proteins), `Diseases`, `Chemicals`, `Organisms`, `Gene Ontology` (Gene Ontology terms), `Accession Numbers`, `Experimental Methods`, `Resources` (Databases and software), `Cell` (Cells), `Cell Line` (Cell lines), and 7 more.
- Sections (`sections`, list): Only terms in these sections. Leave empty for the whole article. One or more of: `Title`, `Abstract`, `Introduction`, `Methods`, `Results`, `Discussion`, `Conclusion`, `Table` (Tables), `Figure` (Figures), `Case study`, and 8 more.
- Mined by (`providers`, list): Only terms these text-mining groups found. Leave empty for all. One or more of: `Europe PMC`, `OpenTargets` (Open Targets), `PubTator_NCBI` (PubTator (NCBI)), `OntoGene`, `NaCTeM`, `HES-SO_SIB` (HES-SO / SIB), `IntAct`, `DisGeNET`, `NTNU/BSC` (NTNU / BSC), `PheneBank`, and 3 more.
- List every mention (`include_mentions`, true/false): Also list each single mention with the words around it. A long article has hundreds, so this is off unless ticked.

**Outputs**

- `article` (text): The article, as SOURCE:ID.
- `mention_count` (number): Mentions in all.
- `mentions` (list): Every mention, when 'List every mention' is ticked.
- `pmcid` (text): Its PubMed Central ID, when it has one.
- `summary` (text): The terms in one line.
- `term_count` (number): Distinct terms.
- `terms` (list): Each distinct term, most mentioned first.

**Example output**

```json
{
  "article": "MED:28585529",
  "mention_count": 1,
  "mentions": [
    {
      "after": "efficiency of the",
      "before": "The",
      "provider": "Europe PMC",
      "section": "Methods",
      "subtype": null,
      "tags": [
        {
          "name": "infestations and infections",
          "uri": "http://linkedlifedata.com/resource/umls-concept/C3714514"
        }
      ],
      "text": "infection",
      "type": "Diseases"
    }
  ],
  "pmcid": "PMC5467160",
  "summary": "1 term in 1 mention, most often infestations and infections",
  "term_count": 1,
  "terms": [
    {
      "mentions": 1,
      "sections": [
        "Methods"
      ],
      "term": "infestations and infections",
      "type": "Diseases",
      "uris": [
        "http://linkedlifedata.com/resource/umls-concept/C3714514"
      ]
    }
  ]
}
```

### List citing articles

List the publications that cite an article, newest first, a page at a time.

**Inputs**

- Source (`source`, text): The database the article is from. Leave blank to tell from the ID: digits are PubMed (MED), PMC... is PubMed Central, PPR... a preprint. One of: `MED` (PubMed / MEDLINE (MED)), `PMC` (PubMed Central (PMC)), `PPR` (Preprints (PPR)), `PAT` (Patents (PAT)), `AGR` (Agricola (AGR)), `CBA` (Chinese Biological Abstracts (CBA)), `CTX` (CiteXplore (CTX)), `ETH` (EThOS theses (ETH)), `HIR` (NHS Evidence (HIR)), `NBK` (NCBI Bookshelf (NBK)).
- Article ID (`article_id`, text, required): The article's ID in its source: a PubMed ID such as 28585529, a PMCID such as PMC5467160, or a preprint ID such as PPR842663. 'Search publications' shows each article's.
- Page (`page`, number): Which page to return, starting at 1. From 1 to 1000000.
- Page size (`page_size`, number): How many to return, 1 to 1000. Defaults to 25. From 1 to 1000.

**Outputs**

- `article` (text): The article, as SOURCE:ID.
- `citations` (list): The citing publications.
- `count` (number): Citing publications on this page.
- `has_more` (true/false): True when there is another page.
- `page` (number): The page returned.
- `total` (number): Citing publications in all.

**Example output**

```json
{
  "article": "MED:28585529",
  "citations": [
    {
      "authors": "Bertram L, Gholami M, Kopisch-Obuch F, Frisch M.",
      "cited_by_count": 1,
      "id": "40894485",
      "issue": null,
      "journal": "Front Plant Sci",
      "pages": "1635602",
      "pub_types": [
        "research-article",
        "journal article"
      ],
      "pub_year": "2025",
      "source": "MED",
      "title": "Exploring the diversity of three Northern Atlantic sea beet populations.",
      "url": "https://europepmc.org/article/MED/40894485",
      "volume": "16"
    }
  ],
  "count": 1,
  "has_more": true,
  "page": 1,
  "total": 44
}
```

### List references

List the works an article cites, in reference-list order, with each one's Europe PMC record when it has one.

**Inputs**

- Source (`source`, text): The database the article is from. Leave blank to tell from the ID: digits are PubMed (MED), PMC... is PubMed Central, PPR... a preprint. One of: `MED` (PubMed / MEDLINE (MED)), `PMC` (PubMed Central (PMC)), `PPR` (Preprints (PPR)), `PAT` (Patents (PAT)), `AGR` (Agricola (AGR)), `CBA` (Chinese Biological Abstracts (CBA)), `CTX` (CiteXplore (CTX)), `ETH` (EThOS theses (ETH)), `HIR` (NHS Evidence (HIR)), `NBK` (NCBI Bookshelf (NBK)).
- Article ID (`article_id`, text, required): The article's ID in its source: a PubMed ID such as 28585529, a PMCID such as PMC5467160, or a preprint ID such as PPR842663. 'Search publications' shows each article's.
- Page (`page`, number): Which page to return, starting at 1. From 1 to 1000000.
- Page size (`page_size`, number): How many to return, 1 to 1000. Defaults to 25. From 1 to 1000.

**Outputs**

- `article` (text): The article, as SOURCE:ID.
- `count` (number): References on this page.
- `has_more` (true/false): True when there is another page.
- `page` (number): The page returned.
- `references` (list): The works cited.
- `total` (number): References in all.

**Example output**

```json
{
  "article": "MED:28585529",
  "count": 1,
  "has_more": true,
  "page": 1,
  "references": [
    {
      "authors": "Huang BE, Verbyla KL, Verbyla AP, Cavanagh CR.",
      "doi": null,
      "id": "25855139",
      "in_europe_pmc": true,
      "issue": "6",
      "journal": "Theor Appl Genet",
      "order": 2,
      "pages": "999-1017",
      "pub_types": [
        "JOURNAL ARTICLE"
      ],
      "pub_year": "2015",
      "source": "MED",
      "title": "MAGIC populations in crops: current status and future prospects.",
      "url": "https://europepmc.org/article/MED/25855139",
      "volume": "128"
    }
  ],
  "total": 45
}
```

### List search fields

List the fields a search can be narrowed by, such as TITLE, AUTH (author), JOURNAL, PUB_YEAR or GRANT_AGENCY, to write queries like TITLE:"gene editing" AND PUB_YEAR:2024.

**Inputs**: None.

**Outputs**

- `count` (number): How many fields there are.
- `fields` (list): The field names, e.g. 'TITLE', 'AUTH'.

**Example output**

```json
{
  "count": 5,
  "fields": [
    "ABSTRACT",
    "AUTH",
    "JOURNAL",
    "PUB_YEAR",
    "TITLE"
  ]
}
```

### Search grants

Search the research grants of Europe PMC's funders (Wellcome, UKRI, the European Research Council and more) by topic, funder, grant number, holder, institution or a date they were running on. Each grant comes with a query for the papers it funded.

**Inputs**

- Search (`query`, text): Words to look for in the grant's title, abstract and details.
- Funder (`funder`, text): Only this funder's grants, such as Wellcome Trust or Medical Research Council.
- Grant number (`grant_id`, text): The funder's number for the grant, such as 324519.
- Grant holder (`investigator`, text): The holder's family name, optionally with initials, such as Narh C.
- Institution (`affiliation`, text): Words from the holder's institution, such as Oxford.
- Active on (`active_on`, date): Only grants running on this date.
- Page (`page`, number): Which page of 25 grants to return, starting at 1. From 1 to 100000.

**Outputs**

- `count` (number): Grants on this page.
- `grants` (list): The grants on this page.
- `has_more` (true/false): True when there is another page.
- `page` (number): The page returned.
- `pages` (number): Pages of 25 in all.
- `query` (text): The grant query sent.
- `total` (number): Grants matching in all.

**Example output**

```json
{
  "count": 1,
  "grants": [
    {
      "abstract": "Childhood cancer incidence in Africa is estimated to be similar...",
      "amount": 836555.0,
      "currency": "GBP",
      "end_date": "2030-12-31",
      "funder": "Wellcome Trust",
      "funder_doi": "https://doi.org/10.13039/100010269",
      "grant_id": "321702",
      "institution": {
        "name": "Kilimanjaro Christian Medical University College",
        "ror_id": null
      },
      "investigator": {
        "family_name": "Safari",
        "given_name": "Wiston",
        "name": "Dr Wiston Safari",
        "orcid": null
      },
      "lay_summary": null,
      "other_ids": [
        "321702"
      ],
      "publications_query": "GRANT_ID:\"321702\" AND GRANT_AGENCY:\"Wellcome Trust\"",
      "start_date": "2026-01-01",
      "stream": "Population and Public Health",
      "title": "Quantifying childhood cancer burden in Tanzania",
      "type": "Early-Career Award"
    }
  ],
  "has_more": true,
  "page": 1,
  "pages": 37,
  "query": "malaria AND ga:\"Wellcome Trust\"",
  "total": 911
}
```

### Search publications

Search over 45 million life-science papers, preprints, patents and theses by words or Europe PMC's search syntax. Narrow by source, publication dates and open access, and sort by relevance, date or citations. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Search (`query`, text, required): Words to search for. Europe PMC's search syntax works too, such as TITLE:"gene editing" AND AUTH:"Doudna J" (see 'List search fields').
- Source (`source`, text): Only publications from this source. Leave blank for all. One of: `MED` (PubMed / MEDLINE (MED)), `PMC` (PubMed Central (PMC)), `PPR` (Preprints (PPR)), `PAT` (Patents (PAT)), `AGR` (Agricola (AGR)), `CBA` (Chinese Biological Abstracts (CBA)), `CTX` (CiteXplore (CTX)), `ETH` (EThOS theses (ETH)), `HIR` (NHS Evidence (HIR)), `NBK` (NCBI Bookshelf (NBK)).
- Published on or after (`published_from`, date): Only publications first published on or after this date.
- Published on or before (`published_until`, date): Only publications first published on or before this date.
- Open access only (`open_access_only`, true/false): Only publications that are free to read and reuse.
- Include synonyms (`synonyms`, true/false): Also match synonyms of the words searched for, such as 'myocardial infarction' for 'heart attack'.
- Order (`sort`, text): How to order the results. Defaults to best match first. One of: `relevance` (Best match first), `newest` (Newest first), `oldest` (Oldest first), `most_cited` (Most cited first), `recently_added` (Most recently added to Europe PMC first).
- Detail (`detail`, text): Short records are quicker; full records add each abstract. Defaults to short. One of: `short` (Short records), `full` (Full records, with abstracts).
- Page size (`page_size`, number): How many to return, 1 to 1000. Defaults to 25. From 1 to 1000.
- Next page cursor (`cursor`, text): The 'next_cursor' from the previous page, to get the page after it. Keep the search, filters and order the same.

**Outputs**

- `articles` (list): The publications on this page.
- `count` (number): Publications on this page.
- `next_cursor` (text): Pass as 'cursor' for the next page; blank on the last.
- `query` (text): The query sent, with the step's filters written in.
- `total` (number): Publications matching the search in all.

**Example output**

```json
{
  "articles": [
    {
      "abstract": null,
      "authors": "Capistrano-Gossmann GG, Ries D, Holtgr\u00e4we D, Kopisch-Obuch FJ.",
      "cited_by_count": 43,
      "doi": "10.1038/ncomms15708",
      "has_full_text": true,
      "has_references": true,
      "has_text_mined_terms": true,
      "id": "28585529",
      "indexed_date": "2017-06-08",
      "is_open_access": true,
      "journal": "Nature communications",
      "pmcid": "PMC5467160",
      "pmid": "28585529",
      "pub_types": [
        "research-article",
        "Journal Article"
      ],
      "pub_year": "2017",
      "published_date": "2017-06-06",
      "source": "MED",
      "title": "Crop wild relative populations of Beta vulgaris allow direct mapping of agronomically important genes.",
      "url": "https://europepmc.org/article/MED/28585529"
    }
  ],
  "count": 1,
  "next_cursor": "AoJQDCg0NjAwMTY1MQ==",
  "query": "(CRISPR sugar beet) AND OPEN_ACCESS:y",
  "total": 777
}
```
