UnifyAPI
← Back to catalog

mygene.query_by_symbol

mock data$0.001 / call

Look Up Gene by Official Symbol

Find a gene by its official gene symbol with an exact match for a specific species. Returns a single best-matching gene with full annotation: NCBI Entrez Gene ID, Ensembl gene ID, gene name, type, taxon, summary, UniProt accession, genomic coordinates, pathway memberships, and GO terms. Faster and more precise than full-text search when the official symbol is known. Case-insensitive (BRCA1, brca1, Brca1 all match). For human genes, use HGNC symbols (e.g. "TP53", "EGFR", "KRAS", "VEGFA"). Results can be used directly with mygene.genes.batch for comparative multi-gene analysis.

Science & Researchprovider: Mygene#mygene#science

Input schema

fields

Comma-separated fields to include in the response. Default includes: symbol, name, taxid, entrezgene, type_of_gene, summary, ensembl, uniprot, alias, genomic_pos, pathway. Use "all" for complete gene annotations.

string
symbolrequired

Official HGNC gene symbol (for human) or equivalent gene symbol in the target species. Case-insensitive (e.g. "BRCA1", "TP53", "EGFR", "KRAS"). Performs an exact symbol match and returns the single best-matching gene.

string
species

Target species for the symbol lookup. Common values: "human", "mouse", "rat", "fruitfly", "zebrafish", "chicken", "pig", "dog". Can also use NCBI taxid (e.g. "9606" for human). Defaults to "human".

string

Call via REST

curl -X POST https://unifyapi.pro/api/call/mygene.query_by_symbol \
  -H "Authorization: Bearer uak_live_..." \
  -H "Content-Type: application/json" \
  -d '{"fields":"<fields>","symbol":"<symbol>","species":"human"}'

Try it

Paste a UnifyAPI key (create one in the dashboard) and run a real call.