Literature (Europe PMC)
locus_literatureRead-onlyIdempotent
Search Europe PMC for literature mentioning a plant locus. Returns title, authors, abstract, citation count, and auto-disambiguates for non-model species.
Instructions
Search Europe PMC for literature mentioning a plant locus. Free, no API key. Returns up to size results (default 10, capped at 25) with title, authors, journal, year, DOI, PMID, open-access status, citation count, and abstract. For non-Arabidopsis species the species common name is appended to the query to disambiguate locus IDs (rice, maize, ...). Pair with resolve_locus_to_uniprot or ensembl_plants_lookup_locus to ground the locus before fanning out to the literature.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | Max results (1–25, default 10) | |
| locus | Yes | e.g. AT1G01010 (Arabidopsis), Os01g0100100 (rice) | |
| organism | No | Plant organism — accepts canonical slug (arabidopsis_thaliana), scientific or common name, or NCBI taxid | arabidopsis_thaliana |
| include_abstract | No | Set false to null out abstractText, which is ~67% of this payload. The response echoes 'abstracts_included' so a null abstract is not mistaken for an article that has none. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hits | Yes | ||
| locus | Yes | ||
| query | Yes | Final query string sent to Europe PMC | |
| hitCount | Yes | Total hits available upstream (may exceed returned) | |
| organism | Yes | ||
| returned | Yes | Number of hits actually in hits[] | |
| abstracts_included | No | False when include_abstract=False was passed, in which case every abstractText is null because it was not requested — not because the article lacks one. Abstracts are ~67% of this payload. |