# AlphaFold API
> The AlphaFold Protein Structure Database as an API, powered by EMBL-EBI and Google DeepMind. AlphaFold predicts the three-dimensional structure of a protein from its amino-acid sequence with experimental-level accuracy, and the database now covers over 200 million proteins — nearly every sequence in UniProt. Look up the AlphaFold model for any protein by its UniProt accession and get its gene and protein description, organism and sequence length, model version and creation date, the global confidence metric, the full amino-acid sequence, and direct download links to the predicted structure as mmCIF, PDB and BinaryCIF together with the Predicted Aligned Error (PAE) plot image and data; and read a protein's structural coverage — the AlphaFold predicted model(s) and any linked structures with their provider, model category, method and the UniProt residue range covered. Ideal for structural biology, drug discovery and target assessment, protein engineering, molecular visualisation and teaching. Proteins are identified by UniProt accession (for example P00520 or P38398). Data from the AlphaFold DB (CC-BY 4.0). For experimentally-determined 3D structures see the PDB API, for protein sequences and functional annotation the UniProt API, and for families & domains InterPro.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/alphafold-api/..."
```

## Pricing
- **Free** (Free) — 560 calls/Mo, 2 req/s
- **Starter** ($7/Mo) — 21,100 calls/Mo, 6 req/s
- **Pro** ($21/Mo) — 93,500 calls/Mo, 15 req/s
- **Mega** ($59/Mo) — 405,000 calls/Mo, 40 req/s

## Endpoints

### Structures

#### `GET /v1/prediction` — AlphaFold predicted structure

**Parameters:**
- `uniprot` (query, required, string) — UniProt accession, e.g. P00520 Example: `P00520`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/alphafold-api/v1/prediction?uniprot=P00520"
```

**Response:**
```json
{
    "data": {
        "prediction": {
            "url": "https://alphafold.ebi.ac.uk/entry/P00520",
            "gene": "Abl1",
            "protein": "Tyrosine-protein kinase ABL1",
            "uniprot": "P00520",
            "entry_id": "AF-P00520-F1",
            "organism": "Mus musculus",
            "sequence": "MLEICLKLVGCKSKKGLSSSSSCYLEEALQRPVASDFEPQGLSEAARWNSKENLLAGPSENDPNLFVALYDFVASGDNTLSITKGEKLRVLGYNHNGEWCEAQTKNGQGWVPSNYITPVNSLEKHSWYHGPVSRNAAEYLLSSGINGSFLVRESESSPGQRSISLRYEGRVYHYRINTASDGKLYVSSESRFNTLAELVHHHSTVADGLITTLHYPAPKRNKPTIYGVSPNYDKWEMERTDITMKHKLGGGQYGEVYEGVWKKYSLTVAVKTLKEDTMEVEEFLKEAAVMKEIKHPNLVQLLGVCTREPPFYIITEFMTYGNLLDYLRECNRQEVSAVVLLYMATQISSAMEYLEKKNFIHRDLAARNCLVGENHLVKVADFGLSRLMTGDTYTAHAGAKFPIKWTAPESLAYNKFSIKSDVWAFGVLLWEIATYGMSPYPGIDLSQVYELLEKDYRMERPEGCPEKVYELMRACWQWNPSDRPSFAEIHQAFETMFQESSISDEVEKELGKRGTRGGAGSMLQAPELPTKTRTCRRAAEQKDAPDTPELLHTKGLGESDALDSEPAVSPLLPRKERGPPDGSLNEDERLLPRDRKTNLFSALIKKKKKMAPTPPKRSSSFREMDGQPDRRGASEDDSRELCNGPPALTSDAAEPTKSPKASNGAGVPNGAFREPGNSGFRSPHMWKKSSTLTGSRLAAAEEESGMSSSKRFLRSCSASCMPHGARDTEWRSVTLPRDLPSAGKQFDSSTFGGHKSEKPALPRKRTSESRSEQVAKSTAMPPPRLVKKNEEAAEEGFKDTESSPGSSPPSLTPKLLRRQVTASPSSGLSHKEEATKGSASGMGTPATAEPAPPSNKVGLSKASSEEMRVRRHKHSSESPGRDKGRLAKLKPAPPPPPACTGKAGKPAQSPSQEAGEAGGPTKTKCTSLAMDAVNTDPTKAGPPGEGLRKPVPPSVPKPQSTAKPPGTPTSPVSTPSTAPAPSPLAGDQQPSSAAFIPLISTRVSLRKTRQPPERIASGTITKGVVLDSTEALCLAISRNSEQMASHSAVLEAGKNLYTFCVSYVDSIQQMRNKFAFREAINKLESNLRELQICPATASSGPAATQDFSKLLSSVKEISDIVRR",
            "taxon_id": 10090,
            "downlo
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/summary` — A protein structural coverage

**Parameters:**
- `uniprot` (query, required, string) — UniProt accession Example: `P00520`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/alphafold-api/v1/summary?uniprot=P00520"
```

**Response:**
```json
{
    "data": {
        "summary": {
            "uniprot": "P00520",
            "structures": [
                {
                    "url": "https://alphafold.ebi.ac.uk/entry/AF-P00520-F1",
                    "category": "AB-INITIO",
                    "provider": "AlphaFold DB",
                    "identifier": "AF-P00520-F1",
                    "resolution": null,
                    "coverage_end": 1123,
                    "coverage_start": 1,
                    "experimental_method": null
                }
            ],
            "sequence_length": 1123,
            "structure_count": 1
        }
    },
    "meta": {
        "timestamp": "2026-06-01T16:24:09.692Z",
        "request_id": "6de7bf65-bb79-4569-8b9a-bf28bd135c11"
    },
    "status": "ok",
    "message": "Summary retrieved",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Usage notes

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/alphafold-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "DeepMind's AlphaFold predicted 3D structures for over 200 million proteins, hosted by EMBL-EBI. /v1/prediction?uniprot=P00520 = the AlphaFold model for a protein (looked up by UniProt accession) — its gene, protein description, organism, sequence length, model version and creation date, the global confidence metric, the full amino-acid sequence, and direct download links to the structure as mmCIF, PDB and BinaryCIF plus the predicted-aligned-error (PAE) plot image and data; /v1/summary?uniprot=P00520 = the protein's complete structural coverage — every experimental structure (PDB) and predicted model (AlphaFold) available for it, each with provider, model category, experimental method, resolution and the UniProt residue range it covers. Proteins are identified by UniProt accession (e.g. P00520, P38398). Data from the AlphaFold DB (CC-BY 4.0). For experimental 3D structures see the PDB API, for protein sequences & annotation UniProt, for families & domains InterPro.",
        "source": "AlphaFold Protein Structure Database — EMBL-EBI & Google DeepMind (alphafold.ebi.ac.uk)",
        "endpoints": [
            "/v1/prediction",
            "/v1/summary",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T16:24:09.779Z",
        "request_id": "08c6da10-fec0-4c42-8a30-c0d048a66b88"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/alphafold-api
OpenAPI spec: https://www.oanor.com/api/alphafold-api/openapi.json