Differences

This shows you the differences between two versions of the page.

-	biogridrest [2010/11/01 08:36] biogridadmin
-	Both sides previous revision Previous revision Next revision
+	Previous revision
+	biogridrest [2020/09/13 17:02] (current) biogridadmin [BioGRID REST Service]
@@ Line -1,75 +1,106 @@ ~~removed~~ created
	====== BioGRID REST Service ======
	Interaction data in BioGRID can be accessed via the BioGRID REST service. Interactions in various formats can be fetched from the BioGRID REST Service over ~~HTTP~~HTTPS, programmatically or in a browser, at
	~~http~~**https://~~biogrid~~webservice.~~bio~~thebiogrid.~~ed.ac.uk:8080~~org/~~BiogridRestService/resources/interactions/~~
	~~This URL will retrieve the first 10,000 interactions in BioGRID, ordered by the BioGRID Interaction Id as found in~~ **. ~~tab2 files. Single interactions ~~You can ~~be retrieved by appending this URL with a Biogrid Interaction ID (e.g. http://biogrid.bio.ed.ac.uk:8080/BiogridRestService/resources/~~access interactions ~~/103). The results list returned can be filtered by appending ?parameter1=value1& parameter2=value2 etc. to the URL. A full description of possible parameters is given in the table below.~~
	~~A formal description of the REST service, in Web Application Description Language (WADL), can be found at http://biogrid.bio.ed.ac.uk:8080/BiogridRestService/resources/~~using both POST and GET operations depending on your application ~~.wadl. The BioGRID REST service is updated to the latest release of BioGRID on the 2nd of each month and the BioGRID database version being accessed can be determined with the URL:~~
	~~http://biogrid.bio.ed.ac.uk:8080/BiogridRestService/resources/version ~~requirements.

	~~In addition to BioGRID interaction data, interactions from~~ === Get Your Access Key ===
	To access the ~~IMEx databases IntAct, MINT [2] and DIP have been parsed, mapped to~~ BioGRID ~~evidence codes~~REST webservice, ~~according to the mapping in LINK, and included as an option ~~you will need a unique access key for ~~retrieval in~~ your application. You can get one by filling out the ~~REST service data~~simple form located [[https://webservice.~~The URL parameter “sourceDatabaseList” has a default value of “BioGRID”, but if set to “BioGRID~~thebiogrid.org\|~~MINT\|INTACT\|DIP” the query will retrieve interactions from all databases~~here]]. ~~Source database origin can~~ This key must be ~~found~~ included in ~~the “Source Databases” column of the retrieved data and the “Source Database Identifiers” column (if the parameter format=extendedTab2 is set) allows mapping back~~ all queries to the ~~interaction ~~webservice in the original database. IMEx interaction files are downloaded from their respective websites and integrated into the REST service to coinicide with each monthly BioGRID release. These additional interactions are only available through the BioGRid REST Service and are not currently present in the BioGRID download filesform of accesskey=[ACCESSKEY].

	=== == Code Examples =====
	For example code (written in Python) demonstrating basic usage of the REST Service, please visit our [[https://github.com/BioGRID/BIOGRID-REST-EXAMPLES\|github repository]].

	===~~Interactions for human MDM2 gene:~~ === Access Points =======
	A formal description of the REST service, in Web Application Description Language (WADL), can be found at https://webservice.thebiogrid.org/application.wadl.

	~~http:~~=== /interactions/~~biogrid~~<INT ID> - Fetching Single Interactions ===
	Single interactions can be retrieved by appending this URL with a Biogrid Interaction ID (e.~~bio~~g. ~~ed.ac.uk~~https:~~8080~~/~~BiogridRestService~~/~~resources~~webservice.thebiogrid.org/interactions/103?~~searchNames~~accesskey=~~true&geneList=MDM2&includeInteractors=true&includeInteractorInteractions=false&taxId=9606~~[ACCESSKEY]).

	=== ~~Interactions for human MDM2 gene and~~ /interactions~~between all interactors of MDM2:~~ / - Fetching Multiple Interactions ===
	The URL https://webservice.thebiogrid.org/interactions/?accesskey=[ACCESSKEY] will retrieve the first 10,000 interactions in BioGRID, ordered by the BioGRID Interaction Id as found in [[biogrid_tab_version_2.0\|.tab2]] files. Results can be modified and filtered using the options in our REST [[#list_of_parameters\|list of parameters]].

	~~%%http~~=== /organisms/ - Fetching Supported Organisms List ===
	The URL https://~~biogrid~~webservice.~~bio~~thebiogrid.edorg/organisms/?accesskey=[ACCESSKEY] will retrieve the list of organism IDs and names supported by the REST taxId option. acThis call only supports the accessKey and format parameters (can be tab2 or json)(e.ukg. https:~~8080~~/~~BiogridRestService~~/~~resources~~webservice.thebiogrid.org/~~interactions~~organisms/?~~searchNames~~accesskey=~~true~~[ACCESSKEY]&~~geneList~~format=~~MDM2&taxId=9606&includeInteractors=true& includeInteractorInteractions=true%%~~json).

	=== ~~First 10 interactions for human MDM2 gene~~/identifiers/ - Fetching Supported Additional Identifier Types ===
	The URL https://webservice.thebiogrid.org/identifiers/?accesskey=[ACCESSKEY] will retrieve the list of identifier type names supported by the REST additionalIdentifierTypes option. This call only supports the accessKey and format parameters (can be tab2 or json)(e.g. https://webservice.thebiogrid.org/identifiers/?accesskey=[ACCESSKEY]&format=json).

	~~%%http~~=== /evidence/ - Fetching Supported Experimental Evidence ===
	The URL https://~~biogrid~~webservice.~~bio~~thebiogrid.edorg/evidence/?accesskey=[ACCESSKEY] will retrieve the list of evidence names supported by the REST evidenceList option. acThis call only supports the accessKey and format parameters (can be tab2 or json)(e.ukg. https:~~8080~~/~~BiogridRestService~~/~~resources~~webservice.thebiogrid.org/~~interactions~~evidence/?~~searchNames~~accesskey=~~true~~[ACCESSKEY]&~~geneList~~format=~~MDM2&includeInteractors=true&includeInteractorInteractions=false&taxId=9606&start=0&max=10%%~~json).

	=== ~~Interactions between S. cerevisiae CDC27, APC1~~ /version/ - Fetching REST Version Number ===
	The BioGRID REST service is updated to the latest release of BioGRID on the 4th of each month and ~~APC2~~the BioGRID database version being accessed can be determined with the URL:
	https://webservice.thebiogrid.org/version?accesskey=[ACCESSKEY].

	====== List of Parameters ======

	~~http://biogrid.bio.ed.ac.uk:8080/BiogridRestService/resources/interactions/~~=== Filtering Results ===
	The results list returned can be filtered by appending ?~~searchNames~~parameter1=~~true~~value1&~~geneList~~parameter2=~~cdc27~~value2 etc. to the URL. A full description of possible parameters is given in the [[#list_of_parameters\|~~apc1~~table below]]. You can also utilize our full list of [[#examples\|~~apc2&taxId=4932~~example queries]] to give you an idea of how to get started.

	^Parameter^Type^Default^Valid Values^Description^
	\|accessKey\|string\|NONE\|Only 32 character Alphanumeric strings\|All rest access must supply a valid accessKey to prevent spamming of the service. Access Keys are free and openly [[https://webservice.thebiogrid.org/\|available here]]. \|
	\|start\|int\|0\|0-2147483647\|Query results are numbered from 0. Results fetched will start at this value e.g. start = == 50 will skip the the first 50 results. Ignored if using "count" in the format parameter.\|
	\|max\|int\|10000\|1-10000\|Number of results to fetch; this will be ignored if greater than 10,000, i.e. pagination using several requests is required to retrieve more than 10,000 interactions. Ignored if using "count" in the format parameter.\|
	\|interSpeciesExcluded\|boolean\|FALSE\|true, false\|If ‘true’, interactions with interactors from different species will be excluded.\|
	\|selfInteractionsExcluded\|boolean\|FALSE\|true, false\|If ‘true’, interactions with one interactor will be excluded.\|
	\|evidenceList\|string\|empty\|Pipe-separated list of evidence codes from [[#evidence_-_fetching_supported_experimental_evidence\|here]]\|Any interaction evidence with its Experimental System in the list will be excluded from the results unless includeEvidence is set to true.\|
	\|includeEvidence\|boolean\|FALSE\|true, false\|If set to true, any interaction evidence with its Experimental System in the evidenceList will be included in the result\|
	\|geneList\|string\|empty\|Pipe-separated list of gene names or identifiers.\|Interactions between genes in this list will be fetched. This parameter is ignored if one of searchIds, searchNames, searchSynonyms is not ‘true’ and additionalIdentifierTypes is empty.\|
	\|searchIds\|boolean\|FALSE\|true, false\|If ‘true’, the interactor ENTREZ_GENE, ORDERED LOCUS and SYSTEMATIC_NAME (orf) will be examined for a match with the geneList .\|
	\|searchNames\|boolean\|FALSE\|true, false\|If ‘true’, the interactor OFFICIAL_SYMBOL will be examined for a match with the geneList.\|
	\|searchSynonyms\|boolean\|FALSE\|true, false\|If ‘true’, the interactor SYNONYM will be examined for a match with the geneList.\|
	\|searchBiogridIds\|boolean\|FALSE\|true, false\|If ‘true’, the entries in 'GENELIST' will be compared to BIOGRID internal IDS which are provided in all Tab2 formatted files.\|
	\|additionalIdentifierTypes\|string\|empty\|Pipe-separated list of identifier types from [[#identifiers_-_fetching_supported_additional_identifier_types\|here]]\|Identifier types on this list are examined for a match with the geneList. Some identifier types search multiple types simultaneously. UNIPROT or UNIPROTKB will search SWISS-PROT/TREMBL/UNIPROT-ACCESSION/UNIPROT-ISOFORM. REFSEQ will search REFSEQ-RNA-GI, REFSEQ-RNA-ACCESSION, REFSEQ-PROTEIN-GI, REFSEQ-PROTEIN-ACCESSION-VERSIONED, REFSEQ-PROTEIN-ACCESSION, REFSEQ-LEGACY. WORMBASE will search WORMBASE and WORMBASE-OLD. ENSEMBL will search ENSEMBL, ENSEMBL GENE, ENSEMBL PROTEIN, ENSEMBL RNA.\|
	\|excludeGenes\|boolean\|FALSE\|true, false\|If ‘true’, interactions containing genes in the geneList will be excluded from the results. Ignored if one of searchIds, searchNames, searchSynonyms is not ‘true’ and additionalIdentifierTypes is empty.\|
	\|includeInteractors\|boolean\|TRUE\|true, false\|If ‘true’, in addition to interactions between genes on the geneList, interactions will also be fetched which have only one interactor on the geneList i.e. the geneList’s first order interactors will be included\|
	\|includeInteractorInteractions\|boolean\|FALSE\|true, false\|If ‘true’ interactions between the geneList’s first order interactors will be included. Ignored if includeInteractors is ‘false’ or if excludeGenes is set to ‘true’.\|
	\|pubmedList\|string\|empty string\|Pipe-separated list of pubmed IDs~~18316726 ~~\|Interactions will be fetched whose Pubmed Id is/ is not in this list, depending on the value of excludePubmeds.\|
	\|excludePubmeds\|boolean\|FALSE\|true, false\|If ‘false’, interactions with Pubmed ID in pubmedList will be included in the results; if ‘true’ they will be excluded.\|
	\|htpThreshold\|int\|2147483647 (maximum 32-bit integer)\|0-2147483647\|Interactions whose Pubmed ID has more than this number of interactions will be excluded from the results. Ignored if excludePubmeds is ‘false’.\|
	\|throughputTag\|string\|"any"\|"any","low","high"\|If set to 'low or 'high', only interactions with 'Low throughput' or 'High throughput' in the 'throughput' field will be returned. Interactions with both 'Low throughput' and ~~17662948~~'High throughput' will be returned by either value.\|
	\|taxId\|string\|“All”\|Pipe-separated list of NCBI taxonomy identifiers or "All". Get full list of supported ids [[#organisms_-_fetching_supported_organisms_list\|here]]\|Only genes from these organisms will be searched with reference to gene identifiers or names. \|
	\|includeHeader\|boolean\|FALSE\|true, false\|If ‘true’, the first line of the result will be a BioGRID column header, appropriate for the format parameter (‘count’ format has no header).\|
	\|format\|string\|“tab2”\|“tab1”,”tab2,”extendedTab2”,”count”, "json", "jsonExtended"\|‘tab1’ and ‘tab2’ will return data in .tab or .tab2 format respectively. 'json' will return data in json a json formatted object. ‘extendedTab2’ and 'jsonExtended' will return data in .tab2 and json file formats respectively with extra fields for "Source Database Identifiers", "Number of Interactions per Publication" and "Additional Identifiers". For more information on file formats, visit our [[https:~~===~~//wiki.thebiogrid.org/doku.php/downloads\|file format listing]].\|
	\|translate\|boolean\|FALSE\|true,false\|If 'true', the rest service will show a small snippet above your results detailing how your input parameters were translated for use in returning your data. This is helpful in troubleshooting why you may or may not be getting back the results expected. For example, if you enter a typo for a field such as "searchNamez", no result will be translated, and thus this parameter will be ignored. \|

	~~%%http://biogrid~~====== Error Handling ======
	If you make a mistake in accessing the REST service, you will be redirected to a standardized HTML error page such as a 401 or 400 page, depending on the problem. ~~bio~~In addition, all errors from the BioGRID REST service are accompanied by output in JSON format with the following structure.ed
	- STATUS - This will be either Error or Warning depending on the severity of the problem.ac
	- MESSAGES - A list of one or more messages detailing the error and possible corrective measures.
	- TYPE - A simple reiteration of the HTML error type in the header for the overall page.~~uk:8080/BiogridRestService/resources/interactions/?pubmedList=18316726\|17662948%%~~

	===~~Interactions between CDC27, APC1 and APC2 from publications with 50 or less interactions: ~~=== Examples ======

	~~%%http://biogrid.bio.ed.ac.uk:8080/BiogridRestService/resources/interactions/?searchNames~~=~~true&geneList~~=~~cdc27\|apc1\|apc2&htpThreshold~~= ~~50&excludePubmeds~~Interactions for human MDM2 gene: ===~~true%%~~

	https://webservice.thebiogrid.org/interactions?searchNames=true&geneList=MDM2&includeInteractors=~~Interactions between CDC27, APC1 and APC2 excluding ‘Affinity Capture-MS’ and ‘Two-hybrid’ data:~~ true&includeInteractorInteractions=false&taxId=9606&accesskey=[ACCESSKEY]

	~~%%http://biogrid.bio.ed.ac.uk:8080/BiogridRestService/resources/~~=== Interactions for human MDM2 gene and interactions ~~/?searchNames~~between all interactors of MDM2: =~~true&geneList~~=~~cdc27\|apc1\|apc2&excludedEvidenceCodes~~=~~Affinity Capture-MS\|Two-hybrid%%~~

	https://webservice.thebiogrid.org/interactions/?searchNames=true&geneList=MDM2&taxId=~~Interactions from pubmed ID18316726, excluding those containing HTLF:~~ 9606&includeInteractors=true&includeInteractorInteractions=true&accesskey=[ACCESSKEY]

	~~%%http://biogrid.bio.ed.ac.uk:8080/BiogridRestService/resources/interactions/?pubmedList~~=~~18316726&searchNames~~=~~true&geneList~~= ~~HLTF&excludeGenes~~First 10 interactions for human MDM2 gene: ===~~true%%~~

	https://webservice.thebiogrid.org/interactions/?searchNames=true&geneList=~~= Interactions between genes with GENBANK_DNA_GI 82502895 (TP53) or 158261704 (~~MDM2~~), in extendedTab2 format with a header: ~~&includeInteractors=true&taxId=9606&start=0&max=10&accesskey=[ACCESSKEY]

	~~%%http://biogrid~~=== Interactions between S. ~~bio.ed.ac.uk~~cerevisiae CDC27, APC1 and APC2: ~~8080/BiogridRestService/resources/interactions/?additionalIdentifierTypes=GENBANK_DNA_GI&geneList~~=~~82502895\|158261704&format~~=~~extendedTab2&includeHeader~~=~~true%%~~

	[[https://webservice.thebiogrid.org/interactions/?searchNames=true&geneList=cdc27%7Capc1%7Capc2&taxId=559292&accesskey=[ACCESSKEY]\|https://webservice.thebiogrid.org/interactions/?searchNames=true&geneList=cdc27\|apc1\|apc2&taxId=559292&accesskey=[ACCESSKEY]]]

	=== Interactions from pubmed IDs 18316726 and 17662948: ===

	[[https://webservice.thebiogrid.org/interactions/?pubmedList=18316726%7C17662948&accesskey=[ACCESSKEY]\|https://webservice.thebiogrid.org/interactions/?pubmedList=18316726\|17662948&accesskey=[ACCESSKEY]]]

	~~^Parameter^Type^Default^Valid Values^Description^~~
	~~\|start\|int\|0\|Any integer\|Query results are numbered from 0. Results fetched will start at this value e.g. start~~ =~~50 will skip the the first 50 results.\|~~
	~~\|max\|int\|10000\|0-10000\|Number of results to fetch; this will be ignored if greater than 10,000, i.e. pagination using several requests is required to retrieve more than 10,000 interactions.\|~~
	~~\|interSpeciesExcluded\|boolean\|FALSE\|true, false\|If ‘true’, interactions with interactors from different species will be excluded.\|~~
	~~\|selfInteractionsExcluded\|boolean\|FALSE\|true, false\|If ‘true’, interactions with one interactor will be excluded.\|~~
	\|excludedEvidenceCodes\|string\|empty\|string\|Pipe-separated list of evidence codes from http://wiki.thebiogrid.org/doku.php/experimental_systems. Any interaction evidence with its Experimental System in the list will be excluded from the results.\|
	~~\|geneList\|string\|empty\|string\|Pipe-separated list of gene names or identifiers.~~ == Interactions between ~~gene in this list will be fetched. Ignored if one of searchIds~~CDC27, ~~searchNames, searchSynonyms is not ‘true’ ~~APC1 and ~~additionalIdentifierTypes is empty.\|~~
	~~\|searchIds\|boolean\|FALSE\|true, false\|If ~~APC2 excluding ‘~~true’, the interactor ENTREZ_GENE and SYSTEMATIC_NAME (orf) will be examined for a match with the geneList .\|~~
	~~\|searchNames\|boolean\|FALSE\|true, false\|If ‘true’, the interactor OFFICIAL_SYMBOL will be examined for a match with the geneList.\|~~
	~~\|searchSynonyms\|boolean\|FALSE\|true, false\|If ‘true’, the interactor SYNONYM will be examined for a match with the geneList.\|~~
	~~\|additionalIdentifierTypes\|string\|empty\|string\|Pipe~~Affinity Capture-~~separated list of identifier types from http://wiki.thebiogrid.org/doku.php/identifiers Identifier types on this list will be examined for a match with the geneList.\|~~
	\|excludeGenes\|boolean\|FALSE\|true, false\|If ‘true’, interactions containing genes in the geneList will be excluded from the results. Ignored if one of searchIds, searchNames, searchSynonyms is not ‘trueMS’ and ~~additionalIdentifierTypes is empty.\|~~
	~~\|includeInteractors\|boolean\|FALSE\|true, false\|If ~~‘true’, in addition to interactions between genes on the geneList, interactions will also be fetched which have only one interactor on the geneList i.e. the geneList’s first order interactors will be included\|
	\|includeInteractorInteractions\|boolean\|TRUE\|true, false\|If ‘true’ interactions between the geneList’s first order interactors will be included. Ignored if includeInteractors is ‘false’ or if excludeGenes is set to ‘true’.\|
	~~\|pubmedList\|string\|empty string\|Pipe~~Two-~~separated list of pubmed IDs\|Interactions will be fetched whose Pubmed Id is/ is not in this list, depending on the value of excludePubmeds.\|~~
	~~\|excludePubmeds\|boolean\|FALSE\|true, false\|If ‘false’, interactions with Pubmed ID in pubmedList will be included in the results; if ‘true’ they will be excluded.\|~~
	\|htpThreshold\|int\|2147483647 (maximum 32-bit integer)\|0-2147483647\|Interactions whose Pubmed ID has more than this number of interactions will be excluded from the results. Ignored if excludePubmeds is ‘false’.\|
	~~\|taxId\|string\|“All”\|Any NCBI taxonomy identifier or "All"\|Only interactions with this NCBI taxonomy id will be included in the results.\|~~
	~~\|includeHeader\|boolean\|FALSE\|true, false\|If ‘true’, the first line of the result will be a BioGRID column header, appropriate for the format parameter (‘count’ format has no header).\|~~
	~~\|sourceDatabaseList\|string\|“BioGRID”\|Pipe-separated list of database names, currently including BioGRID, INTACT, MINT, DIP\|Only interactions with Source Database on this list will be returned.\|~~
	~~\|sourceDatabaseIdList\|string\|empty\|Pipe-separated list of source database identifiers\|Interactions with interaction ID in the list will be included in the results.\|~~
	~~\|format\|string\|“tab2”\|“tab1”,”tab2,”extendedTab2”,”count”\|‘tab1’ and ‘tab2~~hybrid’ ~~will return ~~datain .tab or .tab2 format respectively. ‘extendedTab2’ will return data in .tab2 file format with extra fields fields for Source Database Identifiers , Number of Interactions per Publication and Additional Identifiers. Source Database Identifiers are listed in order corresponding to the values in Source Databases e.g if an interaction has %%BIOGRID\|INTACT\|MINT in Source_Database, it might have 821622\|EBI-1792672\|MINT-1999291%%\|: ===

	[[https://webservice.thebiogrid.org/interactions/?searchNames=true&geneList=cdc27%7Capc1%7Capc2&evidenceList=Affinity Capture-MS%7CTwo-hybrid&accesskey=[ACCESSKEY]\|https://webservice.thebiogrid.org/interactions/?searchNames=true&geneList=cdc27\|apc1\|apc2&evidenceList=Affinity Capture-MS\|Two-hybrid&accesskey=[ACCESSKEY]]]

	=== Interactions between genes with REFSEQ IDs NP_001119587 (TP53) or NP_002383 (MDM2), in jsonExtended format ===

	[[https://webservice.thebiogrid.org/interactions/?additionalIdentifierTypes=REFSEQ&geneList=NP_001119587%7CNP_002383&format=jsonExtended&accesskey=[ACCESSKEY]\|https://webservice.thebiogrid.org/interactions/?additionalIdentifierTypes=REFSEQ&geneList=NP_001119587\|NP_002383&format=jsonExtended&accesskey=[ACCESSKEY]]]

	=== Interactions involving Entrez Gene IDs 6783 (SULT1E1), 6820 (SULT2B1), and 55791 (LRIF1) ===

	[[https://webservice.thebiogrid.org/interactions/?geneList=6783%7C6820%7C55791&searchids=true&includeInteractors=true&accessKey=[ACCESSKEY]\|https://webservice.thebiogrid.org/interactions/?geneList=6783\|6820\|55791&searchids=true&includeInteractors=true&accessKey=[ACCESSKEY]]]

	=== Interactions involving SGD IDs S000004354 (STE11) and S000003664 (PBS2) ===

	[[https://webservice.thebiogrid.org/interactions/?additionalIdentifierTypes=SGD&geneList=S000004354%7CS000003664&includeInteractors=true&accesskey=[ACCESSKEY]\|https://webservice.thebiogrid.org/interactions/?additionalIdentifierTypes=SGD&geneList=S000004354\|S000003664&includeInteractors=true&accesskey=[ACCESSKEY]]]

-	biogridrest [2010/11/01 08:36] biogridadmin
-	Both sides previous revision Previous revision Next revision
+	Previous revision
+	biogridrest [2020/09/13 17:02] (current) biogridadmin [BioGRID REST Service]
@@ Line -1,75 +1,106 @@ ~~removed~~ created
	====== BioGRID REST Service ======
	Interaction data in BioGRID can be accessed via the BioGRID REST service. Interactions in various formats can be fetched from the BioGRID REST Service over ~~HTTP~~HTTPS, programmatically or in a browser, at
	~~http~~**https://~~biogrid~~webservice.~~bio~~thebiogrid.~~ed.ac.uk:8080~~org/~~BiogridRestService/resources/interactions/~~
	~~This URL will retrieve the first 10,000 interactions in BioGRID, ordered by the BioGRID Interaction Id as found in~~ **. ~~tab2 files. Single interactions ~~You can ~~be retrieved by appending this URL with a Biogrid Interaction ID (e.g. http://biogrid.bio.ed.ac.uk:8080/BiogridRestService/resources/~~access interactions ~~/103). The results list returned can be filtered by appending ?parameter1=value1& parameter2=value2 etc. to the URL. A full description of possible parameters is given in the table below.~~
	~~A formal description of the REST service, in Web Application Description Language (WADL), can be found at http://biogrid.bio.ed.ac.uk:8080/BiogridRestService/resources/~~using both POST and GET operations depending on your application ~~.wadl. The BioGRID REST service is updated to the latest release of BioGRID on the 2nd of each month and the BioGRID database version being accessed can be determined with the URL:~~
	~~http://biogrid.bio.ed.ac.uk:8080/BiogridRestService/resources/version ~~requirements.

	~~In addition to BioGRID interaction data, interactions from~~ === Get Your Access Key ===
	To access the ~~IMEx databases IntAct, MINT [2] and DIP have been parsed, mapped to~~ BioGRID ~~evidence codes~~REST webservice, ~~according to the mapping in LINK, and included as an option ~~you will need a unique access key for ~~retrieval in~~ your application. You can get one by filling out the ~~REST service data~~simple form located [[https://webservice.~~The URL parameter “sourceDatabaseList” has a default value of “BioGRID”, but if set to “BioGRID~~thebiogrid.org\|~~MINT\|INTACT\|DIP” the query will retrieve interactions from all databases~~here]]. ~~Source database origin can~~ This key must be ~~found~~ included in ~~the “Source Databases” column of the retrieved data and the “Source Database Identifiers” column (if the parameter format=extendedTab2 is set) allows mapping back~~ all queries to the ~~interaction ~~webservice in the original database. IMEx interaction files are downloaded from their respective websites and integrated into the REST service to coinicide with each monthly BioGRID release. These additional interactions are only available through the BioGRid REST Service and are not currently present in the BioGRID download filesform of accesskey=[ACCESSKEY].

	=== == Code Examples =====
	For example code (written in Python) demonstrating basic usage of the REST Service, please visit our [[https://github.com/BioGRID/BIOGRID-REST-EXAMPLES\|github repository]].

	===~~Interactions for human MDM2 gene:~~ === Access Points =======
	A formal description of the REST service, in Web Application Description Language (WADL), can be found at https://webservice.thebiogrid.org/application.wadl.

	~~http:~~=== /interactions/~~biogrid~~<INT ID> - Fetching Single Interactions ===
	Single interactions can be retrieved by appending this URL with a Biogrid Interaction ID (e.~~bio~~g. ~~ed.ac.uk~~https:~~8080~~/~~BiogridRestService~~/~~resources~~webservice.thebiogrid.org/interactions/103?~~searchNames~~accesskey=~~true&geneList=MDM2&includeInteractors=true&includeInteractorInteractions=false&taxId=9606~~[ACCESSKEY]).

	=== ~~Interactions for human MDM2 gene and~~ /interactions~~between all interactors of MDM2:~~ / - Fetching Multiple Interactions ===
	The URL https://webservice.thebiogrid.org/interactions/?accesskey=[ACCESSKEY] will retrieve the first 10,000 interactions in BioGRID, ordered by the BioGRID Interaction Id as found in [[biogrid_tab_version_2.0\|.tab2]] files. Results can be modified and filtered using the options in our REST [[#list_of_parameters\|list of parameters]].

	~~%%http~~=== /organisms/ - Fetching Supported Organisms List ===
	The URL https://~~biogrid~~webservice.~~bio~~thebiogrid.edorg/organisms/?accesskey=[ACCESSKEY] will retrieve the list of organism IDs and names supported by the REST taxId option. acThis call only supports the accessKey and format parameters (can be tab2 or json)(e.ukg. https:~~8080~~/~~BiogridRestService~~/~~resources~~webservice.thebiogrid.org/~~interactions~~organisms/?~~searchNames~~accesskey=~~true~~[ACCESSKEY]&~~geneList~~format=~~MDM2&taxId=9606&includeInteractors=true& includeInteractorInteractions=true%%~~json).

	=== ~~First 10 interactions for human MDM2 gene~~/identifiers/ - Fetching Supported Additional Identifier Types ===
	The URL https://webservice.thebiogrid.org/identifiers/?accesskey=[ACCESSKEY] will retrieve the list of identifier type names supported by the REST additionalIdentifierTypes option. This call only supports the accessKey and format parameters (can be tab2 or json)(e.g. https://webservice.thebiogrid.org/identifiers/?accesskey=[ACCESSKEY]&format=json).

	~~%%http~~=== /evidence/ - Fetching Supported Experimental Evidence ===
	The URL https://~~biogrid~~webservice.~~bio~~thebiogrid.edorg/evidence/?accesskey=[ACCESSKEY] will retrieve the list of evidence names supported by the REST evidenceList option. acThis call only supports the accessKey and format parameters (can be tab2 or json)(e.ukg. https:~~8080~~/~~BiogridRestService~~/~~resources~~webservice.thebiogrid.org/~~interactions~~evidence/?~~searchNames~~accesskey=~~true~~[ACCESSKEY]&~~geneList~~format=~~MDM2&includeInteractors=true&includeInteractorInteractions=false&taxId=9606&start=0&max=10%%~~json).

	=== ~~Interactions between S. cerevisiae CDC27, APC1~~ /version/ - Fetching REST Version Number ===
	The BioGRID REST service is updated to the latest release of BioGRID on the 4th of each month and ~~APC2~~the BioGRID database version being accessed can be determined with the URL:
	https://webservice.thebiogrid.org/version?accesskey=[ACCESSKEY].

	====== List of Parameters ======

	~~http://biogrid.bio.ed.ac.uk:8080/BiogridRestService/resources/interactions/~~=== Filtering Results ===
	The results list returned can be filtered by appending ?~~searchNames~~parameter1=~~true~~value1&~~geneList~~parameter2=~~cdc27~~value2 etc. to the URL. A full description of possible parameters is given in the [[#list_of_parameters\|~~apc1~~table below]]. You can also utilize our full list of [[#examples\|~~apc2&taxId=4932~~example queries]] to give you an idea of how to get started.

	^Parameter^Type^Default^Valid Values^Description^
	\|accessKey\|string\|NONE\|Only 32 character Alphanumeric strings\|All rest access must supply a valid accessKey to prevent spamming of the service. Access Keys are free and openly [[https://webservice.thebiogrid.org/\|available here]]. \|
	\|start\|int\|0\|0-2147483647\|Query results are numbered from 0. Results fetched will start at this value e.g. start = == 50 will skip the the first 50 results. Ignored if using "count" in the format parameter.\|
	\|max\|int\|10000\|1-10000\|Number of results to fetch; this will be ignored if greater than 10,000, i.e. pagination using several requests is required to retrieve more than 10,000 interactions. Ignored if using "count" in the format parameter.\|
	\|interSpeciesExcluded\|boolean\|FALSE\|true, false\|If ‘true’, interactions with interactors from different species will be excluded.\|
	\|selfInteractionsExcluded\|boolean\|FALSE\|true, false\|If ‘true’, interactions with one interactor will be excluded.\|
	\|evidenceList\|string\|empty\|Pipe-separated list of evidence codes from [[#evidence_-_fetching_supported_experimental_evidence\|here]]\|Any interaction evidence with its Experimental System in the list will be excluded from the results unless includeEvidence is set to true.\|
	\|includeEvidence\|boolean\|FALSE\|true, false\|If set to true, any interaction evidence with its Experimental System in the evidenceList will be included in the result\|
	\|geneList\|string\|empty\|Pipe-separated list of gene names or identifiers.\|Interactions between genes in this list will be fetched. This parameter is ignored if one of searchIds, searchNames, searchSynonyms is not ‘true’ and additionalIdentifierTypes is empty.\|
	\|searchIds\|boolean\|FALSE\|true, false\|If ‘true’, the interactor ENTREZ_GENE, ORDERED LOCUS and SYSTEMATIC_NAME (orf) will be examined for a match with the geneList .\|
	\|searchNames\|boolean\|FALSE\|true, false\|If ‘true’, the interactor OFFICIAL_SYMBOL will be examined for a match with the geneList.\|
	\|searchSynonyms\|boolean\|FALSE\|true, false\|If ‘true’, the interactor SYNONYM will be examined for a match with the geneList.\|
	\|searchBiogridIds\|boolean\|FALSE\|true, false\|If ‘true’, the entries in 'GENELIST' will be compared to BIOGRID internal IDS which are provided in all Tab2 formatted files.\|
	\|additionalIdentifierTypes\|string\|empty\|Pipe-separated list of identifier types from [[#identifiers_-_fetching_supported_additional_identifier_types\|here]]\|Identifier types on this list are examined for a match with the geneList. Some identifier types search multiple types simultaneously. UNIPROT or UNIPROTKB will search SWISS-PROT/TREMBL/UNIPROT-ACCESSION/UNIPROT-ISOFORM. REFSEQ will search REFSEQ-RNA-GI, REFSEQ-RNA-ACCESSION, REFSEQ-PROTEIN-GI, REFSEQ-PROTEIN-ACCESSION-VERSIONED, REFSEQ-PROTEIN-ACCESSION, REFSEQ-LEGACY. WORMBASE will search WORMBASE and WORMBASE-OLD. ENSEMBL will search ENSEMBL, ENSEMBL GENE, ENSEMBL PROTEIN, ENSEMBL RNA.\|
	\|excludeGenes\|boolean\|FALSE\|true, false\|If ‘true’, interactions containing genes in the geneList will be excluded from the results. Ignored if one of searchIds, searchNames, searchSynonyms is not ‘true’ and additionalIdentifierTypes is empty.\|
	\|includeInteractors\|boolean\|TRUE\|true, false\|If ‘true’, in addition to interactions between genes on the geneList, interactions will also be fetched which have only one interactor on the geneList i.e. the geneList’s first order interactors will be included\|
	\|includeInteractorInteractions\|boolean\|FALSE\|true, false\|If ‘true’ interactions between the geneList’s first order interactors will be included. Ignored if includeInteractors is ‘false’ or if excludeGenes is set to ‘true’.\|
	\|pubmedList\|string\|empty string\|Pipe-separated list of pubmed IDs~~18316726 ~~\|Interactions will be fetched whose Pubmed Id is/ is not in this list, depending on the value of excludePubmeds.\|
	\|excludePubmeds\|boolean\|FALSE\|true, false\|If ‘false’, interactions with Pubmed ID in pubmedList will be included in the results; if ‘true’ they will be excluded.\|
	\|htpThreshold\|int\|2147483647 (maximum 32-bit integer)\|0-2147483647\|Interactions whose Pubmed ID has more than this number of interactions will be excluded from the results. Ignored if excludePubmeds is ‘false’.\|
	\|throughputTag\|string\|"any"\|"any","low","high"\|If set to 'low or 'high', only interactions with 'Low throughput' or 'High throughput' in the 'throughput' field will be returned. Interactions with both 'Low throughput' and ~~17662948~~'High throughput' will be returned by either value.\|
	\|taxId\|string\|“All”\|Pipe-separated list of NCBI taxonomy identifiers or "All". Get full list of supported ids [[#organisms_-_fetching_supported_organisms_list\|here]]\|Only genes from these organisms will be searched with reference to gene identifiers or names. \|
	\|includeHeader\|boolean\|FALSE\|true, false\|If ‘true’, the first line of the result will be a BioGRID column header, appropriate for the format parameter (‘count’ format has no header).\|
	\|format\|string\|“tab2”\|“tab1”,”tab2,”extendedTab2”,”count”, "json", "jsonExtended"\|‘tab1’ and ‘tab2’ will return data in .tab or .tab2 format respectively. 'json' will return data in json a json formatted object. ‘extendedTab2’ and 'jsonExtended' will return data in .tab2 and json file formats respectively with extra fields for "Source Database Identifiers", "Number of Interactions per Publication" and "Additional Identifiers". For more information on file formats, visit our [[https:~~===~~//wiki.thebiogrid.org/doku.php/downloads\|file format listing]].\|
	\|translate\|boolean\|FALSE\|true,false\|If 'true', the rest service will show a small snippet above your results detailing how your input parameters were translated for use in returning your data. This is helpful in troubleshooting why you may or may not be getting back the results expected. For example, if you enter a typo for a field such as "searchNamez", no result will be translated, and thus this parameter will be ignored. \|

	~~%%http://biogrid~~====== Error Handling ======
	If you make a mistake in accessing the REST service, you will be redirected to a standardized HTML error page such as a 401 or 400 page, depending on the problem. ~~bio~~In addition, all errors from the BioGRID REST service are accompanied by output in JSON format with the following structure.ed
	- STATUS - This will be either Error or Warning depending on the severity of the problem.ac
	- MESSAGES - A list of one or more messages detailing the error and possible corrective measures.
	- TYPE - A simple reiteration of the HTML error type in the header for the overall page.~~uk:8080/BiogridRestService/resources/interactions/?pubmedList=18316726\|17662948%%~~

	===~~Interactions between CDC27, APC1 and APC2 from publications with 50 or less interactions: ~~=== Examples ======

	~~%%http://biogrid.bio.ed.ac.uk:8080/BiogridRestService/resources/interactions/?searchNames~~=~~true&geneList~~=~~cdc27\|apc1\|apc2&htpThreshold~~= ~~50&excludePubmeds~~Interactions for human MDM2 gene: ===~~true%%~~

	https://webservice.thebiogrid.org/interactions?searchNames=true&geneList=MDM2&includeInteractors=~~Interactions between CDC27, APC1 and APC2 excluding ‘Affinity Capture-MS’ and ‘Two-hybrid’ data:~~ true&includeInteractorInteractions=false&taxId=9606&accesskey=[ACCESSKEY]

	~~%%http://biogrid.bio.ed.ac.uk:8080/BiogridRestService/resources/~~=== Interactions for human MDM2 gene and interactions ~~/?searchNames~~between all interactors of MDM2: =~~true&geneList~~=~~cdc27\|apc1\|apc2&excludedEvidenceCodes~~=~~Affinity Capture-MS\|Two-hybrid%%~~

	https://webservice.thebiogrid.org/interactions/?searchNames=true&geneList=MDM2&taxId=~~Interactions from pubmed ID18316726, excluding those containing HTLF:~~ 9606&includeInteractors=true&includeInteractorInteractions=true&accesskey=[ACCESSKEY]

	~~%%http://biogrid.bio.ed.ac.uk:8080/BiogridRestService/resources/interactions/?pubmedList~~=~~18316726&searchNames~~=~~true&geneList~~= ~~HLTF&excludeGenes~~First 10 interactions for human MDM2 gene: ===~~true%%~~

	https://webservice.thebiogrid.org/interactions/?searchNames=true&geneList=~~= Interactions between genes with GENBANK_DNA_GI 82502895 (TP53) or 158261704 (~~MDM2~~), in extendedTab2 format with a header: ~~&includeInteractors=true&taxId=9606&start=0&max=10&accesskey=[ACCESSKEY]

	~~%%http://biogrid~~=== Interactions between S. ~~bio.ed.ac.uk~~cerevisiae CDC27, APC1 and APC2: ~~8080/BiogridRestService/resources/interactions/?additionalIdentifierTypes=GENBANK_DNA_GI&geneList~~=~~82502895\|158261704&format~~=~~extendedTab2&includeHeader~~=~~true%%~~

	[[https://webservice.thebiogrid.org/interactions/?searchNames=true&geneList=cdc27%7Capc1%7Capc2&taxId=559292&accesskey=[ACCESSKEY]\|https://webservice.thebiogrid.org/interactions/?searchNames=true&geneList=cdc27\|apc1\|apc2&taxId=559292&accesskey=[ACCESSKEY]]]

	=== Interactions from pubmed IDs 18316726 and 17662948: ===

	[[https://webservice.thebiogrid.org/interactions/?pubmedList=18316726%7C17662948&accesskey=[ACCESSKEY]\|https://webservice.thebiogrid.org/interactions/?pubmedList=18316726\|17662948&accesskey=[ACCESSKEY]]]

	~~^Parameter^Type^Default^Valid Values^Description^~~
	~~\|start\|int\|0\|Any integer\|Query results are numbered from 0. Results fetched will start at this value e.g. start~~ =~~50 will skip the the first 50 results.\|~~
	~~\|max\|int\|10000\|0-10000\|Number of results to fetch; this will be ignored if greater than 10,000, i.e. pagination using several requests is required to retrieve more than 10,000 interactions.\|~~
	~~\|interSpeciesExcluded\|boolean\|FALSE\|true, false\|If ‘true’, interactions with interactors from different species will be excluded.\|~~
	~~\|selfInteractionsExcluded\|boolean\|FALSE\|true, false\|If ‘true’, interactions with one interactor will be excluded.\|~~
	\|excludedEvidenceCodes\|string\|empty\|string\|Pipe-separated list of evidence codes from http://wiki.thebiogrid.org/doku.php/experimental_systems. Any interaction evidence with its Experimental System in the list will be excluded from the results.\|
	~~\|geneList\|string\|empty\|string\|Pipe-separated list of gene names or identifiers.~~ == Interactions between ~~gene in this list will be fetched. Ignored if one of searchIds~~CDC27, ~~searchNames, searchSynonyms is not ‘true’ ~~APC1 and ~~additionalIdentifierTypes is empty.\|~~
	~~\|searchIds\|boolean\|FALSE\|true, false\|If ~~APC2 excluding ‘~~true’, the interactor ENTREZ_GENE and SYSTEMATIC_NAME (orf) will be examined for a match with the geneList .\|~~
	~~\|searchNames\|boolean\|FALSE\|true, false\|If ‘true’, the interactor OFFICIAL_SYMBOL will be examined for a match with the geneList.\|~~
	~~\|searchSynonyms\|boolean\|FALSE\|true, false\|If ‘true’, the interactor SYNONYM will be examined for a match with the geneList.\|~~
	~~\|additionalIdentifierTypes\|string\|empty\|string\|Pipe~~Affinity Capture-~~separated list of identifier types from http://wiki.thebiogrid.org/doku.php/identifiers Identifier types on this list will be examined for a match with the geneList.\|~~
	\|excludeGenes\|boolean\|FALSE\|true, false\|If ‘true’, interactions containing genes in the geneList will be excluded from the results. Ignored if one of searchIds, searchNames, searchSynonyms is not ‘trueMS’ and ~~additionalIdentifierTypes is empty.\|~~
	~~\|includeInteractors\|boolean\|FALSE\|true, false\|If ~~‘true’, in addition to interactions between genes on the geneList, interactions will also be fetched which have only one interactor on the geneList i.e. the geneList’s first order interactors will be included\|
	\|includeInteractorInteractions\|boolean\|TRUE\|true, false\|If ‘true’ interactions between the geneList’s first order interactors will be included. Ignored if includeInteractors is ‘false’ or if excludeGenes is set to ‘true’.\|
	~~\|pubmedList\|string\|empty string\|Pipe~~Two-~~separated list of pubmed IDs\|Interactions will be fetched whose Pubmed Id is/ is not in this list, depending on the value of excludePubmeds.\|~~
	~~\|excludePubmeds\|boolean\|FALSE\|true, false\|If ‘false’, interactions with Pubmed ID in pubmedList will be included in the results; if ‘true’ they will be excluded.\|~~
	\|htpThreshold\|int\|2147483647 (maximum 32-bit integer)\|0-2147483647\|Interactions whose Pubmed ID has more than this number of interactions will be excluded from the results. Ignored if excludePubmeds is ‘false’.\|
	~~\|taxId\|string\|“All”\|Any NCBI taxonomy identifier or "All"\|Only interactions with this NCBI taxonomy id will be included in the results.\|~~
	~~\|includeHeader\|boolean\|FALSE\|true, false\|If ‘true’, the first line of the result will be a BioGRID column header, appropriate for the format parameter (‘count’ format has no header).\|~~
	~~\|sourceDatabaseList\|string\|“BioGRID”\|Pipe-separated list of database names, currently including BioGRID, INTACT, MINT, DIP\|Only interactions with Source Database on this list will be returned.\|~~
	~~\|sourceDatabaseIdList\|string\|empty\|Pipe-separated list of source database identifiers\|Interactions with interaction ID in the list will be included in the results.\|~~
	~~\|format\|string\|“tab2”\|“tab1”,”tab2,”extendedTab2”,”count”\|‘tab1’ and ‘tab2~~hybrid’ ~~will return ~~datain .tab or .tab2 format respectively. ‘extendedTab2’ will return data in .tab2 file format with extra fields fields for Source Database Identifiers , Number of Interactions per Publication and Additional Identifiers. Source Database Identifiers are listed in order corresponding to the values in Source Databases e.g if an interaction has %%BIOGRID\|INTACT\|MINT in Source_Database, it might have 821622\|EBI-1792672\|MINT-1999291%%\|: ===

	[[https://webservice.thebiogrid.org/interactions/?searchNames=true&geneList=cdc27%7Capc1%7Capc2&evidenceList=Affinity Capture-MS%7CTwo-hybrid&accesskey=[ACCESSKEY]\|https://webservice.thebiogrid.org/interactions/?searchNames=true&geneList=cdc27\|apc1\|apc2&evidenceList=Affinity Capture-MS\|Two-hybrid&accesskey=[ACCESSKEY]]]

	=== Interactions between genes with REFSEQ IDs NP_001119587 (TP53) or NP_002383 (MDM2), in jsonExtended format ===

	[[https://webservice.thebiogrid.org/interactions/?additionalIdentifierTypes=REFSEQ&geneList=NP_001119587%7CNP_002383&format=jsonExtended&accesskey=[ACCESSKEY]\|https://webservice.thebiogrid.org/interactions/?additionalIdentifierTypes=REFSEQ&geneList=NP_001119587\|NP_002383&format=jsonExtended&accesskey=[ACCESSKEY]]]

	=== Interactions involving Entrez Gene IDs 6783 (SULT1E1), 6820 (SULT2B1), and 55791 (LRIF1) ===

	[[https://webservice.thebiogrid.org/interactions/?geneList=6783%7C6820%7C55791&searchids=true&includeInteractors=true&accessKey=[ACCESSKEY]\|https://webservice.thebiogrid.org/interactions/?geneList=6783\|6820\|55791&searchids=true&includeInteractors=true&accessKey=[ACCESSKEY]]]

	=== Interactions involving SGD IDs S000004354 (STE11) and S000003664 (PBS2) ===

	[[https://webservice.thebiogrid.org/interactions/?additionalIdentifierTypes=SGD&geneList=S000004354%7CS000003664&includeInteractors=true&accesskey=[ACCESSKEY]\|https://webservice.thebiogrid.org/interactions/?additionalIdentifierTypes=SGD&geneList=S000004354\|S000003664&includeInteractors=true&accesskey=[ACCESSKEY]]]

BioGRID REST Service

Differences