# NCBI Gene Search API

> Search NCBI Gene for any organism and get gene summaries: symbol, name, chromosome and aliases

- Vendor: `ncbigenesearchapi` · version 1.0 · category Science · tags ncbi gene api, gene search api, genomics api, entrez api, gene symbol api, bioinformatics api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/ncbigenesearchapi
- This document: https://apiclay.com/docs/ncbigenesearchapi.md
- OpenAPI 3.1: https://apiclay.com/api/ncbigenesearchapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `ncbigenesearchapi`
- Updated: 2026-11-18

## About

## NCBI Gene Search API

Search the NCBI Gene database through the official Entrez E-utilities: find gene ids by symbol, name, organism or any Entrez query, then get each gene's summary with official symbol, full name, description, chromosome, map location, aliases, genomic coordinates and organism.

Data comes from **ncbi.nlm.nih.gov** (https://www.ncbi.nlm.nih.gov/gene). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/search?term=BRCA1[sym] AND human[orgn]` for ids, then `/summary?id=672`.

### Routes

#### GET `/search` - Gene search
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| term | query | string | yes | Entrez query, e.g. `BRCA1[sym] AND human[orgn]`, `insulin AND mouse[orgn]`. |
| retmax | query | number | no | Ids per page (default 20). |
| retstart | query | number | no | Offset. |

Returns: `esearchresult` with `count`, `idlist[]`, `querytranslation`.

#### GET `/summary` - Gene summary
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| id | query | string | yes | Gene id(s), comma-separated, e.g. `672,7157`. |

Returns: `result.uids[]` and per id: `name`, `description`, `chromosome`, `maplocation`, `otheraliases`, `summary`, `organism`, `genomicinfo[]`.

### Caveats

- NCBI asks for at most 3 requests per second without an API key.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by ncbi.nlm.nih.gov.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /search — Gene search
- Gateway: `GET https://api.apiclay.com/v1/api/ncbigenesearchapi/search`
- Public query params: `term` (string, required), `retmax` (number), `retstart` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /summary — Gene summary
- Gateway: `GET https://api.apiclay.com/v1/api/ncbigenesearchapi/summary`
- Public query params: `id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/ncbigenesearchapi/search?term=<term>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
