Europe PMC
Europe PMC life-science literature — search, citations, references, full text, books, supplementary files, text-mined annotations and grants.
Annotations By Article
Text-mined entities for named articles. This replaces the retired textMinedTerms route; one unfiltered article can exceed 130 KB, so the body is read under a ceiling.
/v1/research:europepmc/annotations-by-articleParameters
| Name | Type | In | Description |
|---|---|---|---|
| articleIds | string | query | One or more SOURCE:ID pairs separated by commas, such as MED:33301246,PMC:PMC7745181. Up to 8 per call. Required. |
| type | enum | query | Restrict to one entity type. Default all types. One of Gene_Proteins, Chemicals, Diseases, Organisms, Accession Numbers, Gene Ontology, Sequence Ontology, Experimental Methods, Cell, Cell Line, Body Part. |
| section | enum | query | Restrict to one article section. Default all sections. One of Title, Abstract, Introduction, Methods, Results, Discussion, Conclusion. |
| annotationProvider | string | query | Restrict to one annotation provider. Default all providers. |
Example response
{"project":"research:europepmc", "data": {"count":1, "items": [ {"id":"33301246","count":8,"pmcid":"PMC7745181","source":"MED", "annotations": [ { "tags": [ {"uri":"http://linkedlifedata.com/resource/umls-concept/C3714514","name":"infestations and infections" } ],"type":"Diseases","exact":"infection","prefix":"coronavirus 2 (SARS-CoV-2)","postfix":"and the resulting","section":"Abstract (http://purl.org/dc/terms/abstract)","frequency":null,"annotationId":"http://europepmc.org/article/MED/33301246#europepmc-2faf2bd76e3bbc392264592dd9233545","annotationProvider":"Europe PMC" }, { "tags": [ {"uri":"http://linkedlifedata.com/resource/umls-concept/C5203670","name":"caused by sarscov2" } ],"type":"Diseases","exact":"coronavirus disease 2019","prefix":"and the resulting","postfix":"disease 2019 (Covid-19)","section":"Abstract (http://purl.org/dc/terms/abstract)","frequency":null,"annotationId":"http://europepmc.org/article/MED/33301246#europepmc-7e5d5f7cd73d9b67569981d4a0b22dcb","annotationProvider":"Europe PMC" } ], "fullTextIds": [ "PMC7745181" ] } ],"provider":"europepmc", "articleIds": [ "MED:33301246" ] },"timestamp":"2026-08-30T00:49:26Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Annotations By Provider
Bulk annotation stream for one provider. Measured at ~820 KB per article, so the page size is capped hard and the body is read against a ceiling and the deadline.
/v1/research:europepmc/annotations-by-providerParameters
| Name | Type | In | Description |
|---|---|---|---|
| annotationProvider | string | query | Annotation provider to stream, such as Europe PMC, IntAct or OpenTargets. Required. |
| cursor | string | query | Cursor for the next slice. Start at 0 then pass nextCursor. |
| limit | number | query | Articles per call. Default 1, max 3 — one article averages 820 KB. |
Example response
{"project":"research:europepmc", "data": {"count":1, "items": [ {"id":"PMC11231130","count":4539,"pmcid":"PMC11231130","source":"PMC", "annotations": [ { "tags": [ {"uri":"http://linkedlifedata.com/resource/umls-concept/C0007222","name":"Cardiovascular Disease" } ],"type":"Diseases","exact":"Cardiovascular Disease","prefix":null,"postfix":null,"section":null,"frequency":43,"annotationId":null,"annotationProvider":"Europe PMC" }, { "tags": [ {"uri":"http://linkedlifedata.com/resource/umls-concept/C1609538","name":"Latent Tuberculosis Infection" } ],"type":"Diseases","exact":"Latent Tuberculosis Infection","prefix":null,"postfix":null,"section":null,"frequency":4,"annotationId":null,"annotationProvider":"Europe PMC" } ], "fullTextIds": [ "PMC11231130" ] } ],"limit":1,"hasMore":true,"provider":"europepmc","nextCursor":"28754.31123113","annotationProvider":"Europe PMC" },"timestamp":"2026-08-30T00:49:26Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Article
One Europe PMC record, resolved through the EXT_ID+SRC fast path of /search at resultType=core — the only shape that carries all 48 fields and the has* routing flags.
/v1/research:europepmc/articleParameters
| Name | Type | In | Description |
|---|---|---|---|
| id | string | query | Article identifier within the source — a PMID for MED, a PMCID for PMC. Required. |
| source | enum | query | Source archive the id belongs to. Default MED. One of MED, PMC, PPR, AGR, CBA, CTX, ETH, HIR, PAT, NBK. |
Example response
{"project":"research:europepmc", "data": {"id":"33301246","doi":"10.1056/nejmoa2034577","pmid":"33301246","inPMC":true,"pmcid":"PMC7745181","title":"Safety and Efficacy of the BNT162b2 mRNA Covid-19 Vaccine.", "grants": [ {"agency":"BioNTech and Pfizer","acronym":null,"grantId":null,"orderIn":0 } ],"hasPDF":true,"inEPMC":true,"source":"MED","authMan":false, "authors": [ {"orcid":null,"fullName":"Polack FP","initials":"FP","lastName":"Polack","firstName":"Fernando P", "affiliations": [ "From Fundacion INFANT (F.P.P.) and iTrials-Hospital Militar Central (G.P.M.), Buenos Aires; State University of New York, Upstate Medical University, Syracuse (S.J.T.), and Vaccine…" ],"collectiveName":null } ],"hasBook":false,"hasData":true,"license":null,"pubYear":2020, "subsets": [ {"code":"IM","name":"Index Medicus" } ],"abstract":"<h4>Background</h4>Severe acute respiratory syndrome coronavirus 2 (SARS-CoV-2) infection and the resulting coronavirus disease 2019 (Covid-19) have afflicted tens of millions of p…","hasSuppl":true,"language":"eng","pageInfo":"2603-2615","provider":"europepmc","pubModel":"Print-Electronic", "pubTypes": [ "Clinical Trial, Phase III" ], "authorIds": [ {"type":"ORCID","value":"0000-0001-6269-2354" } ], "chemicals": [ {"name":"Vaccines, Synthetic","registryNumber":"0" } ],"nihAuthMan":false,"affiliation":"From Fundacion INFANT (F.P.P.) and iTrials-Hospital Militar Central (G.P.M.), Buenos Aires; State University of New York, Upstate Medical University, Syracuse (S.J.T.), and Vaccine…","epmcAuthMan":false, "fullTextIds": [ "PMC7745181" ], "journalInfo": {"issue":"27","volume":"383", "journal": {"essn":"1533-4406","issn":"0028-4793","nlmId":"0255562","title":"The New England journal of medicine","isoAbbreviation":"N Engl J Med","medlineAbbreviation":"N Engl J Med" },"journalIssueId":3059948,"dateOfPublication":"2020 Dec","yearOfPublication":2020,"monthOfPublication":12,"printPublicationDate":"2020-12-01" },"authorString":"Polack FP, Thomas SJ, Kitchin N, Absalon J, Gurtman A, Lockhart S, Perez JL, Pérez Marc G, Moreira ED, Zerbini C, Bailey R, Swanson KA, Roychoudhury S, Koury K, Li P, Kalina WV, Co…","citedByCount":12438, "fullTextUrls": [ {"url":"https://www.arca.fiocruz.br/handle/icict/46039","site":"Unpaywall","availability":"Open access","documentStyle":"html","availabilityCode":"OA" } ],"hasLabsLinks":true,"isOpenAccess":true, "meshHeadings": [ {"majorTopic":false,"descriptorName":"Humans" } ], "dataLinksTags": [ "altmetrics" ],"hasReferences":true, "investigators": [ {"orcid":null,"fullName":"Aberg J","initials":"J","lastName":"Aberg","firstName":"Judith","collectiveName":null } ],"dateOfCreation":"2020-12-10","dateOfRevision":"2026-01-27","firstIndexDate":"2020-12-11","hasEvaluations":false,"dateOfCompletion":"2021-01-12", "tmAccessionTypes": [ "nct" ],"hasTextMinedTerms":true,"publicationStatus":"ppublish", "commentCorrections": [ {"id":"33301245","type":"Comment in","source":"MED","orderIn":1,"reference":"N Engl J Med. 2020 Dec 31;383(27):2677-2678. doi: 10.1056/NEJMe2034717." } ],"firstPublicationDate":"2020-12-10","fullTextReceivedDate":"2025-02-03","hasDbCrossReferences":false,"hasTMAccessionNumbers":true,"electronicPublicationDate":"2020-12-10" },"timestamp":"2026-08-30T00:49:26Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Book
Book XML from the NCBI Bookshelf mirror. NBK1116 alone is 4.1 MB, so the byte ceiling and the deadline are load-bearing, not decoration.
/v1/research:europepmc/bookParameters
| Name | Type | In | Description |
|---|---|---|---|
| nbkId | string | query | NCBI Bookshelf identifier of the book or chapter. Required. |
Example response
{"project":"research:europepmc", "data": {"id":"NBK1116","bytes":4108845,"format":"xml","source":"NBK","content":"<!DOCTYPE book-part-wrapper PUBLIC \"-//NLM//DTD BITS Book Interchange DTD v2.0 20151225//EN\" \"BITS-book2.dtd\"><book-part-wrapper xmlns:ali=\"http://www.niso.org/schemas/ali/1.0/\" xm…","complete":true,"provider":"europepmc" },"timestamp":"2026-08-30T00:49:26Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Citations
Articles citing one Europe PMC record. Upstream pages by offset, not cursor.
/v1/research:europepmc/citationsParameters
| Name | Type | In | Description |
|---|---|---|---|
| id | string | query | Article identifier within the source — a PMID for MED, a PMCID for PMC. Required. |
| source | enum | query | Source archive the id belongs to. Default MED. One of MED, PMC, PPR, AGR, CBA, CTX, ETH, HIR, PAT, NBK. |
| page | number | query | Page number. Default 1. |
| limit | number | query | Items per page. Default 25, max 100. |
Example response
{"project":"research:europepmc", "data": {"id":"33301246","page":1,"count":3, "items": [ {"id":"PPR1298176","doi":null,"essn":null,"issn":null,"issue":null,"title":"A full-flow microfluidic platform for synthesis, purification and concentrating of lipid nanoparticles (LNPs)","source":"PPR","volume":null,"pubYear":2026,"pageInfo":null,"authorString":"Tao J, Zhao J, Liu Y, Hu L, Zhou H, Wang B, Kang Y.","citationType":"preprint","citedByCount":0,"externalLink":null,"journalAbbreviation":null }, {"id":"42595948","doi":null,"essn":null,"issn":null,"issue":null,"title":"Exploring the Polyethylene Glycol-Modified Drug Patent Landscape by Deep Learning.","source":"MED","volume":null,"pubYear":2026,"pageInfo":null,"authorString":"Zhang T, Deng D, Zhang X, Chen W, Wang P, Li X, Cong J, Wei B, Liu K.","citationType":"journal article","citedByCount":0,"externalLink":null,"journalAbbreviation":"Ther Innov Regul Sci" } ],"limit":3,"total":12080,"source":"MED","hasMore":true,"nextPage":2,"provider":"europepmc" },"timestamp":"2026-08-30T00:49:26Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Database Links
Cross-references from one Europe PMC record into the molecular databases (UniProt, PDB, ENA, ChEBI …). Upstream names the filter `database`.
/v1/research:europepmc/database-linksParameters
| Name | Type | In | Description |
|---|---|---|---|
| id | string | query | Article identifier within the source — a PMID for MED, a PMCID for PMC. Required. |
| source | enum | query | Source archive the id belongs to. Default MED. One of MED, PMC, PPR, AGR, CBA, CTX, ETH, HIR, PAT, NBK. |
| database | string | query | Restrict to one database, such as EMBL, UNIPROT, PDB, CHEBI, OMIM, PRIDE. |
| page | number | query | Page number. Default 1. |
| limit | number | query | Items per page. Default 25, max 100. |
Example response
{"project":"research:europepmc", "data": {"id":"18407985","page":1,"count":0,"items":[],"limit":3,"total":null,"source":"MED","hasMore":false,"database":"EMBL","nextPage":null,"provider":"europepmc" },"timestamp":"2026-08-30T00:49:26Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Full Text
JATS full-text XML for one open-access PMC record. Non-JSON upstream, so this is a flat single object; the body is read against a byte ceiling and the 60s wall.
/v1/research:europepmc/full-textParameters
| Name | Type | In | Description |
|---|---|---|---|
| pmcid | string | query | PMC identifier of an article whose full text is in Europe PMC. Required. |
Example response
{"project":"research:europepmc", "data": {"id":"PMC3258128","bytes":94004,"format":"xml","source":"PMC","content":"<?xml version=\"1.0\" encoding=\"UTF-8\"?><article xml:lang=\"en\" article-type=\"research-article\"><front><journal-meta><journal-id journal-id-type=\"pmc-domain-id\">4</journal-id><journal…","complete":true,"provider":"europepmc" },"timestamp":"2026-08-30T00:49:26Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Grants
GRIST grant records. The upstream folds its whole query string into one path segment and mangles any parameter it does not know, so order and set are fixed.
/v1/research:europepmc/grantsParameters
| Name | Type | In | Description |
|---|---|---|---|
| query | string | query | Free text, or a GRIST field expression such as gr.gid eq "23942" or pi.fn eq "Smith". Required. |
| resultType | enum | query | Field depth per record. Default core, which carries the abstract and amount. One of lite, core. |
| page | number | query | Page number. Default 1. Upstream fixes the page at 25 records. |
Example response
{"project":"research:europepmc", "data": {"page":1,"count":25, "items": [ { "grant": {"doi":"10.3030/101231026","type":"Consolidator Grant","alias":"101231026","title":"Evolution of Mechanisms for Sex Chromosome Dosage Compensation and Gene Regulation (EMERGE)","amount":1999177, "funder": {"name":"European Research Council","fundRefId":"https://doi.org/10.13039/501100000781","searchTerm":"European Research Council" },"stream":"Frontier Research","endDate":"2031-07-31","grantId":"101231026","abstract":"There is a remarkable diversity of phenotypes among multicellular animals, including differences between males and females. A major driver of phenotypic variation stems from differ…","category":"Horizon Europe","currency":"EUR","startDate":"2026-08-01","abstractType":"scientific","abstractLanguage":"en" }, "person": {"orcid":"0000-0003-4135-5927","title":"Dr","initials":"C","givenName":"Claudia","familyName":"Keller Valsecchi" }, "institution": {"name":"University of Basel","rorId":"02s6k3f65","department":null,"officialName":"University of Basel" } } ],"limit":25,"query":"malaria","total":1683,"hasMore":true,"nextPage":2,"provider":"europepmc","resultType":"core" },"timestamp":"2026-08-30T00:49:26Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Labs Links
External provider links (Altmetric, Publons, BioStudies, Faculty Opinions …) for one Europe PMC record. Upstream returns the whole provider set in one call.
/v1/research:europepmc/labs-linksParameters
| Name | Type | In | Description |
|---|---|---|---|
| id | string | query | Article identifier within the source — a PMID for MED, a PMCID for PMC. Required. |
| source | enum | query | Source archive the id belongs to. Default MED. One of MED, PMC, PPR, AGR, CBA, CTX, ETH, HIR, PAT, NBK. |
Example response
{"project":"research:europepmc", "data": {"id":"33301246","count":4, "items": [ {"name":"Publons", "links": [ {"url":"https://publons.com/p/35654943/","title":"Read 1 peer review on Publons","imageUrl":null }, {"url":"https://publons.com/review/create/post/35654943/","title":"Add a post publication review on Publons","imageUrl":null } ],"frontTab":false,"linksCount":2,"providerId":1529,"description":"Our mission is to speed up science by working with peer reviewers, publishers, and research institutions to make peer review a rewarding activity." }, {"name":"BioStudies: supplemental material and supporting data", "links": [ {"url":"http://www.ebi.ac.uk/biostudies/studies/S-EPMC7745181?xr=true","title":"Safety and Efficacy of the BNT162b2 mRNA Covid-19 Vaccine.","imageUrl":null } ],"frontTab":false,"linksCount":1,"providerId":1518,"description":"Database of biological studies" } ],"source":"MED","provider":"europepmc" },"timestamp":"2026-08-30T00:49:26Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Profile
Hit counts for one query, faceted by source, publication type and subset — the cheapest way to size a search before paging it.
/v1/research:europepmc/profileParameters
| Name | Type | In | Description |
|---|---|---|---|
| query | string | query | Search terms, same grammar as the search endpoint. Required. |
| synonym | enum | query | Expand the query with MeSH and UniProt synonyms. Default false. One of true, false. |
Example response
{"project":"research:europepmc", "data": {"count":15, "items": [ {"name":"AGR","count":489,"group":"source" }, {"name":"CBA","count":117,"group":"source" }, {"name":"CTX","count":9,"group":"source" }, {"name":"ETH","count":1024,"group":"source" }, {"name":"HIR","count":4,"group":"source" }, {"name":"MED","count":254752,"group":"source" }, {"name":"PAT","count":2254,"group":"source" }, {"name":"CIT","count":0,"group":"source" } ],"query":"malaria","provider":"europepmc" },"timestamp":"2026-08-30T00:49:26Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
References
The reference list of one Europe PMC record. Upstream pages by offset, not cursor.
/v1/research:europepmc/referencesParameters
| Name | Type | In | Description |
|---|---|---|---|
| id | string | query | Article identifier within the source — a PMID for MED, a PMCID for PMC. Required. |
| source | enum | query | Source archive the id belongs to. Default MED. One of MED, PMC, PPR, AGR, CBA, CTX, ETH, HIR, PAT, NBK. |
| page | number | query | Page number. Default 1. |
| limit | number | query | Items per page. Default 25, max 100. |
Example response
{"project":"research:europepmc", "data": {"id":"33301246","page":1,"count":3, "items": [ {"id":"18797453","doi":null,"essn":"1525-0024","issn":"1525-0016","issue":"11","title":"Incorporation of pseudouridine into mRNA yields superior nonimmunogenic vector with increased translational capacity and biological stability.","source":"MED","volume":"16","matched":true,"pubYear":2008,"pageInfo":"1833-1840","citedOrder":1,"authorString":"Kariko K, Muramatsu H, Welsh FA, Ludwig J, Kato H, Akira S, Weissman D.","citationType":"JOURNAL ARTICLE","externalLink":null,"journalAbbreviation":"Mol Ther","unstructuredInformation":null }, {"id":"31828291","doi":null,"essn":"1537-6591","issn":"1058-4838","issue":"7","title":"Comparative Immunogenicity of Several Enhanced Influenza Vaccine Options for Older Adults: A Randomized, Controlled Trial.","source":"MED","volume":"71","matched":true,"pubYear":2020,"pageInfo":"1704-1714","citedOrder":2,"authorString":"Cowling BJ, Perera RAPM, Valkenburg SA, Leung NHL, Iuliano AD, Tam YH, Wong JHF, Fang VJ, Li APY, So HC, Ip DKM, Azziz-Baumgartner E, Fry AM, Levine MZ, Gangappa S, Sambhara S, Bar…","citationType":"JOURNAL ARTICLE","externalLink":null,"journalAbbreviation":"Clin Infect Dis","unstructuredInformation":null } ],"limit":3,"total":7,"source":"MED","hasMore":true,"nextPage":2,"provider":"europepmc" },"timestamp":"2026-08-30T00:49:26Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Search Post
Europe PMC searchPOST — the same index as `search`, reached with a form body so a query too long for a URL still fits. Same cursor-walk pagination, same envelope.
/v1/research:europepmc/search-postParameters
| Name | Type | In | Description |
|---|---|---|---|
| query | string | body | Search terms. Supports the field grammar SRC:, EXT_ID:, DOI:, PUB_YEAR:, AUTHORID:, JOURNAL:, AFF:, GRANT_AGENCY:, HAS_FT:, OPEN_ACCESS:, LICENSE:. Required. |
| resultType | enum | body | Field depth per record. Default lite, core carries all 48 fields. One of idlist, lite, core. |
| page | number | body | Page number. Default 1, max 10 — pass cursor for anything deeper. |
| cursor | string | body | Cursor for unbounded deep paging. Start with * then pass nextCursor. Overrides page. |
| limit | number | body | Items per page. Default 25, max 100. |
| sort | enum | body | Sort order. Default relevance. One of relevance, dateAsc, dateDesc, citedAsc, citedDesc, author, title. |
| synonym | enum | body | Expand the query with MeSH and UniProt synonyms. Default false. One of true, false. |
Example response
{"project":"research:europepmc", "data": {"page":null,"count":3, "items": [ {"id":"33069326","doi":"10.1016/s0140-6736(20)30925-9","pmid":"33069326","inPMC":true,"pmcid":"PMC7567026","title":"Global burden of 369 diseases and injuries in 204 countries and territories, 1990-2019: a systematic analysis for the Global Burden of Disease Study 2019.","hasPDF":false,"inEPMC":true,"source":"MED","authMan":null,"hasBook":false,"hasData":null,"license":null,"pubYear":2020,"abstract":null,"hasSuppl":true,"language":null,"pageInfo":"1204-1222","pubModel":null, "pubTypes": [ "research-article; journal article" ],"nihAuthMan":null,"affiliation":null,"epmcAuthMan":null, "fullTextIds": [ "PMC7567026" ], "journalInfo": {"issue":"10258","volume":"396", "journal": {"essn":null,"issn":"0140-6736; 1474-547x; ","nlmId":null,"title":"Lancet","isoAbbreviation":null,"medlineAbbreviation":null },"journalIssueId":null,"dateOfPublication":null,"yearOfPublication":null,"monthOfPublication":null,"printPublicationDate":null },"authorString":"GBD 2019 Diseases and Injuries Collaborators.","citedByCount":14449,"hasLabsLinks":true,"isOpenAccess":true,"hasReferences":true,"dateOfCreation":null,"dateOfRevision":null,"firstIndexDate":"2020-10-20","hasEvaluations":null,"dateOfCompletion":null, "tmAccessionTypes": [ "doi" ],"hasTextMinedTerms":true,"publicationStatus":null,"firstPublicationDate":"2020-10-01","fullTextReceivedDate":null,"hasDbCrossReferences":false,"hasTMAccessionNumbers":true,"electronicPublicationDate":null } ],"limit":3,"query":"SRC:MED AND PUB_YEAR:2020 AND malaria","total":13355,"hasMore":true,"nextPage":null,"provider":"europepmc","nextCursor":"AoJQ8AMoNDIwMTUxNDc=","resultType":"lite" },"timestamp":"2026-08-30T00:49:26Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Search
Europe PMC REST search — open JSON, no key, rung 1 (direct) per recon. Measured 2026-08-29: upstream ignores `page` and paginates by cursorMark alone, so a
/v1/research:europepmc/searchParameters
| Name | Type | In | Description |
|---|---|---|---|
| query | string | query | Search terms. Supports the field grammar SRC:, EXT_ID:, DOI:, PUB_YEAR:, AUTHORID:, JOURNAL:, AFF:, GRANT_AGENCY:, HAS_FT:, OPEN_ACCESS:, LICENSE:. Required. |
| resultType | enum | query | Field depth per record. Default lite, core carries all 48 fields. One of idlist, lite, core. |
| page | number | query | Page number. Default 1, max 10 — pass cursor for anything deeper. |
| cursor | string | query | Cursor for unbounded deep paging. Start with * then pass nextCursor. Overrides page. |
| limit | number | query | Items per page. Default 25, max 100. |
| sort | enum | query | Sort order. Default relevance. One of relevance, dateAsc, dateDesc, citedAsc, citedDesc, author, title. |
| synonym | enum | query | Expand the query with MeSH and UniProt synonyms. Default false. One of true, false. |
Example response
{"project":"research:europepmc", "data": {"page":null,"count":3, "items": [ {"id":"33069326","doi":"10.1016/s0140-6736(20)30925-9","pmid":"33069326","inPMC":true,"pmcid":"PMC7567026","title":"Global burden of 369 diseases and injuries in 204 countries and territories, 1990-2019: a systematic analysis for the Global Burden of Disease Study 2019.","hasPDF":false,"inEPMC":true,"source":"MED","authMan":null,"hasBook":false,"hasData":null,"license":null,"pubYear":2020,"abstract":null,"hasSuppl":true,"language":null,"pageInfo":"1204-1222","pubModel":null, "pubTypes": [ "research-article; journal article" ],"nihAuthMan":null,"affiliation":null,"epmcAuthMan":null, "fullTextIds": [ "PMC7567026" ], "journalInfo": {"issue":"10258","volume":"396", "journal": {"essn":null,"issn":"0140-6736; 1474-547x; ","nlmId":null,"title":"Lancet","isoAbbreviation":null,"medlineAbbreviation":null },"journalIssueId":null,"dateOfPublication":null,"yearOfPublication":null,"monthOfPublication":null,"printPublicationDate":null },"authorString":"GBD 2019 Diseases and Injuries Collaborators.","citedByCount":14449,"hasLabsLinks":true,"isOpenAccess":true,"hasReferences":true,"dateOfCreation":null,"dateOfRevision":null,"firstIndexDate":"2020-10-20","hasEvaluations":null,"dateOfCompletion":null, "tmAccessionTypes": [ "doi" ],"hasTextMinedTerms":true,"publicationStatus":null,"firstPublicationDate":"2020-10-01","fullTextReceivedDate":null,"hasDbCrossReferences":false,"hasTMAccessionNumbers":true,"electronicPublicationDate":null } ],"limit":3,"query":"SRC:MED AND PUB_YEAR:2020 AND malaria","total":13355,"hasMore":true,"nextPage":null,"provider":"europepmc","nextCursor":"AoJQ8AMoNDIwMTUxNDc=","resultType":"lite" },"timestamp":"2026-08-30T00:49:26Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Supplementary Files
The supplementary-material archive for one PMC record. Upstream serves application/zip, so the handler resolves and sizes it and hands back the URL.
/v1/research:europepmc/supplementary-filesParameters
| Name | Type | In | Description |
|---|---|---|---|
| pmcid | string | query | PMC identifier of an article with supplementary material. Required. |
Example response
{"project":"research:europepmc", "data": {"id":"PMC7654321","url":"https://www.ebi.ac.uk/europepmc/webservices/rest/PMC7654321/supplementaryFiles","bytes":100956,"format":"zip","source":"PMC","complete":true,"filename":"PMC7654321_SupplementaryFiles.zip","provider":"europepmc" },"timestamp":"2026-08-30T00:49:26Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Try it
Live request with your key
const data = await client.run( "research:europepmc", "annotations-by-article", { articleIds: "MED:33301246", type: "Diseases", section: "Abstract", annotationProvider: "Europe PMC" });
Europe PMC
Europe PMC life-science literature — search, citations, references, full text, books, supplementary files, text-mined annotations and grants.
Text-mined entities for named articles. This replaces the retired textMinedTerms route; one unfiltered article can exceed 130 KB, so the body is read under a ceiling.
/v1/…europepmc/annotations-by-articleTry it
Parameters
articleIds
string · query · required
One or more SOURCE:ID pairs separated by commas, such as MED:33301246,PMC:PMC7745181. Up to 8 per call.
type
enum · query · optional
Restrict to one entity type. Default all types.
section
enum · query · optional
Restrict to one article section. Default all sections.
annotationProvider
string · query · optional
Restrict to one annotation provider. Default all providers.
Example response
{"project":"research:europepmc", "data": {"count":1, "items": [ {"id":"33301246","count":8,"pmcid":"PMC7745181","source":"MED", "annotations": [ { "tags": [ {"uri":"http://linkedlifedata.com/resource/umls-concept/C3714514","name":"infestations and infections" } ],"type":"Diseases","exact":"infection","prefix":"coronavirus 2 (SARS-CoV-2)","postfix":"and the resulting","section":"Abstract (http://purl.org/dc/terms/abstract)","frequency":null,"annotationId":"http://europepmc.org/article/MED/33301246#europepmc-2faf2bd76e3bbc392264592dd9233545","annotationProvider":"Europe PMC" }, { "tags": [ {"uri":"http://linkedlifedata.com/resource/umls-concept/C5203670","name":"caused by sarscov2" } ],"type":"Diseases","exact":"coronavirus disease 2019","prefix":"and the resulting","postfix":"disease 2019 (Covid-19)","section":"Abstract (http://purl.org/dc/terms/abstract)","frequency":null,"annotationId":"http://europepmc.org/article/MED/33301246#europepmc-7e5d5f7cd73d9b67569981d4a0b22dcb","annotationProvider":"Europe PMC" } ], "fullTextIds": [ "PMC7745181" ] } ],"provider":"europepmc", "articleIds": [ "MED:33301246" ] },"timestamp":"2026-08-30T00:49:26Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Code
const data = await client.run( "research:europepmc", "annotations-by-article", { articleIds: "MED:33301246", type: "Diseases", section: "Abstract", annotationProvider: "Europe PMC" });