GET /gene/symbol/{symbols}/taxon/{taxon}
Summary: Get gene metadata by gene symbol
Operation ID: gene_metadata_by_tax_and_symbol
Auth: unknown
Operation ID: gene_metadata_by_tax_and_symbol
Auth: unknown
Description
Get a gene summary by by gene symbol. By default, in paged JSON format, but also available as tabular (accept: text/tab-separated-values) or json-lines (accept: application/x-ndjson)
Parameters (12)
accession_filter
(array, query, optional)
Filter tabular product report to only include the selected accessions. Use of this parameter requires the HTTP header, `accept: text/tab-separated-values`.
include_tabular_header
(?, query, optional)
Specify when to include the table header when requesting a tabular report.
locus_tags
(array, query, optional)
Gene locus tags
page_size
(integer, query, optional, default: 20)
The maximum number of gene reports to return. Default is 20 and maximum is 1000. If the number of results exceeds the page size, `page_token` can be used to retrieve the remaining results.
page_token
(string, query, optional)
A page token is returned when the results count exceeds `page size`. Use this token along with previous request parameters to retrieve the next page of results. When `page_token` is empty, all results have been retrieved.
returned_content
(?, query, optional)
Return complete gene reports, or abbreviated reports with either GeneIDs only or GeneIDs, transcript and protein counts.
sort.direction
(?, query, optional)
sort.field
(string, query, optional)
symbols
(array, path, required)
One or more gene symbols
table_fields
(array, query, optional)
Specify which fields to include in the tabular report. Additional fields are described here: [Create a table from the gene data reports](https://www.ncbi.nlm.nih.gov/datasets/docs/v2/command-line-tools/using-dataformat/gene-data-reports/). Use of this parameter requires the HTTP header, `accept: text/tab-separated-values`.
tax_search_subtree
(boolean, query, optional, default: False)
If true, include genes from taxonomic ranks below the requested taxon.
taxon
(string, path, required)
NCBI Taxonomy ID or name (common or scientific, any taxonomic rank) for the provided gene symbol
Examples (1)
| Title | Type | URL | Action |
|---|---|---|---|
| Get gene metadata by gene symbol (deprecated) | openapi-spec |
https://api.ncbi.nlm.nih.gov/datasets/v2/gene/symbol/GNAS/taxon/9606?returned_content=IDS_ONLY&locus_tags=b0001&table_fields=['gene-id', 'gene-type', 'description']&accession_filter=['NM_001407959.1', 'NM_001408458.1'] |
Probe History
Status Codes
| Time | Status | Latency | Size |
|---|---|---|---|
| 2026-03-23 10:38:55.246225 | 200 | 485ms |