How Can We Help?
< All Topics
Print

Orpheus Knowledge GraphQL API

Table of Contents

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/graphql

This 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/graphql

This 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/graphql

This 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/graphql

Allows 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/graphql

Allows 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/graphql

This 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/graphql

This 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/graphql

This 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/graphql

This 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/graphql

This 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/graphql

Returns 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"
          ]
        }
      ]
    }
  }
}
Table of Contents