# NCBI GEO · Search

Get health and medical data with NCBI GEO · Search from Alexandria through one Spiral API key. Start here to find GEO accessions for a disease, gene, tissue, organism, assay or platform; then call `series` for the design, samples and files of a GSE, `sample` for one GSM's characteristics and protocols, or `platform` for a GPL. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Health
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `geo-ncbi-nlm-nih-gov/datasets/search`
- Page: https://spiral.ai/tools/alexandria/geo-ncbi-nlm-nih-gov/datasets/search

## Pricing

$0.00873 per call.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `limit` | number | 1 to 50 | 20 | Results per page. |
| `query` | text |  | — | Entrez query over GEO DataSets: free text or field-tagged terms such as `brca1[Gene Name]`, `liver[Title]`, `smith j[Author]`, with AND/OR/NOT. Optional when a filter is given. |
| `offset` | number | 0 to 1000000 | 0 | Zero-based index of the first result. |
| `max_date` | text |  | — | Latest release (public) date, same forms as `min_date`. Pattern: ^[0-9]{4}(/[0-9]{2}(/[0-9]{2})?)?$. |
| `min_date` | text |  | — | Earliest release (public) date, `YYYY`, `YYYY/MM` or `YYYY/MM/DD`. Pattern: ^[0-9]{4}(/[0-9]{2}(/[0-9]{2})?)?$. |
| `organism` | text |  | — | Organism, scientific or common name (`Homo sapiens`, `mouse`); includes sub-taxa. |
| `platform` | text |  | — | Platform accession (`GPL570`); restricts results to records using that platform. Pattern: ^\s*[Gg][Pp][Ll][0-9]{1,9}\s*$. |
| `entry_type` | one of | GSE, GDS, GPL, GSM, all | GSE | Record type: `GSE` series (default), `GDS` curated DataSets, `GPL` platforms, `GSM` samples, or `all`. |
| `dataset_type` | text |  | — | Experiment type exactly as GEO names it, e.g. `Expression profiling by array`, `Expression profiling by high throughput sequencing`, `Methylation profiling by high throughput sequencing`, `Genome binding/occupancy profiling by high throughput sequencing`. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "geo-ncbi-nlm-nih-gov/datasets/search",
    "input": {
      "limit": 20
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=geo-ncbi-nlm-nih-gov%2Fdatasets%2Fsearch

## Common questions

### NCBI GEO · Search

**How much does NCBI GEO · Search cost?**

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use NCBI GEO · Search through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "geo-ncbi-nlm-nih-gov/datasets/search"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use NCBI GEO · Search?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use NCBI GEO · Search?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

