MyGene.info documentation¶
Introduction¶
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.
Tweets by @mygeneinfo
What’s new in v2 API¶
- ALL species are supported now! That’s more than 14,000 in total. [more]
- Gene annotation data are even more up-to-date (weekly updates).
- Gene query service supports “fields” parameter to return any fields. Previously, you need to call gene query service separately if you need more than gene symbols and names.
- Fine-tuned query algorithm to return relevant gene hits first.
- Our query backend is more scalable and extensible. Ready to expand more annotation data as we go.
Migration guide from v1 to v2 API
Still want to stick with v1 API for a while? It’s still there: v1 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/v2/query
Examples¶
http://mygene.info/v2/query?q=cdk2
http://mygene.info/v2/query?q=cdk2&species=human
http://mygene.info/v2/query?q=cdk?
http://mygene.info/v2/query?q=IL*
http://mygene.info/v2/query?q=entrezgene:1017
http://mygene.info/v2/query?q=ensemblgene:ENSG00000123374
http://mygene.info/v2/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¶
- You can read the full description of our query syntax here.
- Try it live on interactive API page.
- Play with our demo applications.
- Batch queries? Yes, you can. do it with a POST request.
Gene annotation service¶
URL¶
http://mygene.info/v2/gene/<geneid>
Examples¶
http://mygene.info/v2/gene/1017
http://mygene.info/v2/gene/ENSG00000123374
http://mygene.info/v2/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¶
- You can read the full description of our query syntax here.
- Try it live on interactive API page.
- Play with our demo applications.
- Yes, batch queries via POST request as well.
Documentation¶
How to cite¶
See citation page here: http://mygene.info/citation/
FAQ¶
See FAQ page here: http://mygene.info/faq/