Please note that the API is currently still under development and is subject to changes.
The following methods are currently available via our XML REST-like API, accessible through HTTP GET requests:
Given a concept's ID, get information on this concept.
This methods returns information on a concept, such as synonyms, concept type and a definition, provided by its ID.
Prioritize target concepts to a source concept.
This method ranks target concepts in the context of a source concept, for example, to rank genes in the context of a disease. For each of the targets, the response provides the ranking score and ranking statistics of the concepts among all concepts and among all concepts of the target's type. Information on its directness and a link to an explanation of the ranking are also provided. Ranked targets are sorted by their ranking score, ordered by their decreasing ranking score.
Prioritize gene target concepts to a source concept.
This method wraps the rank method by first searching the targets as HUGO gene names and converting them to IDs (as in search). This method then redirects to the rank method with a 302 HTTP response status. Gene names that are not found in our database are ignored during the redirection since these cannot be ranked.
Find related concepts to a source concept.
Returns the top (maximum 100) related concepts for a source concept. Optionally, only concepts of a certain type or concepts that are known to be related or inferred can be returned. Related concepts are annotated with their ID, ranking score, preferred synonym, type, directness and a link to an explanation of the relation between source and target. Concepts are ordered by decreasing ranking score, putting the most related concept first.
Search for the ID of a concept.
If the requested query matches the preferred synonym of a concept, this ID of the concept as used by BioGraph is returned. If multiple concept have a preferred synonym that exactly matches the query, all these concepts are returned. Otherwise, the search engine returns all concepts for which one of its synonyms matches. If still no concepts have been found, all concepts whose synonyms match the query as a substring are returned. Returned concepts are sorted by their network importance (in similarity to PageRank). Search results are limited to the top 10 items.