MyGene.info documentation

Introduction

mygene.info

MyGene.info provides simple-to-use REST web services to query/retrieve gene annotation data. It’s designed with simplicity and performance emphasized. A typical use case is to use it to power a web application which requires querying genes and obtaining common gene annotations. For example, MyGene.info services are used to power BioGPS.

What’s new in v3 API

  • Refseq accession number now contains version
  • “ensembl”, “refseq” and “accession” contains associations between RNA and protein
  • Better mapping between Ensembl and Entrez gene IDs
  • JSON structure slightly changed
  • and more bugfixes

You can read more details about this version on our blog

Migration guide from v2 to v3 API

Still want to stick with v2 API for a while? It’s still there: v2 API, but annotation data there won’t be updated any more.

Quick start

MyGene.info provides two simple web services: one for gene queries and the other for gene annotation retrieval. Both return results in JSON format.

Gene query service

URL

http://mygene.info/v3/query

Examples

http://mygene.info/v3/query?q=cdk2
http://mygene.info/v3/query?q=cdk2&species=human
http://mygene.info/v3/query?q=cdk?
http://mygene.info/v3/query?q=IL*
http://mygene.info/v3/query?q=entrezgene:1017
http://mygene.info/v3/query?q=ensemblgene:ENSG00000123374
http://mygene.info/v3/query?q=cdk2&fields=symbol,refseq

Hint

View nicely formatted JSON result in your browser with this handy add-on: JSON formater for Chrome or JSONView for Firefox.

To learn more

Gene annotation service

URL

http://mygene.info/v3/gene/<geneid>

Examples

http://mygene.info/v3/gene/1017
http://mygene.info/v3/gene/ENSG00000123374
http://mygene.info/v3/gene/1017?fields=name,symbol,summary

“<geneid>” can be any of valid Entrez or Ensembl Gene ids. A retired Entrez Gene id works too if it is replaced by a new one.

To learn more

How to cite

See citation page here: http://mygene.info/citation/

FAQ

See FAQ page here: http://mygene.info/faq/