SIBiLS logo



SIBiLS MEDLINE citations and annotations fetch API

Description

This API allows to retrieve annotated contents from MEDLINE. The input is a set of pmids (up to 1,000 per request). The output is a set of parsed and annotated citations, in both JATS and BioC formats. Delivered and annotated fields include for example abstracts, or MeSH terms. Annotations are delivered with many features including the type of the mapped entity (drug, gene, disease...), the vocabulary used, the vocabulary unique identifier and preferred term, or the mapping characters offsets.

API endpoint :

candy.hesge.ch/SIBiLS/MEDLINE/fetch.jsp

Mandatory input : the list of requested PMIDs (&ids=). PMIDs are separated by any non-digit character.

Example : fetch two PMIDs

candy.hesge.ch/SIBiLS/MEDLINE/fetch.jsp?ids=14691011,25190367

Code sample : python script for demonstrating POST calls to the API is available at candy.hesge.ch/SIBiLS/MEDLINE/MEDLINE_fetch_POST_examples.py

Output

Output is BioC json formatted :

{"documents": 
	[Array of documents corresponding to the query]
		{"infons": 
			[Array of PubMed like informations about the document]
		{"passages": 
			[Array of passages splitted from the document]
			{"infons": 
				[Array of informations relative to the passage]
				{"type": nature of the passage (e.g. "title", "abstract")
			{"text": the passage
			{"annotations": 
				[Array of annotations relative to the passage]
				{"text": concept annotated
				{"infons": 
					[Array of informations about each annotation]
					{"type": type of entity (text) matched
					{"source": terminology used
					{"source_id": ID from the terminology
					{"searchable_id": code(terminology)+";"+ source_id
					{"prefered_term": prefered_term extracted from the terminology
					{"sentence": sentence where the text is found
				{"locations":
					{"offset": start position of the text in the sentence
					{"length": length of the text annotated










Creative Commons License

Tagged entities are licensed under a Creative Commons Attribution 3.0 Switzerland License.

Questions specifically relating to these services may be sent to julien.gobeill@hesge.ch.