biothings_query_genes
Search for genes using structured Lucene queries with field-specific terms like symbol, name, or taxid. Returns gene details including symbol, name, taxid, and entrezgene.
Instructions
Search genes via Lucene query, returning gene details and query metadata.
**IMPORTANT:** This endpoint requires structured queries using specific field names.
Simple natural language queries like "CDK2 gene" or "human kinase" will **NOT** work.
You **MUST** specify the field you are querying, e.g., `symbol:CDK2`, `name:"cyclin-dependent kinase 2"`, `taxid:9606`.
Use this tool when you need to *search* for genes based on criteria, not when you already know the specific gene ID.
If you know the exact Entrez or Ensembl ID, use the `get_gene` tool instead for faster retrieval.
**Supported Query Features (based on Lucene syntax):**
1. Simple Term Queries: `q=cdk2` (Searches across default fields)
2. Fielded Queries: `q=symbol:CDK2`, `q=name:"cyclin-dependent kinase 2"`
3. Range Queries: `q=taxid:[9606 TO 10090]`
4. Boolean Queries: `q=symbol:CDK2 AND taxid:9606`
5. Wildcard Queries: `q=symbol:CDK*`
Returns gene details including symbol, name, taxid, and entrezgene.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | ||
| size | No | ||
| skip | No | ||
| sort | No | ||
| No | |||
| fields | No | all | |
| species | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hits | Yes | ||
| took | No | ||
| total | No | ||
| max_score | No |