# Human Protein Atlas · Search

Get health and medical data with Human Protein Atlas · Search from Alexandria through one Spiral API key. Find proteins in a compartment (location Nucleoli, min_reliability Supported), genes enriched in a tissue (tissue liver) or cell type (cell_type hepatocytes), or both at once; then call protein for one gene's full localization and expression, or antibodies for its reagents. 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` / `proteinatlas-org/proteins/search`
- Page: https://spiral.ai/tools/alexandria/proteinatlas-org/proteins/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 100 | 20 | limit |
| `query` | text |  | — | Free text (kinase, insulin receptor) or HPA search syntax (protein_class:Transcription factors), ANDed with the other filters. Field values HPA does not know match nothing rather than failing. |
| `offset` | number | 0 to 25000 | 0 | Results to skip; pass the previous page's next_offset. |
| `tissue` | text |  | — | Tissue name as HPA writes it, case-insensitive: liver, skeletal muscle, cerebral cortex, pancreas. |
| `location` | one of | Acrosome, Actin filaments, Aggresome, Annulus, Basal body, Calyx, Cell Junctions, Centriolar satellite, Centrosome, Cleavage furrow, Connecting piece, Cytokinetic bridge, Cytoplasmic bodies, Cytosol, End piece, Endoplasmic reticulum, Endosomes, Equatorial segment, Flagellar centriole, Focal adhesion sites, Golgi apparatus, Intermediate filaments, Kinetochore, Lipid droplets, Lysosomes, Microtubule ends, Microtubules, Mid piece, Midbody, Midbody ring, Mitochondria, Mitotic chromosome, Mitotic spindle, Nuclear bodies, Nuclear membrane, Nuclear speckles, Nucleoli, Nucleoli fibrillar center, Nucleoli rim, Nucleoplasm, Perinuclear theca, Peroxisomes, Plasma membrane, Primary cilium, Primary cilium tip, Primary cilium transition zone, Principal piece, Rods & Rings, Vesicles | — | Subcellular location term exactly as HPA names it. |
| `cell_type` | text |  | — | Single cell type name as HPA writes it, case-insensitive and usually plural: hepatocytes, T-cells, cardiomyocytes. |
| `specificity` | list |  | — | RNA specificity categories for tissue or cell_type; default all three. enriched: at least 4x every other tissue or cell type; group_enriched: 4x in a small group; enhanced: 4x the mean. |
| `min_reliability` | one of | Enhanced, Supported, Approved, Uncertain | — | Lowest reliability of location to include; default Uncertain (all). Supported keeps Enhanced and Supported. |
| `main_location_only` | true or false |  | — | Only genes with location as a main location. |

## 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": "proteinatlas-org/proteins/search",
    "input": {
      "limit": 20
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=proteinatlas-org%2Fproteins%2Fsearch

## Common questions

### Human Protein Atlas · Search

**How much does Human Protein Atlas · 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 Human Protein Atlas · Search through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "proteinatlas-org/proteins/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 Human Protein Atlas · Search?**

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

**Can my AI agent use Human Protein Atlas · Search?**

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

