Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaHealthAvailable now

Human Protein Atlas · Search

proteinatlas-org/proteins/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.

Pricing

$0.00873 per call.

Limits

Runs
In the background
Returns
json
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

FieldKindDefaultDescription
limitnumber
1 to 100
20

limit

querytext—

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.

offsetnumber
0 to 25000
0

Results to skip; pass the previous page's next_offset.

tissuetext—

Tissue name as HPA writes it, case-insensitive: liver, skeletal muscle, cerebral cortex, pancreas.

locationone 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_typetext—

Single cell type name as HPA writes it, case-insensitive and usually plural: hepatocytes, T-cells, cardiomyocytes.

specificitylist—

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_reliabilityone of
Enhanced, Supported, Approved, Uncertain
—

Lowest reliability of location to include; default Uncertain (all). Supported keeps Enhanced and Supported.

main_location_onlytrue or false—

Only genes with location as a main location.

Same request in code

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
    }
  }'

Frequently asked questions

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.