How Can We Help?
Orpheus Knowledge GraphQL API
Table of Content
This is the GraphQL API that allows users to search, query and explore the Orpheus Biomedical Knowledge Graph. It contains millions of biomedical entities and billions of facts about them collected using multiple data sources. Here are some of the main API categories a developer can utilize:
In order to access this API, you need an API Key, which you can request here
After which you need to pass it in as part of the header like so:
AUTHORIZATION API Key
Key x-api-key
Value xxxx-xxxx-xxxxx
Query
Set of APIs that allow the user to query the graph using either natural language or SPARQL
POST Advanced Graph query
https://api.wisecube.ai/orpheus/graphqlThis API allows querying the knowledge graph using SPARQL. Refer to the examples on how to query the graph.
Example Request Drugs by same active ingredient
POST /orpheus/graphql HTTP/1.1
Host: api.wisecube.ai
Content-Type: application/json
Content-Length: 1324
{"query":"query advancedSearchQuery($sparql: String) {\n advancedSearch(query: $sparql) {\n description\n columns\n rows {\n values\n __typename\n }\n error\n __typename\n }\n}","variables":{"sparql":"SELECT%20DISTINCT%0A%3Fquery_product%20%3Fquery_productLabel%0A%3Fquery_ingredient%20%3Fquery_ingredientLabel%0A%3Fresult_product%20%3Fresult_productLabel%0A%0AWHERE%0A%7B%0A%20%20VALUES%20%3Fquery_product%20%7B%20wd%3AQ48828846%20%7D%20.%20%23%20Emgel%0A%20%20%3Fquery_product%20wdt%3AP31%20wd%3AQ28885102%20.%0A%20%20%3Fquery_product%20wdt%3AP3781%20%3Fquery_ingredient%20.%0A%20%20%0A%20%20%3Fresult_product%20wdt%3AP31%20wd%3AQ28885102%20.%0A%20%20%3Fresult_product%20wdt%3AP3781%20%3Fquery_ingredient%20.%0A%20%20%0A%20%20%3Fquery_product%20rdfs%3Alabel%20%3Fquery_productLabel%20.%20%0A%20%20FILTER(%20LANG(%3Fquery_productLabel)%20%3D%20%22en%22)%0A%20%20%0A%20%20%3Fquery_ingredient%20rdfs%3Alabel%20%3Fquery_ingredientLabel%20.%20%0A%20%20FILTER(%20LANG(%3Fquery_ingredientLabel)%20%3D%20%22en%22)%0A%20%20%0A%20%20%3Fresult_product%20rdfs%3Alabel%20%3Fresult_productLabel%20.%20%0A%20%20FILTER(%20LANG(%3Fresult_productLabel)%20%3D%20%22en%22)%0A%20%20%0A%20%20%3Fquery_ingredient%20%3Fprop%20%3Fresult_product%20.%20%0A%0A%7D%20LIMIT%20100"}}Example Response
{
"data": {
"advancedSearch": {
"description": "Dataframe results",
"columns": ["query_product", "query_productLabel", "query_ingredient", "query_ingredientLabel", "result_product", "result_productLabel"],
"rows": [{
"values": ["http://www.wikidata.org/entity/Q48828846", "Emgel", "http://www.wikidata.org/entity/Q213511", "erythromycin", "http://www.wikidata.org/entity/Q48829307", "E.E.S."],
"__typename": "Row"
}, {
"values": ["http://www.wikidata.org/entity/Q48828846", "Emgel", "http://www.wikidata.org/entity/Q213511", "erythromycin", "http://www.wikidata.org/entity/Q48828846", "Emgel"],
"__typename": "Row"
}, {
"values": ["http://www.wikidata.org/entity/Q48828846", "Emgel", "http://www.wikidata.org/entity/Q213511", "erythromycin", "http://www.wikidata.org/entity/Q48826422", "Ery"],
"__typename": "Row"
}, {
"values": ["http://www.wikidata.org/entity/Q48828846", "Emgel", "http://www.wikidata.org/entity/Q213511", "erythromycin", "http://www.wikidata.org/entity/Q47521563", "EryPed"],
"__typename": "Row"
}, {
"values": ["http://www.wikidata.org/entity/Q48828846", "Emgel", "http://www.wikidata.org/entity/Q213511", "erythromycin", "http://www.wikidata.org/entity/Q47521564", "Ery-Tab"],
"__typename": "Row"
}, {
"values": ["http://www.wikidata.org/entity/Q48828846", "Emgel", "http://www.wikidata.org/entity/Q213511", "erythromycin", "http://www.wikidata.org/entity/Q48826381", "PCE"],
"__typename": "Row"
}, {
"values": ["http://www.wikidata.org/entity/Q48828846", "Emgel", "http://www.wikidata.org/entity/Q213511", "erythromycin", "http://www.wikidata.org/entity/Q47521566", "Erythrocin"],
"__typename": "Row"
}, {
"values": ["http://www.wikidata.org/entity/Q48828846", "Emgel", "http://www.wikidata.org/entity/Q213511", "erythromycin", "http://www.wikidata.org/entity/Q47521565", "Erygel"],
"__typename": "Row"
}, {
"values": ["http://www.wikidata.org/entity/Q48828846", "Emgel", "http://www.wikidata.org/entity/Q213511", "erythromycin", "http://www.wikidata.org/entity/Q47521567", "Erythrocin Stearate"],
"__typename": "Row"
}, {
"values": ["http://www.wikidata.org/entity/Q48828846", "Emgel", "http://www.wikidata.org/entity/Q213511", "erythromycin", "http://www.wikidata.org/entity/Q48826464", "Emcin Clear"],
"__typename": "Row"
}],
"error": null,
"__typename": "DataFrame"
}
}
}
POST Advanced Graph Wikidata Schema
https://api.wisecube.ai/orpheus/graphqlThis API allows querying the knowledge graph using SPARQL. Refer to the examples on how to query the graph.
BODY graphql
QUERY
{ advancedSearchGraph(query: "#%23 How is Hsd17b1 associated with endometriosis%3F%0A SELECT DISTINCT %3Fgene %3FgeneLabel %3Fprotein %3FproteinLabel %3Fbiological_process %3Fbiological_processLabel%0AWHERE %0A{%0A%20 %3Fgene wdt%3AP279* wd%3AQ18027312.%0A%20 %0A%20 %3Fgene wdt%3AP688 | ^wdt%3AP702 %3Fprotein.%0A%20%20 %0A%20 {%3Fgene%20 wdt%3AP682 %3Fbiological_process .}%0A%20 UNION%0A%20 {%3Fprotein wdt%3AP682%20 %3Fbiological_process }%0A%20 %0A}"){ head results } }GRAPHQL VARIABLES
{ "sparql":"refer_to_examples_for_URL_encoded_SPARQL_queries" }
Example Request Drugs by same active ingredient
POST /orpheus/graphql HTTP/1.1
Host: api.wisecube.ai
Content-Type: application/json
Content-Length: 1324
{"query":"query advancedSearchQuery($sparql: String) {\n advancedSearch(query: $sparql) {\n description\n columns\n rows {\n values\n __typename\n }\n error\n __typename\n }\n}","variables":{"sparql":"SELECT%20DISTINCT%0A%3Fquery_product%20%3Fquery_productLabel%0A%3Fquery_ingredient%20%3Fquery_ingredientLabel%0A%3Fresult_product%20%3Fresult_productLabel%0A%0AWHERE%0A%7B%0A%20%20VALUES%20%3Fquery_product%20%7B%20wd%3AQ48828846%20%7D%20.%20%23%20Emgel%0A%20%20%3Fquery_product%20wdt%3AP31%20wd%3AQ28885102%20.%0A%20%20%3Fquery_product%20wdt%3AP3781%20%3Fquery_ingredient%20.%0A%20%20%0A%20%20%3Fresult_product%20wdt%3AP31%20wd%3AQ28885102%20.%0A%20%20%3Fresult_product%20wdt%3AP3781%20%3Fquery_ingredient%20.%0A%20%20%0A%20%20%3Fquery_product%20rdfs%3Alabel%20%3Fquery_productLabel%20.%20%0A%20%20FILTER(%20LANG(%3Fquery_productLabel)%20%3D%20%22en%22)%0A%20%20%0A%20%20%3Fquery_ingredient%20rdfs%3Alabel%20%3Fquery_ingredientLabel%20.%20%0A%20%20FILTER(%20LANG(%3Fquery_ingredientLabel)%20%3D%20%22en%22)%0A%20%20%0A%20%20%3Fresult_product%20rdfs%3Alabel%20%3Fresult_productLabel%20.%20%0A%20%20FILTER(%20LANG(%3Fresult_productLabel)%20%3D%20%22en%22)%0A%20%20%0A%20%20%3Fquery_ingredient%20%3Fprop%20%3Fresult_product%20.%20%0A%0A%7D%20LIMIT%20100"}}Example Response
{
"data": {
"advancedSearch": {
"description": "Dataframe results",
"columns": [
"query_product",
"query_productLabel",
"query_ingredient",
"query_ingredientLabel",
"result_product",
"result_productLabel"
],
"rows": [{
"values": [
"http://www.wikidata.org/entity/Q48828846",
"Emgel",
"http://www.wikidata.org/entity/Q213511",
"erythromycin",
"http://www.wikidata.org/entity/Q48829307",
"E.E.S."
],
"__typename": "Row"
},
{
"values": [
"http://www.wikidata.org/entity/Q48828846",
"Emgel",
"http://www.wikidata.org/entity/Q213511",
"erythromycin",
"http://www.wikidata.org/entity/Q48828846",
"Emgel"
],
"__typename": "Row"
},
{
"values": [
"http://www.wikidata.org/entity/Q48828846",
"Emgel",
"http://www.wikidata.org/entity/Q213511",
"erythromycin",
"http://www.wikidata.org/entity/Q48826422",
"Ery"
],
"__typename": "Row"
},
{
"values": [
"http://www.wikidata.org/entity/Q48828846",
"Emgel",
"http://www.wikidata.org/entity/Q213511",
"erythromycin",
"http://www.wikidata.org/entity/Q47521563",
"EryPed"
],
"__typename": "Row"
},
{
"values": [
"http://www.wikidata.org/entity/Q48828846",
"Emgel",
"http://www.wikidata.org/entity/Q213511",
"erythromycin",
"http://www.wikidata.org/entity/Q47521564",
"Ery-Tab"
],
"__typename": "Row"
},
{
"values": [
"http://www.wikidata.org/entity/Q48828846",
"Emgel",
"http://www.wikidata.org/entity/Q213511",
"erythromycin",
"http://www.wikidata.org/entity/Q48826381",
"PCE"
],
"__typename": "Row"
},
{
"values": [
"http://www.wikidata.org/entity/Q48828846",
"Emgel",
"http://www.wikidata.org/entity/Q213511",
"erythromycin",
"http://www.wikidata.org/entity/Q47521566",
"Erythrocin"
],
"__typename": "Row"
},
{
"values": [
"http://www.wikidata.org/entity/Q48828846",
"Emgel",
"http://www.wikidata.org/entity/Q213511",
"erythromycin",
"http://www.wikidata.org/entity/Q47521565",
"Erygel"
],
"__typename": "Row"
},
{
"values": [
"http://www.wikidata.org/entity/Q48828846",
"Emgel",
"http://www.wikidata.org/entity/Q213511",
"erythromycin",
"http://www.wikidata.org/entity/Q47521567",
"Erythrocin Stearate"
],
"__typename": "Row"
},
{
"values": [
"http://www.wikidata.org/entity/Q48828846",
"Emgel",
"http://www.wikidata.org/entity/Q213511",
"erythromycin",
"http://www.wikidata.org/entity/Q48826464",
"Emcin Clear"
],
"__typename": "Row"
}
],
"error": null,
"__typename": "DataFrame"
}
}
}
POST Natural language query
https://api.wisecube.ai/orpheus/graphqlThis API allows querying the knowledge graph using natural language queries.
BODY graphql
QUERY
query questionAnswer($query: String) { summaryInsights(engineID:"orpheus", searchInput: { query: $query, type: [QA]}) { data { __typename ... on QAInsight { question answer context took probability __typename } } __typename } }GRAPHQL VARIABLES
{ "query" : "natural language query" }Example Request. Informational query
POST /orpheus/graphql HTTP/1.1
Host: api.wisecube.ai
Content-Type: application/json
Content-Length: 387
{"query":"query searchEntity($searchText: String) {\n searchAsYouType(\n searchInput: { searchText: $searchText, type: SEARCH_LABEL }\n ) {\n description\n type\n data {\n __typename\n ... on SearchLabels {\n searchLabels {\n qid\n text\n nodeTypes\n }\n }\n }\n }\n}","variables":{"searchText":"what is cancer"}}Example Response
{ "data": { "summaryInsights": [ { "data": { "__typename": "QAInsight", "question": "what is cancer", "answer": "lack of efficient coordination of the experimental, theoretical and computational research work on a worldwide scale is one of the most pressing barriers to cancer research", "context": "Abstract Q : What would you say is the primary focus of your research effort ( how do you refer to your ‘ subarea ’ )? A : In Silico Oncology Q : What do you consider to be the most significant open questions and research challenges in cancer informatics? Q : What do you consider to be the most pressing challenges or barriers to success in cancer research? A : I consider <em>lack of efficient coordination of the experimental, theoretical and computational research work on a worldwide scale is one of the most pressing barriers to cancer research</em> . Resolving this paradox requires discourse among open minds, and Cancer Informatics is an important start in facilitating such discussions. Q : What do you consider to be the most significant developments as a result of cancer research? Q : What books do you think should be required of researchers involved in informatics? In cancer research? Q : If you could change three things about how informatics research is conducted, used, perceived, or resourced, what would they be", "took": 1.0102505683898926, "probability": "0.2743223449215293" }, "__typename": "Insight" } ] } }
Search
Search based APIs that support querying the knowledge graph for Entities and/or Articles
POST Search Entities
https://api.wisecube.ai/orpheus/graphqlAllows users to search for entities matching the query term from the knowledge graph
BODY graphql
QUERY
query searchEntity($searchText: String) { searchAsYouType( searchInput: { searchText: $searchText, type: SEARCH_LABEL } ) { description type data { __typename ... on SearchLabels { searchLabels { qid text nodeTypes } } } } }GRAPHQL VARIABLES
{ "searchText" : "diabetes" }Example Request. Search Entities
POST /orpheus/graphql HTTP/1.1
Host: api.wisecube.ai
Content-Type: application/json
Content-Length: 381
{"query":"query searchEntity($searchText: String) {\n searchAsYouType(\n searchInput: { searchText: $searchText, type: SEARCH_LABEL }\n ) {\n description\n type\n data {\n __typename\n ... on SearchLabels {\n searchLabels {\n qid\n text\n nodeTypes\n }\n }\n }\n }\n}","variables":{"searchText":"diabetes"}}
POST Search Articles
https://api.wisecube.ai/orpheus/graphqlAllows searching articles matching the query term from the knowledge graph
BODY graphql
QUERY
query searchArticles($query: String, $entityFilter: String, $dateRange: [String], $hasFullText: Boolean, $publicationType: String, $authorNames: [String], $sortOrder: String, $pageNumber: Int, $pageSize: Int, $doi: String) { searchInsights( engineID:"orpheus", searchInput: {query: $query, entityFilter: $entityFilter, dateRange: $dateRange, hasFullText: $hasFullText, publicationType: $publicationType, authorNames: $authorNames, sortOrder: $sortOrder, pageNumber: $pageNumber, pageSize: $pageSize, doi: $doi} ) { data { __typename ... on TextResults { totalItems totalPages questionText infoText documents { id doi title authors { lastName firstName __typename } publishDate documentID summaryText __typename } __typename } } __typename } }GRAPHQL VARIABLES
{ "query": "COVID-19", "pageNumber": 1, "pageSize": 10 }
Example Request Search Articles
POST /orpheus/graphql HTTP/1.1
Host: api.wisecube.ai
Content-Type: application/json
Content-Length: 1643
{"query":"query searchArticles($query: String, $entityFilter: String, $dateRange: [String], $hasFullText: Boolean, $publicationType: String, $authorNames: [String], $sortOrder: String, $pageNumber: Int, $pageSize: Int, $doi: String) {\n searchInsights(\n engineID:\"orpheus\",\n searchInput: {query: $query, entityFilter: $entityFilter, dateRange: $dateRange, hasFullText: $hasFullText, publicationType: $publicationType, authorNames: $authorNames, sortOrder: $sortOrder, pageNumber: $pageNumber, pageSize: $pageSize, doi: $doi}\n ) {\n data {\n __typename\n ... on TextResults {\n totalItems\n totalPages\n questionText\n infoText\n documents {\n id\n doi\n title\n authors {\n lastName\n firstName\n __typename\n }\n publishDate\n documentID\n summaryText\n __typename\n }\n __typename\n }\n }\n __typename\n }\n }\n ","variables":{"query":"COVID-19","pageNumber":1,"pageSize":10}}
Discover
Set of APIs that return pre-built Insights/Analytics from the knowledge graph.
POST Top Affiliations
https://api.wisecube.ai/orpheus/graphqlThis API returns the most relevant affiliations related to the query term
BODY graphql
QUERY
query TopAffiliations($query: String) { summaryInsights( engineID: "orpheus" searchInput: {query: $query, type: [AFFILIATIONS]} ) { id description data { __typename ... on Affiliations { affiliations { id name description location __typename } __typename } } __typename } }GRAPHQL VARIABLES
{ "query" : "query_term" }Example Request Top Affiliations for Covid
POST /orpheus/graphql HTTP/1.1
Host: api.wisecube.ai
Content-Type: application/json
Content-Length: 467
{"query":"query TopAffiliations($query: String) {\n summaryInsights(\n engineID: \"orpheus\"\n searchInput: {query: $query, type: [AFFILIATIONS]}\n ) {\n id\n description\n data {\n __typename\n ... on Affiliations {\n affiliations {\n id\n name\n description\n location\n __typename\n }\n __typename\n }\n }\n __typename\n }\n}\n","variables":{"query":"covid"}}Example Response
{
"data": {
"summaryInsights": [{
"id": "1",
"description": "Affiliations associated with the selected term",
"data": {
"__typename": "Affiliations",
"affiliations": [{
"id": "1",
"name": "CDC COVID-19 Response Team.",
"description": null,
"location": null,
"__typename": "Organization"
},
{
"id": "2",
"name": "CDC COVID-19 Emergency Response.",
"description": null,
"location": null,
"__typename": "Organization"
},
{
"id": "3",
"name": "Department of Infectious Diseases and Clinical Microbiology",
"description": " Faculty of Medicine",
"location": " Ankara Turkey",
"__typename": "Organization"
},
{
"id": "4",
"name": "Japan ECMOnet for COVID-19 Japanese Society of Intensive Care Medicine",
"description": " the Japanese Association for Acute Medicine",
"location": " https://jintensivecare.biomedcentral.com/articles/10.1186/s40560-020-00440-9",
"__typename": "Organization"
},
{
"id": "5",
"name": "grid.414026.5 0000 0004 0419 4084 Division of Cardiology",
"description": " Atlanta VA Medical Center",
"location": " GA USA",
"__typename": "Organization"
},
{
"id": "6",
"name": "grid.145695.a Graduate Institute of Clinical Medical Sciences",
"description": " Chang Gung University",
"location": " Taiwan",
"__typename": "Organization"
},
{
"id": "7",
"name": "grid.412301.5 0000 0000 8653 1507 Division of Infection Control and Infectious Diseases",
"description": " Medical Faculty",
"location": " Germany",
"__typename": "Organization"
},
{
"id": "8",
"name": "grid.18887.3e 0000000417581884 Emergency Medicine CoViD-19 Unit",
"description": " Sant’Andrea University Hospital",
"location": " Italy",
"__typename": "Organization"
},
{
"id": "9",
"name": "Department of Mental Health and Public Medicine",
"description": " Centro COVID A.O.U. Vanvitelli",
"location": " Italy",
"__typename": "Organization"
},
{
"id": "10",
"name": "Internal Medicine",
"description": " Sant’Ottone Frangipane Hospital",
"location": " Italy",
"__typename": "Organization"
}
]
},
"__typename": "Insight"
}]
}
}
POST Top Authors
https://api.wisecube.ai/orpheus/graphqlThis API returns the most relevant authors related to the query term
BODY graphql
QUERY
query TopAuthors($query: String) { summaryInsights( engineID: "orpheus" searchInput: {query: $query, type: [AUTHORS]} ) { id description data { __typename ... on Authors { authors { id firstName lastName middleName __typename } __typename } } __typename } }GRAPHQL VARIABLES
{ "query" : "query_term" }Example Request Top Authors for cancer
POST /orpheus/graphql HTTP/1.1
Host: api.wisecube.ai
Content-Type: application/json
Content-Length: 652
{"query":"query TopAuthors($query: String) {\n summaryInsights(\n engineID: \"orpheus\"\n searchInput: {query: $query, type: [AUTHORS]}\n ) {\n id\n description\n data {\n __typename\n ... on Authors {\n authors {\n id\n firstName\n lastName\n middleName\n __typename\n }\n __typename\n }\n }\n __typename\n }\n }","variables":{"query":"cancer"}}Example Response
{
"data": {
"summaryInsights": [
{
"id": "1",
"description": "Top Authors/People associated with the selected term",
"data": {
"__typename": "Authors",
"authors": [
{
"id": "1",
"firstName": "Kerry S",
"lastName": "Courneya",
"middleName": null,
"__typename": "Person"
},
{
"id": "2",
"firstName": "Alice",
"lastName": "Cancer",
"middleName": null,
"__typename": "Person"
},
{
"id": "3",
"firstName": "Alessandro",
"lastName": "Antonietti",
"middleName": null,
"__typename": "Person"
},
{
"id": "4",
"firstName": "Claudia",
"lastName": "Canella",
"middleName": null,
"__typename": "Person"
},
{
"id": "5",
"firstName": "Mariët",
"lastName": "Hagedoorn",
"middleName": null,
"__typename": "Person"
},
{
"id": "6",
"firstName": "Fang Fang",
"lastName": "Zhang",
"middleName": null,
"__typename": "Person"
},
{
"id": "7",
"firstName": "Silvia",
"lastName": "Bonacina",
"middleName": null,
"__typename": "Person"
},
{
"id": "8",
"firstName": "Caroline",
"lastName": "Drewes",
"middleName": null,
"__typename": "Person"
},
{
"id": "9",
"firstName": "Gary L",
"lastName": "Kreps",
"middleName": null,
"__typename": "Person"
},
{
"id": "10",
"firstName": "Winnie",
"lastName": "Chang",
"middleName": null,
"__typename": "Person"
}
]
},
"__typename": "Insight"
}
]
}
}
POST Top Entities
https://api.wisecube.ai/orpheus/graphqlThis API returns the most relevant entities related to the query term
BODY graphql
QUERY
query InsightDetails($query: String) { summaryInsights( engineID: "orpheus" searchInput: {query: $query, type: [ENTITYVIZ]} ) { id data { __typename ... on EntityViz { entityviz { key value __typename } __typename } } __typename } }GRAPHQL VARIABLES
{ "query" : "query_term" }Example Request Top Entities in cancer
POST /orpheus/graphql HTTP/1.1
Host: api.wisecube.ai
Content-Type: application/json
Content-Length: 398
{"query":"query InsightDetails($query: String) {\n summaryInsights(\n engineID: \"orpheus\"\n searchInput: {query: $query, type: [ENTITYVIZ]}\n ) {\n id\n data {\n __typename\n ... on EntityViz {\n entityviz {\n key\n value\n __typename\n }\n __typename\n }\n }\n __typename\n }\n}","variables":{"query":"cancer"}}Example Response
{
"data": {
"summaryInsights": [{
"id": "1",
"data": {
"__typename": "EntityViz",
"entityviz": [{
"key": "C1QL1",
"value": 19,
"__typename": "ChartMap"
},
{
"key": "BRCA1",
"value": 9,
"__typename": "ChartMap"
},
{
"key": "CTSB",
"value": 6,
"__typename": "ChartMap"
},
{
"key": "tamoxifen",
"value": 5,
"__typename": "ChartMap"
},
{
"key": "KLK3",
"value": 5,
"__typename": "ChartMap"
},
{
"key": "S100A10",
"value": 4,
"__typename": "ChartMap"
},
{
"key": "ERBB2",
"value": 4,
"__typename": "ChartMap"
},
{
"key": "alcohols",
"value": 4,
"__typename": "ChartMap"
},
{
"key": "CRP",
"value": 4,
"__typename": "ChartMap"
},
{
"key": "BRCA2",
"value": 4,
"__typename": "ChartMap"
},
{
"key": "H3P4",
"value": 4,
"__typename": "ChartMap"
},
{
"key": "CTAG2",
"value": 4,
"__typename": "ChartMap"
},
{
"key": "sodium lauryl sulfate",
"value": 4,
"__typename": "ChartMap"
},
{
"key": "adenosine triphosphate",
"value": 3,
"__typename": "ChartMap"
},
{
"key": "MOS",
"value": 3,
"__typename": "ChartMap"
},
{
"key": "water",
"value": 3,
"__typename": "ChartMap"
},
{
"key": "steroid",
"value": 3,
"__typename": "ChartMap"
},
{
"key": "REG1A",
"value": 3,
"__typename": "ChartMap"
},
{
"key": "H3-2",
"value": 3,
"__typename": "ChartMap"
},
{
"key": "TENM1",
"value": 3,
"__typename": "ChartMap"
}
]
},
"__typename": "Insight"
}]
}
}
POST Emerging Concepts
https://api.wisecube.ai/orpheus/graphqlThis API returns the most relevant concepts related to the query term
BODY graphql
QUERY
query InsightDetails($query: String) { summaryInsights( engineID: "orpheus" searchInput: {query: $query, type: [TOPICS, ENTITYVIZ]} ) { id data { __typename ... on Topics { topics { label xCoordinate yCoordinate __typename } __typename } __typename ... on EntityViz { entityviz { key value __typename } __typename } } __typename } }GRAPHQL VARIABLES
{ "query": "query_term" }Example Request Emerging Concepts for diabetes
POST /orpheus/graphql HTTP/1.1
Host: api.wisecube.ai
Content-Type: application/json
Content-Length: 592
{"query":"query InsightDetails($query: String) {\n summaryInsights(\n engineID: \"orpheus\"\n searchInput: {query: $query, type: [TOPICS, ENTITYVIZ]}\n ) {\n id\n data {\n __typename\n ... on Topics {\n topics {\n label\n xCoordinate\n yCoordinate\n __typename\n }\n __typename\n }\n __typename\n ... on EntityViz {\n entityviz {\n key\n value\n __typename\n }\n __typename\n }\n }\n __typename\n }\n}","variables":{"query":"diabetes"}}Example Response
{
"data": {
"summaryInsights": [
{
"id": "1",
"data": {
"__typename": "Topics",
"topics": [
{
"label": "Banti's disease",
"xCoordinate": 2.7959415483688694,
"yCoordinate": -1.6057443839477004,
"__typename": "TopicDocument"
},
{
"label": "CMMR-D syndrome",
"xCoordinate": 1.3674592929822176,
"yCoordinate": -1.6907279042903403,
"__typename": "TopicDocument"
},
{
"label": "Alopecia-deafness-hypogonadism syndrome",
"xCoordinate": 1.3674592929822176,
"yCoordinate": -1.6907279042903403,
"__typename": "TopicDocument"
},
{
"label": "isopanose metabolism",
"xCoordinate": 1.6104566421951718,
"yCoordinate": -3.324113408570418,
"__typename": "TopicDocument"
},
{
"label": "Cohort Study Investigating the Association Between Antichlamydial Antibody Positivity and Efficiency of Treatment With Assisted Reproduction Technologies (ART) in Women With Tubal Factor Infertility",
"xCoordinate": -0.3257072783892463,
"yCoordinate": 1.021249435477209,
"__typename": "TopicDocument"
},
{
"label": "Caring for Caregivers: Supporting Caregivers of Youth With Spinal Cord Injury",
"xCoordinate": -0.36169706326632534,
"yCoordinate": 1.4659344737250604,
"__typename": "TopicDocument"
},
{
"label": "Carfilzomib With Bendamustine and Rituximab in Patients With Relapsed or Refractory Non-Hodgkin Lymphoma",
"xCoordinate": -0.8962524767250911,
"yCoordinate": -0.007659329515009181,
"__typename": "TopicDocument"
},
{
"label": "Cold shock transcription regulator KVU_1017",
"xCoordinate": 0.41938697603516556,
"yCoordinate": -0.55905503688916,
"__typename": "TopicDocument"
}
]
},
"__typename": "Insight"
},
{
"id": "2",
"data": {
"__typename": "EntityViz",
"entityviz": [
{
"key": "glucose",
"value": 59,
"__typename": "ChartMap"
},
{
"key": "microvascular complications of diabetes, susceptibility",
"value": 55,
"__typename": "ChartMap"
},
{
"key": "INS",
"value": 53,
"__typename": "ChartMap"
},
{
"key": "HBA1",
"value": 29,
"__typename": "ChartMap"
},
{
"key": "Q43656",
"value": 19,
"__typename": "ChartMap"
},
{
"key": "metformin",
"value": 15,
"__typename": "ChartMap"
},
{
"key": "alcohols",
"value": 15,
"__typename": "ChartMap"
},
{
"key": "inclusion-cell disease",
"value": 14,
"__typename": "ChartMap"
},
{
"key": "triglyceride",
"value": 12,
"__typename": "ChartMap"
},
{
"key": "creatinine",
"value": 11,
"__typename": "ChartMap"
},
{
"key": "carbohydrate",
"value": 11,
"__typename": "ChartMap"
},
{
"key": "fluorescein",
"value": 8,
"__typename": "ChartMap"
},
{
"key": "water",
"value": 6,
"__typename": "ChartMap"
},
{
"key": "DAPK3",
"value": 6,
"__typename": "ChartMap"
},
{
"key": "CTSB",
"value": 5,
"__typename": "ChartMap"
},
{
"key": "acropectorovertebral dysplasia",
"value": 5,
"__typename": "ChartMap"
},
{
"key": "CNBP",
"value": 4,
"__typename": "ChartMap"
},
{
"key": "CD59",
"value": 4,
"__typename": "ChartMap"
},
{
"key": "tropicamide",
"value": 4,
"__typename": "ChartMap"
},
{
"key": "VEGFA",
"value": 3,
"__typename": "ChartMap"
}
]
},
"__typename": "Insight"
}
]
}
}
Explore
APIs that allow navigating/exploring the Knowledge graph directly given a specific Entity in the graph
POST Lookup Entity Neighbors
https://api.wisecube.ai/orpheus/graphqlThis API returns the most immediate neighbors of an entity from the knowledge graph
BODY graphql
QUERY
query graphInsights($startNode: ID, $startNodeName: String, $nodeTypes: [NodeType], $maxNeighbors: Int) { graphInsights( engineID: "orpheus" graphInput: {startNode: $startNode, startNodeName: $startNodeName, nodeTypes: $nodeTypes, maxNeighbors: $maxNeighbors} ) { description data { __typename ... on SubGraph { description nodes { id name type properties { name values __typename } __typename } edges { id start { id __typename } end { id __typename } __typename } } __typename } } }GRAPHQL VARIABLES
{ "startNode":"graph_entity_id", "maxNeighbours":20 }Lookup Entity by name Example Request
POST /orpheus/graphql HTTP/1.1
Host: api.wisecube.ai
Content-Type: application/json
Content-Length: 1824
{"query":"query graphInsights($startNode: ID, $startNodeName: String, $nodeTypes: [NodeType], $maxNeighbors: Int) {\n graphInsights(\n engineID: \n \"orpheus\"\n graphInput: {startNode: $startNode, startNodeName: $startNodeName, nodeTypes: $nodeTypes, maxNeighbors: $maxNeighbors}\n ) {\n description\n data {\n __typename\n ... on SubGraph {\n description\n nodes {\n id\n name\n type\n properties {\n name \n values \n __typename\n }\n __typename\n }\n edges {\n id\n start {\n id\n __typename\n }\n end { \n id\n __typename\n }\n __typename\n }\n }\n __typename\n }\n }\n }","variables":{"startNodeName":"COVID-19","maxNeighbours":20}}Example Response
{
"data": {
"nodeProperties": {
"properties": [
{
"name": "core#altLabel",
"values": [
"SARS-CoV-2 infection"
]
},
{
"name": "core#altLabel",
"values": [
"2019 NCP"
]
},
{
"name": "core#altLabel",
"values": [
"2019 novel coronavirus pneumonia"
]
},
{
"name": "core#altLabel",
"values": [
"2019 novel coronavirus respiratory syndrome"
]
},
{
"name": "core#altLabel",
"values": [
"2019-nCoV acute respiratory disease"
]
},
{
"name": "core#altLabel",
"values": [
"CD-19"
]
},
{
"name": "core#altLabel",
"values": [
"coronavirus disease 2019"
]
},
{
"name": "core#altLabel",
"values": [
"Coronavirus disease 2019"
]
},
{
"name": "core#altLabel",
"values": [
"COVID 19"
]
},
{
"name": "core#altLabel",
"values": [
"COVID-2019"
]
},
{
"name": "core#altLabel",
"values": [
"nCOVD 19"
]
},
{
"name": "core#altLabel",
"values": [
"nCOVD-19"
]
},
{
"name": "core#altLabel",
"values": [
"nCOVD19"
]
},
{
"name": "core#altLabel",
"values": [
"Novel Coronavirus Pneumonia"
]
},
{
"name": "core#altLabel",
"values": [
"seafood market pneumonia"
]
},
{
"name": "core#altLabel",
"values": [
"severe acute respiratory syndrome type 2"
]
},
{
"name": "core#altLabel",
"values": [
"Wuhan pneumonia"
]
},
{
"name": "core#altLabel",
"values": [
"Wuhan respiratory syndrome"
]
},
{
"name": "core#altLabel",
"values": [
"WuRS"
]
},
{
"name": "core#altLabel",
"values": [
"Severe Acute Respiratory Syndrome Coronavirus 2"
]
},
{
"name": "core#altLabel",
"values": [
"COVID19"
]
},
{
"name": "core#altLabel",
"values": [
"COVID"
]
},
{
"name": "core#altLabel",
"values": [
"Covid-19"
]
},
{
"name": "core#altLabel",
"values": [
"SARS-CoV-2"
]
},
{
"name": "P1448",
"values": [
"coronavirus disease"
]
},
{
"name": "P1813",
"values": [
"COVID-19"
]
}
]
}
}
}
POST Lookup Entity Properties
https://api.wisecube.ai/orpheus/graphqlReturns the properties of a specific entity in the knowledge graph
BODY graphql
QUERY
query nodeProperties($startNode: ID, $maxNeighbors: Int, $engineID: String, $nodeTypes: [NodeType]) { nodeProperties ( engineID: $engineID, graphInput: {startNode: $startNode, nodeTypes:$nodeTypes, maxNeighbors:$maxNeighbors} ) { properties { name values } } }GRAPHQL VARIABLES
{ "engineID": "orpheus", "startNode":"entity_id", "maxNeighbors":20, "nodeTypes": "NODETYPE" }Example Request Lookup COVID-19 properties
POST /orpheus/graphql HTTP/1.1
Host: api.wisecube.ai
Content-Type: application/json
Content-Length: 443
{"query":"query nodeProperties($startNode: ID, $maxNeighbors: Int, $engineID: String, $nodeTypes: [NodeType]) {\n nodeProperties (\n engineID: $engineID,\n graphInput: {startNode: $startNode, nodeTypes:$nodeTypes, maxNeighbors:$maxNeighbors}\n\n ) {\n properties {\n name\n values\n }\n }\n}","variables":{"engineID":"orpheus","startNode":"Q84263196","maxNeighbors":20,"nodeTypes":"DISEASE"}}Example Response
{
"data": {
"nodeProperties": {
"properties": [
{
"name": "core#altLabel",
"values": [
"SARS-CoV-2 infection"
]
},
{
"name": "core#altLabel",
"values": [
"2019 NCP"
]
},
{
"name": "core#altLabel",
"values": [
"2019 novel coronavirus pneumonia"
]
},
{
"name": "core#altLabel",
"values": [
"2019 novel coronavirus respiratory syndrome"
]
},
{
"name": "core#altLabel",
"values": [
"2019-nCoV acute respiratory disease"
]
},
{
"name": "core#altLabel",
"values": [
"CD-19"
]
},
{
"name": "core#altLabel",
"values": [
"coronavirus disease 2019"
]
},
{
"name": "core#altLabel",
"values": [
"Coronavirus disease 2019"
]
},
{
"name": "core#altLabel",
"values": [
"COVID 19"
]
},
{
"name": "core#altLabel",
"values": [
"COVID-2019"
]
},
{
"name": "core#altLabel",
"values": [
"nCOVD 19"
]
},
{
"name": "core#altLabel",
"values": [
"nCOVD-19"
]
},
{
"name": "core#altLabel",
"values": [
"nCOVD19"
]
},
{
"name": "core#altLabel",
"values": [
"Novel Coronavirus Pneumonia"
]
},
{
"name": "core#altLabel",
"values": [
"seafood market pneumonia"
]
},
{
"name": "core#altLabel",
"values": [
"severe acute respiratory syndrome type 2"
]
},
{
"name": "core#altLabel",
"values": [
"Wuhan pneumonia"
]
},
{
"name": "core#altLabel",
"values": [
"Wuhan respiratory syndrome"
]
},
{
"name": "core#altLabel",
"values": [
"WuRS"
]
},
{
"name": "core#altLabel",
"values": [
"Severe Acute Respiratory Syndrome Coronavirus 2"
]
},
{
"name": "core#altLabel",
"values": [
"COVID19"
]
},
{
"name": "core#altLabel",
"values": [
"COVID"
]
},
{
"name": "core#altLabel",
"values": [
"Covid-19"
]
},
{
"name": "core#altLabel",
"values": [
"SARS-CoV-2"
]
},
{
"name": "P1448",
"values": [
"coronavirus disease"
]
},
{
"name": "P1813",
"values": [
"COVID-19"
]
}
]
}
}
}