--- type: "firecrawl-provider" description: "HGNC, the authority for human gene names, through the genenames.org REST API: resolve any gene symbol, alias, previous symbol or ID (HGNC, NCBI Gene, Ensembl, UniProt, RefSeq, MGI, RGD) to the current approved symbol, with ambiguous aliases listed rather than guessed; check up to 50 genes at once; and search genes by name, symbol pattern, cytoband or locus type. Records carry the approved name, aliases, previous symbols, locus type, location, gene groups and cross-references that join NCBI Gene, Ensembl, UniProt, OMIM and PubMed. HGNC data is CC0." use_when: "HGNC, the authority for human gene names, through the genenames.org REST API: resolve any gene symbol, alias, previous symbol or ID (HGNC, NCBI Gene, Ensembl, UniProt, RefSeq, MGI, RGD) to the current approved symbol, with ambiguous aliases listed rather than guessed; check up to 50 genes at once; and search genes by name, symbol pattern, cytoband or locus type. Records carry the approved name, aliases, previous symbols, locus type, location, gene groups and cross-references that join NCBI Gene, Ensembl, UniProt, OMIM and PubMed. HGNC data is CC0." categories: "Health" capabilities: 3 credits_per_call: 5 --- # HGNC (HUGO Gene Nomenclature Committee) on Firecrawl Alexandria HGNC, the authority for human gene names, through the genenames.org REST API: resolve any gene symbol, alias, previous symbol or ID (HGNC, NCBI Gene, Ensembl, UniProt, RefSeq, MGI, RGD) to the current approved symbol, with ambiguous aliases listed rather than guessed; check up to 50 genes at once; and search genes by name, symbol pattern, cytoband or locus type. Records carry the approved name, aliases, previous symbols, locus type, location, gene groups and cross-references that join NCBI Gene, Ensembl, UniProt, OMIM and PubMed. HGNC data is CC0. - Categories: Health - Category index: [Health category](https://firecrawl.dev/alexandria/agents/categories/health) - Provider key: `genenames-org` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/genenames-org) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/genenames-org/openapi.json) ## Capabilities - [Get](https://firecrawl.dev/alexandria/agents/providers/genenames-org/genes/get): One human gene's approved HGNC record, from whatever you have: a symbol, alias or previous symbol, an HGNC, NCBI Gene, Ensembl, UniProt, RefSeq, MGI or RGD ID, or a genenames.org URL. Says how the input matched, and returns the approved symbol and name, aliases, previous symbols, locus type, location, gene groups and cross-references (NCBI Gene, Ensembl, UniProt, OMIM, RefSeq, MANE Select, CCDS, MGI, RGD, Orphanet, PubMed). An alias shared by several genes is an `ambiguous` result listing every candidate, and a withdrawn HGNC ID that was merged resolves to the gene it went into. Unknown genes are `not_found`. - [Resolve](https://firecrawl.dev/alexandria/agents/providers/genenames-org/genes/resolve): Check up to 50 human gene symbols or IDs in one call, like HGNC's multi-symbol checker. Each input comes back `resolved` to its approved symbol (saying whether it matched an approved symbol, previous symbol, alias or ID), `ambiguous` with every candidate, `withdrawn`, or `not_found`, in input order. When none matches, the result is `not_found`. - [Search](https://firecrawl.dev/alexandria/agents/providers/genenames-org/genes/search): Search HGNC's human genes by free text, where every word must match a symbol, alias, name or other field (`kinase`, `17p13.1`, `zinc finger`), or by HGNC field syntax (`symbol:ZNF*`, `name:"potassium channel" AND locus_type:"gene with protein product"`). Filters for locus group and status; approved genes only by default. An exact symbol, previous-symbol or alias match ranks first. Each result has the HGNC ID, approved symbol and name, locus group and type, location, aliases, previous symbols, and NCBI Gene, Ensembl and UniProt IDs. Offset-paginated; an empty result is a valid empty page. ## 1. Choose this provider when HGNC, the authority for human gene names, through the genenames.org REST API: resolve any gene symbol, alias, previous symbol or ID (HGNC, NCBI Gene, Ensembl, UniProt, RefSeq, MGI, RGD) to the current approved symbol, with ambiguous aliases listed rather than guessed; check up to 50 genes at once; and search genes by name, symbol pattern, cytoband or locus type. Records carry the approved name, aliases, previous symbols, locus type, location, gene groups and cross-references that join NCBI Gene, Ensembl, UniProt, OMIM and PubMed. HGNC data is CC0. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "genenames-org", "capability": "genes/get", "options": { "gene": "p53" } } ``` ## 3. Add provider options Use only the options needed for the task: - `gene` (string): A human gene symbol, alias or previous symbol (`TP53`, `p53`, `HER2`, `SEPT7`; case-insensitive), an HGNC ID (`HGNC:11998`), NCBI Gene ID (`7157`), Ensembl gene ID (`ENSG00000141510`), UniProt accession (`P04637`), RefSeq transcript (`NM_000546.6`), or the MGI or RGD ID of a mouse or rat ortholog. Example: `TP53` - `url` (string): A genenames.org symbol report URL, e.g. `https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:11998`. Exactly one of `gene` and `url`. Example: `https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:11998` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "genenames-org", capability: "genes/get", options: { gene: "p53", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "genenames-org", "capability": "genes/get", "options": { "gene": "p53" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "genenames-org", "capability": "genes/get", "options": { "gene": "p53" } } }' ``` ### CLI ```sh firecrawl scrape 'genenames-org/genes/get' \ --options '{"gene":"p53"}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "genenames-org", "capability": "genes/get", "options": { "gene": "p53" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "genenames-org", "capability": "genes/get", "options": { "gene": "p53" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "candidates": [], "gene": { "alias_names": [ "Li-Fraumeni syndrome" ], "alias_symbols": [ "p53", "LFS1" ], "cross_references": { "ccds_ids": [ "CCDS11118", "CCDS45605", "CCDS45606", "CCDS73963", "CCDS73964", "CCDS73965", "CCDS73966", "CCDS73967", "CCDS73968", "CCDS73969", "CCDS73970", "CCDS73971" ], "ensembl_gene_id": "ENSG00000141510", "enzyme_ids": [], "mane_select": { "ensembl_transcript": "ENST00000269305.9", "refseq_transcript": "NM_000546.6" }, "mgi_ids": [ "MGI:98834" ], "mirbase_id": null, "ncbi_gene_id": "7157", "omim_ids": [ "191170" ], "orphanet_id": "120204", "pubmed_ids": [ "6396087", "3456488", "2047879" ], "refseq_accessions": [ "NM_000546" ], "rgd_ids": [ "RGD:3889" ], "rnacentral_ids": [], "uniprot_ids": [ "P04637" ] }, "curator_notes": [], "date_approved": "1986-01-01", "date_modified": "2023-01-20", "date_name_changed": "2008-01-16", "date_symbol_changed": null, "gene_groups": [ { "id": 4068, "name": "p53 transcription factor family", "url": "https://www.genenames.org/data/genegroup/#!/group/4068" } ], "hgnc_id": "HGNC:11998", "location": "17p13.1", "locus_group": "protein-coding gene", "locus_type": "gene with protein product", "name": "tumor protein p53", "previous_names": [], "previous_symbols": [], "source_url": "https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:11998", "status": "approved", "symbol": "TP53" }, "input": "p53", "license": { "attribution": "HGNC Database, HUGO Gene Nomenclature Committee (HGNC), www.genenames.org (RRID:SCR_002827). Cite: Seal RL et al., Genenames.org: the HGNC resources in 2023, Nucleic Acids Res. 2023. CC0: attribution is recommended, not required.", "name": "CC0 1.0", "url": "https://creativecommons.org/publicdomain/zero/1.0/" }, "matched_on": "alias_symbol", "note": "p53 is an alias of TP53 (HGNC:11998); the approved symbol is TP53.", "observed_at_ms": 1792529111647, "resolution": "resolved" } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Get - Capability: `genes/get` - Description: One human gene's approved HGNC record, from whatever you have: a symbol, alias or previous symbol, an HGNC, NCBI Gene, Ensembl, UniProt, RefSeq, MGI or RGD ID, or a genenames.org URL. Says how the input matched, and returns the approved symbol and name, aliases, previous symbols, locus type, location, gene groups and cross-references (NCBI Gene, Ensembl, UniProt, OMIM, RefSeq, MANE Select, CCDS, MGI, RGD, Orphanet, PubMed). An alias shared by several genes is an `ambiguous` result listing every candidate, and a withdrawn HGNC ID that was merged resolves to the gene it went into. Unknown genes are `not_found`. - Instructions: When you have one gene name or ID from a paper, dataset or user and need the official human symbol and the gene's IDs in other databases. For many genes at once use `resolve`; for genes you can only describe use `search`. - Cost: 5 credits per call - Capability file: [Get](https://firecrawl.dev/alexandria/agents/providers/genenames-org/genes/get) Accepted options: - `gene` (string): A human gene symbol, alias or previous symbol (`TP53`, `p53`, `HER2`, `SEPT7`; case-insensitive), an HGNC ID (`HGNC:11998`), NCBI Gene ID (`7157`), Ensembl gene ID (`ENSG00000141510`), UniProt accession (`P04637`), RefSeq transcript (`NM_000546.6`), or the MGI or RGD ID of a mouse or rat ortholog. Example: `TP53` - `url` (string): A genenames.org symbol report URL, e.g. `https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:11998`. Exactly one of `gene` and `url`. Example: `https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:11998` Response schema example: ```json { "candidates": [], "gene": { "alias_names": [ "Li-Fraumeni syndrome" ], "alias_symbols": [ "p53", "LFS1" ], "cross_references": { "ccds_ids": [ "CCDS11118", "CCDS45605", "CCDS45606", "CCDS73963", "CCDS73964", "CCDS73965", "CCDS73966", "CCDS73967", "CCDS73968", "CCDS73969", "CCDS73970", "CCDS73971" ], "ensembl_gene_id": "ENSG00000141510", "enzyme_ids": [], "mane_select": { "ensembl_transcript": "ENST00000269305.9", "refseq_transcript": "NM_000546.6" }, "mgi_ids": [ "MGI:98834" ], "mirbase_id": null, "ncbi_gene_id": "7157", "omim_ids": [ "191170" ], "orphanet_id": "120204", "pubmed_ids": [ "6396087", "3456488", "2047879" ], "refseq_accessions": [ "NM_000546" ], "rgd_ids": [ "RGD:3889" ], "rnacentral_ids": [], "uniprot_ids": [ "P04637" ] }, "curator_notes": [], "date_approved": "1986-01-01", "date_modified": "2023-01-20", "date_name_changed": "2008-01-16", "date_symbol_changed": null, "gene_groups": [ { "id": 4068, "name": "p53 transcription factor family", "url": "https://www.genenames.org/data/genegroup/#!/group/4068" } ], "hgnc_id": "HGNC:11998", "location": "17p13.1", "locus_group": "protein-coding gene", "locus_type": "gene with protein product", "name": "tumor protein p53", "previous_names": [], "previous_symbols": [], "source_url": "https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:11998", "status": "approved", "symbol": "TP53" }, "input": "p53", "license": { "attribution": "HGNC Database, HUGO Gene Nomenclature Committee (HGNC), www.genenames.org (RRID:SCR_002827). Cite: Seal RL et al., Genenames.org: the HGNC resources in 2023, Nucleic Acids Res. 2023. CC0: attribution is recommended, not required.", "name": "CC0 1.0", "url": "https://creativecommons.org/publicdomain/zero/1.0/" }, "matched_on": "alias_symbol", "note": "p53 is an alias of TP53 (HGNC:11998); the approved symbol is TP53.", "observed_at_ms": 1792529111647, "resolution": "resolved" } ``` ### Resolve - Capability: `genes/resolve` - Description: Check up to 50 human gene symbols or IDs in one call, like HGNC's multi-symbol checker. Each input comes back `resolved` to its approved symbol (saying whether it matched an approved symbol, previous symbol, alias or ID), `ambiguous` with every candidate, `withdrawn`, or `not_found`, in input order. When none matches, the result is `not_found`. - Instructions: To normalize a gene list from a paper, spreadsheet or vendor page to current approved symbols and HGNC, NCBI Gene, Ensembl and UniProt IDs before joining it to other data. - Cost: 5 credits per call - Capability file: [Resolve](https://firecrawl.dev/alexandria/agents/providers/genenames-org/genes/resolve) Accepted options: - `genes` (string[], required): 1 to 50 genes; repeats are checked once. Example: `[]` Response schema example: ```json { "counts": { "ambiguous": 1, "not_found": 1, "resolved": 6, "withdrawn": 0 }, "license": { "attribution": "HGNC Database, HUGO Gene Nomenclature Committee (HGNC), www.genenames.org (RRID:SCR_002827). Cite: Seal RL et al., Genenames.org: the HGNC resources in 2023, Nucleic Acids Res. 2023. CC0: attribution is recommended, not required.", "name": "CC0 1.0", "url": "https://creativecommons.org/publicdomain/zero/1.0/" }, "observed_at_ms": 1792529122492, "results": [ { "candidates": [], "gene": { "alias_symbols": [ "p53", "LFS1" ], "ensembl_gene_id": "ENSG00000141510", "hgnc_id": "HGNC:11998", "location": "17p13.1", "locus_group": "protein-coding gene", "locus_type": "gene with protein product", "name": "tumor protein p53", "ncbi_gene_id": "7157", "previous_symbols": [], "source_url": "https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:11998", "status": "approved", "symbol": "TP53", "uniprot_ids": [ "P04637" ] }, "input": "TP53", "matched_on": "symbol", "note": "TP53 is the approved HGNC symbol.", "resolution": "resolved" }, { "candidates": [], "gene": { "alias_symbols": [ "p53", "LFS1" ], "ensembl_gene_id": "ENSG00000141510", "hgnc_id": "HGNC:11998", "location": "17p13.1", "locus_group": "protein-coding gene", "locus_type": "gene with protein product", "name": "tumor protein p53", "ncbi_gene_id": "7157", "previous_symbols": [], "source_url": "https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:11998", "status": "approved", "symbol": "TP53", "uniprot_ids": [ "P04637" ] }, "input": "p53", "matched_on": "alias_symbol", "note": "p53 is an alias of TP53 (HGNC:11998); the approved symbol is TP53.", "resolution": "resolved" }, { "candidates": [], "gene": { "alias_symbols": [ "CDC3", "SEPT7A", "Septin-7" ], "ensembl_gene_id": "ENSG00000122545", "hgnc_id": "HGNC:1717", "location": "7p14.2", "locus_group": "protein-coding gene", "locus_type": "gene with protein product", "name": "septin 7", "ncbi_gene_id": "989", "previous_symbols": [ "CDC10", "SEPT7" ], "source_url": "https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:1717", "status": "approved", "symbol": "SEPTIN7", "uniprot_ids": [ "Q16181" ] }, "input": "SEPT7", "matched_on": "previous_symbol", "note": "SEPT7 is a previous symbol of SEPTIN7 (HGNC:1717); the approved symbol is SEPTIN7.", "resolution": "resolved" }, { "candidates": [], "gene": { "alias_symbols": [ "PEO", "PEO1", "TWINKLE", "FLJ21832", "TWINL" ], "ensembl_gene_id": "ENSG00000107815", "hgnc_id": "HGNC:1160", "location": "10q24.31", "locus_group": "protein-coding gene", "locus_type": "gene with protein product", "name": "twinkle mtDNA helicase", "ncbi_gene_id": "56652", "previous_symbols": [ "IOSCA", "C10orf2" ], "source_url": "https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:1160", "status": "approved", "symbol": "TWNK", "uniprot_ids": [ "Q96RR1" ] }, "input": "C10orf2", "matched_on": "previous_symbol", "note": "C10orf2 is a previous symbol of TWNK (HGNC:1160); the approved symbol is TWNK.", "resolution": "resolved" }, { "candidates": [], "gene": { "alias_symbols": [ "NEU", "HER-2", "CD340", "HER2", "c-ERB2", "c-ERB-2", "MLN-19", "p185(erbB2)" ], "ensembl_gene_id": "ENSG00000141736", "hgnc_id": "HGNC:3430", "location": "17q12", "locus_group": "protein-coding gene", "locus_type": "gene with protein product", "name": "erb-b2 receptor tyrosine kinase 2", "ncbi_gene_id": "2064", "previous_symbols": [ "NGL" ], "source_url": "https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:3430", "status": "approved", "symbol": "ERBB2", "uniprot_ids": [ "P04626" ] }, "input": "HER2", "matched_on": "alias_symbol", "note": "HER2 is an alias of ERBB2 (HGNC:3430); the approved symbol is ERBB2.", "resolution": "resolved" }, { "candidates": [ { "alias_symbols": [ "CAP" ], "ensembl_gene_id": "ENSG00000165996", "hgnc_id": "HGNC:9639", "location": "10p12.33", "locus_group": "protein-coding gene", "locus_type": "gene with protein product", "matched_on": "alias_symbol", "name": "3-hydroxyacyl-CoA dehydratase 1", "ncbi_gene_id": "9200", "previous_symbols": [ "PTPLA" ], "source_url": "https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:9639", "status": "approved", "symbol": "HACD1", "uniprot_ids": [ "B0YJ81" ] }, { "alias_symbols": [ "CAP", "PLAP", "P-LAP", "IRAP" ], "ensembl_gene_id": "ENSG00000113441", "hgnc_id": "HGNC:6656", "location": "5q15", "locus_group": "protein-coding gene", "locus_type": "gene with protein product", "matched_on": "alias_symbol", "name": "leucyl and cystinyl aminopeptidase", "ncbi_gene_id": "4012", "previous_symbols": [], "source_url": "https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:6656", "status": "approved", "symbol": "LNPEP", "uniprot_ids": [ "Q9UIQ6" ] }, { "alias_symbols": [ "HUNKI", "MCAP", "CAP", "HUNK1", "FSHRG4" ], "ensembl_gene_id": "ENSG00000141867", "hgnc_id": "HGNC:13575", "location": "19p13.12", "locus_group": "protein-coding gene", "locus_type": "gene with protein product", "matched_on": "alias_symbol", "name": "bromodomain containing 4", "ncbi_gene_id": "23476", "previous_symbols": [], "source_url": "https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:13575", "status": "approved", "symbol": "BRD4", "uniprot_ids": [ "O60885" ] }, { "alias_symbols": [ "PTI", "CAP" ], "ensembl_gene_id": "ENSG00000124570", "hgnc_id": "HGNC:8950", "location": "6p25.2", "locus_group": "protein-coding gene", "locus_type": "gene with protein product", "matched_on": "alias_symbol", "name": "serpin family B member 6", "ncbi_gene_id": "5269", "previous_symbols": [ "PI6", "DFNB91" ], "source_url": "https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:8950", "status": "approved", "symbol": "SERPINB6", "uniprot_ids": [ "P35237" ] }, { "alias_symbols": [ "CAP" ], "ensembl_gene_id": "ENSG00000131236", "hgnc_id": "HGNC:20040", "location": "1p34.2", "locus_group": "protein-coding gene", "locus_type": "gene with protein product", "matched_on": "alias_symbol", "name": "cyclase associated actin cytoskeleton regulatory protein 1", "ncbi_gene_id": "10487", "previous_symbols": [], "source_url": "https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:20040", "status": "approved", "symbol": "CAP1", "uniprot_ids": [ "Q01518" ] }, { "alias_symbols": [ "FLJ12406", "CAP", "sh3p12", "ponsin", "KIAA1296" ], "ensembl_gene_id": "ENSG00000095637", "hgnc_id": "HGNC:14565", "location": "10q24.1", "locus_group": "protein-coding gene", "locus_type": "gene with protein product", "matched_on": "alias_symbol", "name": "sorbin and SH3 domain containing 1", "ncbi_gene_id": "10580", "previous_symbols": [ "SH3D5" ], "source_url": "https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:14565", "status": "approved", "symbol": "SORBS1", "uniprot_ids": [ "Q9BX66" ] } ], "gene": null, "input": "CAP", "matched_on": "alias_symbol", "note": "CAP is an alias of 6 approved genes: HACD1 (HGNC:9639), LNPEP (HGNC:6656), BRD4 (HGNC:13575), SERPINB6 (HGNC:8950), CAP1 (HGNC:20040), SORBS1 (HGNC:14565); choose one by HGNC ID.", "resolution": "ambiguous" }, { "candidates": [], "gene": { "alias_symbols": [ "UBE1X", "POC20", "CFAP124" ], "ensembl_gene_id": "ENSG00000130985", "hgnc_id": "HGNC:12469", "location": "Xp11.3", "locus_group": "protein-coding gene", "locus_type": "gene with protein product", "name": "ubiquitin like modifier activating enzyme 1", "ncbi_gene_id": "7317", "previous_symbols": [ "A1S9T", "GXP1", "UBE1" ], "source_url": "https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:12469", "status": "approved", "symbol": "UBA1", "uniprot_ids": [ "P22314" ] }, "input": "HGNC:6", "matched_on": "previous_hgnc_id", "note": "HGNC:6 (A1S9T) was withdrawn and merged into UBA1 (HGNC:12469); the approved symbol is UBA1.", "resolution": "resolved" }, { "candidates": [], "gene": null, "input": "NOTAGENE1", "matched_on": null, "note": "No HGNC record has NOTAGENE1 as an approved symbol, previous symbol or alias.", "resolution": "not_found" } ] } ``` ### Search - Capability: `genes/search` - Description: Search HGNC's human genes by free text, where every word must match a symbol, alias, name or other field (`kinase`, `17p13.1`, `zinc finger`), or by HGNC field syntax (`symbol:ZNF*`, `name:"potassium channel" AND locus_type:"gene with protein product"`). Filters for locus group and status; approved genes only by default. An exact symbol, previous-symbol or alias match ranks first. Each result has the HGNC ID, approved symbol and name, locus group and type, location, aliases, previous symbols, and NCBI Gene, Ensembl and UniProt IDs. Offset-paginated; an empty result is a valid empty page. - Instructions: To find genes you can describe but not name exactly: a gene family, a cytoband, a symbol prefix or a word in the gene name. Then call `get` for one gene's full record. - Cost: 5 credits per call - Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/genenames-org/genes/search) Accepted options: - `limit` (number): Results per page. Example: `10` - `locus_group` (string): Only genes in this locus group. Example: `protein-coding gene` - `offset` (number): Zero-based index of the first result. Example: `0` - `query` (string, required): Free text (all words must match) or HGNC field syntax with fields such as `symbol`, `alias_symbol`, `prev_symbol`, `name`, `locus_type`, `locus_group`; a trailing `*` matches a prefix (`ZNF*`). Example: `` - `status` (string): `approved` (default), `withdrawn` entries only, or `any`. Example: `approved` Response schema example: ```json { "hgnc_query": "(symbol:\"BRAF\"^20 OR prev_symbol:\"BRAF\"^10 OR alias_symbol:\"BRAF\"^10 OR \"BRAF\") AND status:\"Approved\"", "license": { "attribution": "HGNC Database, HUGO Gene Nomenclature Committee (HGNC), www.genenames.org (RRID:SCR_002827). Cite: Seal RL et al., Genenames.org: the HGNC resources in 2023, Nucleic Acids Res. 2023. CC0: attribution is recommended, not required.", "name": "CC0 1.0", "url": "https://creativecommons.org/publicdomain/zero/1.0/" }, "next_offset": null, "observed_at_ms": 1792529125595, "offset": 0, "query": "BRAF", "results": [ { "alias_symbols": [ "BRAF1", "BRAF-1" ], "ensembl_gene_id": "ENSG00000157764", "hgnc_id": "HGNC:1097", "location": "7q34", "locus_group": "protein-coding gene", "locus_type": "gene with protein product", "name": "B-Raf proto-oncogene, serine/threonine kinase", "ncbi_gene_id": "673", "previous_symbols": [], "score": 282.40216, "source_url": "https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:1097", "status": "approved", "symbol": "BRAF", "uniprot_ids": [ "P15056" ] }, { "alias_symbols": [ "LINC00586" ], "ensembl_gene_id": "ENSG00000278910", "hgnc_id": "HGNC:43877", "location": "9q21.11-q21.12", "locus_group": "non-coding RNA", "locus_type": "RNA, long non-coding", "name": "BRAF-activated non-protein coding RNA", "ncbi_gene_id": "100885775", "previous_symbols": [], "score": 126.93917, "source_url": "https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:43877", "status": "approved", "symbol": "BANCR", "uniprot_ids": [] }, { "alias_symbols": [ "BRAF2" ], "ensembl_gene_id": "ENSG00000224775", "hgnc_id": "HGNC:18615", "location": "Xq13.3", "locus_group": "pseudogene", "locus_type": "pseudogene", "name": "BRAF pseudogene 1", "ncbi_gene_id": "286494", "previous_symbols": [ "BRAFPS2" ], "score": 126.93917, "source_url": "https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:18615", "status": "approved", "symbol": "BRAFP1", "uniprot_ids": [] }, { "alias_symbols": [ "KIAA0803", "AKAP350", "AKAP450", "CG-NAP", "YOTIAO", "HYPERION", "PRKA9", "MU-RMS-40.16A", "PPP1R45", "LQT11" ], "ensembl_gene_id": "ENSG00000127914", "hgnc_id": "HGNC:379", "location": "7q21.2", "locus_group": "protein-coding gene", "locus_type": "gene with protein product", "name": "A-kinase anchoring protein 9", "ncbi_gene_id": "10142", "previous_symbols": [], "score": 30.448015, "source_url": "https://www.genenames.org/data/gene-symbol-report/#!/hgnc_id/HGNC:379", "status": "approved", "symbol": "AKAP9", "uniprot_ids": [ "Q99996" ] } ], "total_count": 4 } ```