STRING: protein interactions and functional enrichment · Partners
string-db-org/interactions/partnersGet health and medical data with STRING: protein interactions and functional enrichment · Partners from Alexandria through one Spiral API key. What interacts with one protein, and with what kind of evidence: 'STRING partners of PCSK9 above 0.7', 'physical partners of TP53', 'which partners of X have experimental evidence' (look at scores.experiments). 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
| Field | Kind | Default | Description |
|---|---|---|---|
protein required | text | — | A gene symbol (PCSK9, Trp53), UniProt accession (P04637), Ensembl protein ID (ENSP00000269305) or STRING ID (9606.ENSP00000269305). Gene symbols and aliases are matched loosely (p53 finds TP53), so check preferred_name in the answer; use the species' own symbol or an accession for an exact match. |
limit | number 1 to 200 | 20 | Most partners to return, best first. limit_reached tells whether there are more. |
species | number 1 to … | 9606 | The organism: an NCBI taxon ID (9606 human, 10090 mouse, 10116 rat, 7955 zebrafish, 7227 fruit fly, 6239 C. elegans, 4932 baker's yeast, 3702 Arabidopsis, 511145 E. coli K-12; STRING covers about 12,500) or one of the names human, mouse, rat, zebrafish, fruit fly, worm, yeast, arabidopsis, e. coli, chicken, cow, pig, dog (or the Latin name). Defaults to human, or to the taxon of a STRING ID given as protein (10090.ENSMUSP00000104298 is mouse). Proteins are looked up in this species only. |
min_score | number 0 to 1 | 0.4 | Minimum combined confidence score, 0 to 1. STRING's bands: 0.15 low, 0.4 medium (default), 0.7 high, 0.9 highest. Use 0.7 for 'high confidence'. |
network_type | one of functional, physical | functional | functional: any association (shared pathway or process, co-expression, text mining and physical binding). physical: only evidence that the proteins bind each other or are in one complex. |
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": "string-db-org/interactions/partners",
"input": {
"protein": "<protein>"
}
}'Frequently asked questions
How much does STRING: protein interactions and functional enrichment · Partners 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 STRING: protein interactions and functional enrichment · Partners through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "string-db-org/interactions/partners"` 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 STRING: protein interactions and functional enrichment · Partners?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use STRING: protein interactions and functional enrichment · Partners?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.