UniProt

App · 20 actions

Look up proteins in UniProt, the reference database of protein sequences and function: search entries, read a protein's names, gene, function, diseases, sequence, features and GO terms, explore sequence clusters (UniRef), the sequence archive (UniParc), proteomes, taxonomy, keywords, diseases and literature, and map IDs between databases.

Actions

ActionWhat it does
Get diseaseGet a disease by its UniProt ID: definition, acronym, other names, keywords and cross-references.
Get ID mapping resultsRead a finished ID mapping job's results, a page at a time: each ID with what it maps to (an ID can map to several), plus the IDs that could not be mapped.
Get ID mapping statusCheck whether an ID mapping job has finished, optionally waiting up to a minute for it, with what it maps and any errors.
Get keywordGet a keyword: its definition, category, synonyms, matching GO terms, the keywords above and below it, and protein counts.
Get proteinGet a protein's UniProtKB entry in readable fields: names, gene, organism, function, where in the cell it is, diseases, length, mass, sequence, keywords, GO terms, and its PDB, AlphaFold, Ensembl, RefSeq and family links.
Get protein sequence (FASTA)Get a protein's amino-acid sequence in FASTA format, ready to save or send to an alignment tool, with the header and the bare sequence split out.
Get proteomeGet a proteome: its organism, protein and gene counts (reviewed and unreviewed), completeness, genome assembly, and the chromosomes or other components it is made of.
Get taxonGet a taxon by its ID: scientific and common names, rank, parent, lineage, other names, links and how many proteins and proteomes it has.
Get UniParc sequenceGet a UniParc sequence with its checksums, InterPro domains and UniProtKB accessions, and a page of the database records that hold it (UniProtKB, RefSeq, Ensembl, EMBL and more).
Get UniRef clusterGet a UniRef cluster: its size, the organisms it spans, its representative protein and sequence, and a page of its members.
List protein featuresList the features marked along a protein's sequence, with their positions: domains, regions, binding and active sites, modifications, signal peptides, transmembrane parts and, when asked, natural variants and mutagenesis results.
Search diseasesSearch the human diseases UniProt links to proteins, with each one's definition, other names and OMIM and MeSH references.
Search keywordsSearch UniProt's keywords, the controlled terms that tag entries by function, location, disease and more, with each one's definition and protein counts.
Search literatureSearch the papers UniProt cites by title words, author or journal, with how many protein entries cite each one and a link to it on PubMed.
Search proteinsSearch UniProtKB's protein entries by words, gene, function or UniProt's query syntax, optionally only reviewed (Swiss-Prot) entries from one organism.
Search proteomesSearch the proteomes (the full protein sets of sequenced organisms) by organism, with each one's size, BUSCO completeness and genome assembly.
Search taxonomySearch UniProt's taxonomy for organisms and groups by name, optionally of one rank, with each one's taxon ID, lineage and protein counts.
Search UniParc sequencesSearch UniParc, the archive of every distinct protein sequence in the public databases, by accession, database ID, checksum, gene or organism.
Search UniRef clustersSearch UniRef, which groups similar sequences into clusters at 100%, 90% and 50% identity, for example to find a protein's close relatives.
Submit ID mappingStart a job that maps IDs from one database to another, such as UniProt accessions to Ensembl genes or gene names to UniProt entries.

Get disease

Get a disease by its UniProt ID: definition, acronym, other names, keywords and cross-references.

Inputs

Disease IDdisease_idtextRequired
The disease, such as DI-01904 (Li-Fraumeni syndrome).

Outputs

acronymtext
Its acronym.
alternative_nameslist
Other names for it.
cross_referenceslist
It in other databases (MIM, MeSH...).
definitiontext
What it is.
idtext
The disease's ID, e.g. 'DI-01904'.
keywordslist
UniProt's keywords for it.
nametext
Its name.
reviewed_protein_countnumber
Reviewed proteins linked to it.
urltext
The disease on uniprot.org.
Example output
{
  "acronym": "LFS",
  "alternative_names": [
    "LFL",
    "Sarcoma family syndrome of Li and Fraumeni"
  ],
  "cross_references": [
    {
      "database": "MIM",
      "id": "151623"
    }
  ],
  "definition": "An autosomal dominant familial cancer syndrome.",
  "id": "DI-01904",
  "keywords": [
    "Li-Fraumeni syndrome"
  ],
  "name": "Li-Fraumeni syndrome",
  "reviewed_protein_count": 2,
  "url": "https://www.uniprot.org/diseases/DI-01904"
}

Get ID mapping results

Read a finished ID mapping job's results, a page at a time: each ID with what it maps to (an ID can map to several), plus the IDs that could not be mapped.

Inputs

Job IDjob_idtextRequired
The mapping job's ID, from 'Submit ID mapping'.
Page sizepage_sizenumber
How many to return, 1 to 500. Defaults to 25.From 1 to 500.
Next page cursorcursortext
The 'next_cursor' from the previous page, to get the page after it. Keep the other fields the same.

Outputs

countnumber
Mappings on this page.
failed_idslist
IDs that could not be mapped.
job_idtext
The mapping job's ID.
next_cursortext
Pass as 'cursor' for the next page; blank on the last.
obsolete_countnumber
Mapped entries that are now obsolete.
resultslist
The mappings on this page.
totalnumber
Mappings in all.
Example output
{
  "count": 2,
  "failed_ids": [],
  "job_id": "AoofAwrYHV",
  "next_cursor": "",
  "obsolete_count": 0,
  "results": [
    {
      "from": "P04637",
      "to": "ENSG00000141510.20"
    },
    {
      "from": "P31749",
      "to": "ENSG00000142208.20"
    }
  ],
  "total": 2
}

Get ID mapping status

Check whether an ID mapping job has finished, optionally waiting up to a minute for it, with what it maps and any errors.

Inputs

Job IDjob_idtextRequired
The mapping job's ID, from 'Submit ID mapping'.
Wait up to (seconds)wait_secondsnumber
How long to wait for the job to finish before answering, 0 to 60. Most small jobs finish within a few seconds.From 0 to 60.

Outputs

errorslist
What went wrong, when the job failed.
finishedtrue/false
True once the results can be read.
from_dbtext
The source database.
id_countnumber
How many IDs were sent.
job_idtext
The mapping job's ID.
statustext
NEW, RUNNING, FINISHED or ERROR.
to_dbtext
The target database.
Example output
{
  "errors": [],
  "finished": true,
  "from_db": "UniProtKB_AC-ID",
  "id_count": 2,
  "job_id": "AoofAwrYHV",
  "status": "FINISHED",
  "to_db": "Ensembl"
}

Get keyword

Get a keyword: its definition, category, synonyms, matching GO terms, the keywords above and below it, and protein counts.

Inputs

Keyword IDkeyword_idtextRequired
The keyword, such as KW-0053 (Apoptosis).

Outputs

categorytext
Its category.
childrenlist
The keywords under it.
definitiontext
What it means.
go_termslist
The GO terms it matches.
idtext
The keyword's ID, e.g. 'KW-0053'.
nametext
Its name.
parentslist
The keywords it sits under.
reviewed_protein_countnumber
Reviewed proteins tagged with it.
synonymslist
Other names for it.
unreviewed_protein_countnumber
Unreviewed proteins tagged with it.
urltext
The keyword on uniprot.org.
Example output
{
  "category": "Biological process",
  "children": [],
  "definition": "Protein involved in apoptotic programmed cell death.",
  "go_terms": [
    {
      "id": "GO:0006915",
      "name": "apoptotic process"
    }
  ],
  "id": "KW-0053",
  "name": "Apoptosis",
  "parents": [
    {
      "id": "KW-9999",
      "name": "Biological process"
    }
  ],
  "reviewed_protein_count": 2976,
  "synonyms": [
    "Type I programmed cell death"
  ],
  "unreviewed_protein_count": 273917,
  "url": "https://www.uniprot.org/keywords/KW-0053"
}

Get protein

Get a protein's UniProtKB entry in readable fields: names, gene, organism, function, where in the cell it is, diseases, length, mass, sequence, keywords, GO terms, and its PDB, AlphaFold, Ensembl, RefSeq and family links.

Inputs

AccessionaccessiontextRequired
The protein's UniProtKB accession, such as P04637 (P04637-2 for an isoform), or its entry name, such as P53_HUMAN. 'Search proteins' shows it.

Outputs

accessiontext
The accession, e.g. 'P04637'.
alphafold_idtext
Its AlphaFold model, by accession.
alternative_nameslist
Other names for the protein.
annotation_scorenumber
UniProt's annotation score, 1 (least) to 5 (most).
catalytic_activitylist
The reactions it catalyses.
common_nametext
The organism's common name, e.g. 'Human'.
diseaseslist
Diseases it is involved in.
ec_numberslist
Its enzyme (EC) numbers.
ensembl_geneslist
Its Ensembl gene IDs.
entry_nametext
The entry name, e.g. 'P53_HUMAN'.
familieslist
Its protein families and domains.
first_publictext
When the entry was first published.
functiontext
What the protein does.
genetext
The gene's name, e.g. 'TP53'.
gene_synonymslist
Other names for the gene.
go_termslist
Its Gene Ontology terms.
keywordslist
UniProt's keywords for it.
last_updatedtext
When the entry's annotation last changed.
lengthnumber
The sequence length, in amino acids.
lineagelist
The organism's lineage, broadest first.
massnumber
The mass, in daltons.
ncbi_gene_idslist
Its NCBI Gene IDs.
organismtext
The organism's scientific name.
pathwaytext
The pathways it is part of.
pdb_idslist
The PDB structures of it.
protein_existencetext
The evidence the protein exists, e.g. '1: Evidence at protein level'.
protein_nametext
The protein's recommended name.
refseq_idslist
Its RefSeq protein IDs.
requestedtext
The accession or entry name asked for; it differs from 'accession' when that one was merged into this entry, or was an entry name.
reviewedtrue/false
True for a reviewed (Swiss-Prot) entry.
sequencetext
The amino-acid sequence.
subcellular_locationslist
Where in the cell it is found.
subunittext
What it forms complexes with.
summarytext
One line: gene, protein, organism, length, reviewed or not.
taxon_idnumber
The organism's taxon ID, e.g. 9606.
tissue_specificitytext
Where it is expressed.
uniparc_idtext
Its sequence's UniParc ID.
urltext
The entry on uniprot.org.
versionnumber
The entry's version.
Example output
{
  "accession": "P04637",
  "alphafold_id": "P04637",
  "alternative_names": [
    "Antigen NY-CO-13",
    "Phosphoprotein p53",
    "Tumor suppressor p53"
  ],
  "annotation_score": 5.0,
  "catalytic_activity": [],
  "common_name": "Human",
  "diseases": [
    {
      "acronym": "LFS",
      "description": "An autosomal dominant familial cancer syndrome.",
      "id": "DI-01904",
      "mim_id": "151623",
      "name": "Li-Fraumeni syndrome",
      "note": "The disease is caused by variants affecting the gene represented in this entry"
    }
  ],
  "ec_numbers": [],
  "ensembl_genes": [
    "ENSG00000141510.20"
  ],
  "entry_name": "P53_HUMAN",
  "families": [
    {
      "database": "Pfam",
      "id": "PF00870",
      "name": "P53"
    }
  ],
  "first_public": "1987-08-13",
  "function": "Multifunctional transcription factor that induces cell cycle arrest, DNA repair or apoptosis upon binding to its target DNA sequence.",
  "gene": "TP53",
  "gene_synonyms": [
    "P53"
  ],
  "go_terms": [
    {
      "aspect": "Biological process",
      "evidence": "IDA:UniProtKB",
      "id": "GO:0006915",
      "term": "apoptotic process"
    }
  ],
  "keywords": [
    {
      "category": "Biological process",
      "id": "KW-0053",
      "name": "Apoptosis"
    }
  ],
  "last_updated": "2026-09-02",
  "length": 393,
  "lineage": [
    "Eukaryota",
    "Metazoa",
    "Chordata",
    "Mammalia",
    "Primates",
    "Homo"
  ],
  "mass": 43653,
  "ncbi_gene_ids": [
    "7157"
  ],
  "organism": "Homo sapiens",
  "pathway": null,
  "pdb_ids": [
    "1A1U",
    "1AIE"
  ],
  "protein_existence": "1: Evidence at protein level",
  "protein_name": "Cellular tumor antigen p53",
  "refseq_ids": [
    "NP_000537.3"
  ],
  "requested": "P04637",
  "reviewed": true,
  "sequence": "MEEPQSDPSVEPPLSQETFSDLWKLLPENNVLSPLPSQAMDDLMLSPDDIEQWFTEDPGPDEAPRMPEAAPPVA",
  "subcellular_locations": [
    "Cytoplasm",
    "Nucleus",
    "Nucleus, PML body"
  ],
  "subunit": "Forms homodimers and homotetramers.",
  "summary": "TP53 \u00b7 Cellular tumor antigen p53 \u00b7 Homo sapiens \u00b7 393 aa \u00b7 reviewed",
  "taxon_id": 9606,
  "tissue_specificity": "Ubiquitous.",
  "uniparc_id": "UPI000002ED67",
  "url": "https://www.uniprot.org/uniprotkb/P04637/entry",
  "version": 315
}

Get protein sequence (FASTA)

Get a protein's amino-acid sequence in FASTA format, ready to save or send to an alignment tool, with the header and the bare sequence split out. Works for isoforms (P04637-2) too.

Inputs

AccessionaccessiontextRequired
The protein's UniProtKB accession, such as P04637 (P04637-2 for an isoform), or its entry name, such as P53_HUMAN. 'Search proteins' shows it.

Outputs

accessiontext
The accession read.
fastatext
The whole FASTA record.
headertext
The FASTA header line, without '>'.
lengthnumber
The sequence length.
sequencetext
The sequence alone.
urltext
The entry on uniprot.org.
Example output
{
  "accession": "P04637",
  "fasta": ">sp|P04637|P53_HUMAN Cellular tumor antigen p53\nMEEPQSDPSVEPPLSQETFSDLWKLLPENNVLSPLPSQAMDDLMLSPDDIEQWFTEDPGPDEAPRMPEAAPPVA\n",
  "header": "sp|P04637|P53_HUMAN Cellular tumor antigen p53 OS=Homo sapiens OX=9606 GN=TP53 PE=1 SV=4",
  "length": 74,
  "sequence": "MEEPQSDPSVEPPLSQETFSDLWKLLPENNVLSPLPSQAMDDLMLSPDDIEQWFTEDPGPDEAPRMPEAAPPVA",
  "url": "https://www.uniprot.org/uniprotkb/P04637/entry"
}

Get proteome

Get a proteome: its organism, protein and gene counts (reviewed and unreviewed), completeness, genome assembly, and the chromosomes or other components it is made of.

Inputs

Proteome IDproteome_idtextRequired
The proteome, such as UP000005640 (human).

Outputs

annotation_sourcetext
Who annotated the genome.
assembly_idtext
The genome assembly it comes from.
assembly_leveltext
How complete that assembly is.
busco_scorenumber
Its BUSCO completeness, as a percentage.
common_nametext
The organism's common name.
componentslist
Its chromosomes and other parts.
cpd_statustext
Its Complete Proteome Detector verdict.
descriptiontext
About the organism.
gene_countnumber
How many genes they come from.
idtext
The proteome's ID, e.g. 'UP000005640'.
isoform_countnumber
Its isoforms.
lineagelist
The organism's lineage.
modifiedtext
When it last changed.
organismtext
The organism.
protein_countnumber
How many proteins it has.
reviewed_protein_countnumber
Its reviewed proteins.
taxon_idnumber
The organism's taxon ID.
typetext
e.g. 'Reference proteome'.
unreviewed_protein_countnumber
Its unreviewed proteins.
urltext
The proteome on uniprot.org.
Example output
{
  "annotation_source": "Ensembl",
  "assembly_id": "GCA_000001405.29",
  "assembly_level": "full",
  "busco_score": 99.0,
  "common_name": "Human",
  "components": [
    {
      "genome_accession": "CM000663",
      "name": "Chromosome 1",
      "protein_count": 13931
    }
  ],
  "cpd_status": "Unknown",
  "description": "Homo sapiens (Homo sapiens sapiens) or modern humans...",
  "gene_count": 20652,
  "id": "UP000005640",
  "isoform_count": 22131,
  "lineage": [
    "cellular organisms",
    "Eukaryota",
    "Opisthokonta"
  ],
  "modified": "2026-04-22",
  "organism": "Homo sapiens",
  "protein_count": 147520,
  "reviewed_protein_count": 20416,
  "taxon_id": 9606,
  "type": "Reference proteome",
  "unreviewed_protein_count": 127104,
  "url": "https://www.uniprot.org/proteomes/UP000005640"
}

Get taxon

Get a taxon by its ID: scientific and common names, rank, parent, lineage, other names, links and how many proteins and proteomes it has.

Inputs

Taxontaxon_idtextRequired
Pick an organism, or type a taxon ID such as 9606.

Outputs

activetrue/false
False when the taxon was retired.
common_nametext
Its common name.
lineagelist
Its lineage, broadest first.
linkslist
Pages about it elsewhere.
mnemonictext
UniProt's code for it, e.g. 'HUMAN'.
other_nameslist
Other names, including misspellings.
parent_idnumber
Its parent taxon's ID.
parent_nametext
Its parent taxon's name.
proteome_countnumber
Its proteomes.
ranktext
Its rank, e.g. 'species'.
reviewed_protein_countnumber
Its reviewed (Swiss-Prot) proteins.
scientific_nametext
Its scientific name.
synonymslist
Synonyms.
taxon_idnumber
The taxon's ID, e.g. 9606.
unreviewed_protein_countnumber
Its unreviewed (TrEMBL) proteins.
urltext
The taxon on uniprot.org.
Example output
{
  "active": true,
  "common_name": "Human",
  "lineage": [
    "Eukaryota",
    "Metazoa",
    "Chordata",
    "Mammalia",
    "Primates",
    "Homo"
  ],
  "links": [
    "https://en.wikipedia.org/wiki/Human"
  ],
  "mnemonic": "HUMAN",
  "other_names": [
    "Homo sapiens Linnaeus, 1758",
    "human"
  ],
  "parent_id": 9605,
  "parent_name": "Homo",
  "proteome_count": 2,
  "rank": "species",
  "reviewed_protein_count": 20432,
  "scientific_name": "Homo sapiens",
  "synonyms": [],
  "taxon_id": 9606,
  "unreviewed_protein_count": 190356,
  "url": "https://www.uniprot.org/taxonomy/9606"
}

Get UniParc sequence

Get a UniParc sequence with its checksums, InterPro domains and UniProtKB accessions, and a page of the database records that hold it (UniProtKB, RefSeq, Ensembl, EMBL and more).

Inputs

UniParc IDupitextRequired
The sequence's UniParc ID, such as UPI000002ED67.
Current records onlyactive_onlytrue/false
Leave out database records that have since been retired.
Records per pagepage_sizenumber
How many database records to list, 1 to 500. Defaults to 25.From 1 to 500.
Next page cursorcursortext
The 'next_cursor' from the previous page, to get the page after it. Keep the other fields the same.

Outputs

countnumber
Records on this page.
crc64text
Its CRC64 checksum.
cross_reference_countnumber
Database records holding it, in all.
cross_referenceslist
A page of the records holding it.
domainslist
Its InterPro domains.
first_seentext
When a database first held it.
last_seentext
When a database last updated it.
lengthnumber
The sequence length.
md5text
Its MD5 checksum.
next_cursortext
Pass as 'cursor' for the next page; blank on the last.
sequencetext
The sequence.
totalnumber
Records matching (current only, if asked).
uniprot_accessionslist
UniProtKB accessions with this sequence.
upitext
The UniParc ID.
urltext
The entry on uniprot.org.
Example output
{
  "count": 1,
  "crc64": "AD5C149FD8106131",
  "cross_reference_count": 617,
  "cross_references": [
    {
      "active": true,
      "created": "2009-11-24",
      "database": "UniProtKB/Swiss-Prot",
      "gene": "TP53",
      "id": "P04637",
      "last_updated": "2026-09-02",
      "organism": "Homo sapiens",
      "protein_name": "Cellular tumor antigen p53",
      "taxon_id": 9606,
      "version": 4
    }
  ],
  "domains": [
    {
      "id": "IPR011615",
      "name": "p53, DNA-binding domain"
    }
  ],
  "first_seen": "1989-07-01",
  "last_seen": "2026-09-02",
  "length": 393,
  "md5": "C133DFCE69F606F20865E9008199F852",
  "next_cursor": "jjyuoihck",
  "sequence": "MEEPQSDPSVEPPLSQETFSDLWKLLPENNVLSPLPSQAMDDLMLSPDDIEQWFTEDPGPDEAPRMPEAAPPVA",
  "total": 8,
  "uniprot_accessions": [
    "P04637"
  ],
  "upi": "UPI000002ED67",
  "url": "https://www.uniprot.org/uniparc/UPI000002ED67/entry"
}

Get UniRef cluster

Get a UniRef cluster: its size, the organisms it spans, its representative protein and sequence, and a page of its members.

Inputs

Cluster IDcluster_idtextRequired
The UniRef cluster, such as UniRef90_P04637. 'Search UniRef clusters' shows it.
Members per pagepage_sizenumber
How many members to list, 1 to 500. Defaults to 25.From 1 to 500.
Next page cursorcursortext
The 'next_cursor' from the previous page, to get the page after it. Keep the other fields the same.

Outputs

common_taxontext
The narrowest taxon covering every member.
common_taxon_idnumber
That taxon's ID.
idtext
The cluster's ID, e.g. 'UniRef90_P04637'.
identitytext
UniRef100, UniRef90 or UniRef50: how alike its members are.
member_countnumber
How many sequences it holds.
memberslist
A page of the cluster's members.
members_countnumber
Members on this page.
nametext
The cluster's name.
next_cursortext
Pass as 'cursor' for the next page; blank on the last.
organism_countnumber
How many organisms they come from.
representativeobject
The member chosen to represent the cluster.
sequencetext
The representative's sequence.
updatedtext
When the cluster last changed.
urltext
The cluster on uniprot.org.
Example output
{
  "common_taxon": "Euarchontoglires",
  "common_taxon_id": 314146,
  "id": "UniRef90_P04637",
  "identity": "UniRef90",
  "member_count": 104,
  "members": [
    {
      "accessions": [
        "P04637"
      ],
      "id": "P53_HUMAN",
      "length": 393,
      "organism": "Homo sapiens (Human)",
      "protein_name": "Cellular tumor antigen p53",
      "taxon_id": 9606,
      "type": "UniProtKB ID",
      "uniparc_id": "UPI000002ED67"
    }
  ],
  "members_count": 1,
  "name": "Cellular tumor antigen p53",
  "next_cursor": "jjyuoihck",
  "organism_count": 28,
  "representative": {
    "accessions": [
      "P04637"
    ],
    "id": "P53_HUMAN",
    "length": 393,
    "organism": "Homo sapiens (Human)",
    "protein_name": "Cellular tumor antigen p53",
    "taxon_id": 9606,
    "type": "UniProtKB ID",
    "uniparc_id": "UPI000002ED67"
  },
  "sequence": "MEEPQSDPSVEPPLSQETFSDLWKLLPENNVLSPLPSQAMDDLMLSPDDIEQWFTEDPGPDEAPRMPEAAPPVA",
  "updated": "2026-09-02",
  "url": "https://www.uniprot.org/uniref/UniRef90_P04637"
}

List protein features

List the features marked along a protein's sequence, with their positions: domains, regions, binding and active sites, modifications, signal peptides, transmembrane parts and, when asked, natural variants and mutagenesis results.

Inputs

AccessionaccessiontextRequired
The protein's UniProtKB accession, such as P04637 (P04637-2 for an isoform), or its entry name, such as P53_HUMAN. 'Search proteins' shows it.
Kinds of featuretypeslist
Only these kinds. Leave empty for the protein's parts and sites: everything but variants, mutagenesis, alternative sequences, conflicts and secondary structure.One or more of: Chain, Signal (Signal peptide), Transit peptide, Propeptide, Peptide, Initiator methionine, Domain, Region, Repeat, Motif, and 22 more.

Outputs

accessiontext
The accession read.
by_typelist
How many of each kind.
countnumber
How many features there are.
featureslist
The features, in sequence order by kind.
typeslist
The kinds of feature asked for.
Example output
{
  "accession": "P04637",
  "by_type": [
    {
      "count": 1,
      "type": "DNA binding"
    }
  ],
  "count": 1,
  "features": [
    {
      "description": null,
      "end": 292,
      "evidence_count": 3,
      "feature_id": null,
      "ligand": null,
      "original": null,
      "start": 102,
      "type": "DNA binding",
      "variation": []
    }
  ],
  "types": [
    "DNA binding",
    "Modified residue"
  ]
}

Search diseases

Search the human diseases UniProt links to proteins, with each one's definition, other names and OMIM and MeSH references.

Inputs

SearchquerytextRequired
A disease's name, acronym or words, such as cystic fibrosis.
Page sizepage_sizenumber
How many to return, 1 to 500. Defaults to 25.From 1 to 500.
Next page cursorcursortext
The 'next_cursor' from the previous page, to get the page after it. Keep the other fields the same.

Outputs

countnumber
Results on this page.
diseaseslist
The diseases on this page.
next_cursortext
Pass as 'cursor' for the next page; blank on the last.
querytext
The query sent to UniProt.
totalnumber
Results matching in all.
Example output
{
  "count": 1,
  "diseases": [
    {
      "acronym": "LFS",
      "alternative_names": [
        "LFL",
        "Sarcoma family syndrome of Li and Fraumeni"
      ],
      "cross_references": [
        {
          "database": "MIM",
          "id": "151623"
        }
      ],
      "definition": "An autosomal dominant familial cancer syndrome.",
      "id": "DI-01904",
      "keywords": [
        "Li-Fraumeni syndrome"
      ],
      "name": "Li-Fraumeni syndrome",
      "reviewed_protein_count": 2,
      "url": "https://www.uniprot.org/diseases/DI-01904"
    }
  ],
  "next_cursor": "",
  "query": "Li-Fraumeni",
  "total": 1
}

Search keywords

Search UniProt's keywords, the controlled terms that tag entries by function, location, disease and more, with each one's definition and protein counts.

Inputs

SearchquerytextRequired
Words to look for in keywords, such as kinase.
Categorycategorytext
Only keywords in this category. Leave blank for all.One of: biological_process (Biological process), cellular_component (Cellular component), coding_sequence_diversity (Coding sequence diversity), developmental_stage (Developmental stage), disease, domain, ligand, molecular_function (Molecular function), ptm (Post-translational modification), technical_term (Technical term).
Page sizepage_sizenumber
How many to return, 1 to 500. Defaults to 25.From 1 to 500.
Next page cursorcursortext
The 'next_cursor' from the previous page, to get the page after it. Keep the other fields the same.

Outputs

countnumber
Results on this page.
keywordslist
The keywords on this page.
next_cursortext
Pass as 'cursor' for the next page; blank on the last.
querytext
The query sent to UniProt.
totalnumber
Results matching in all.
Example output
{
  "count": 1,
  "keywords": [
    {
      "category": "Biological process",
      "definition": "Protein involved in apoptotic programmed cell death.",
      "go_terms": [
        {
          "id": "GO:0006915",
          "name": "apoptotic process"
        }
      ],
      "id": "KW-0053",
      "name": "Apoptosis",
      "reviewed_protein_count": 2976,
      "synonyms": [
        "Type I programmed cell death"
      ],
      "unreviewed_protein_count": 273917,
      "url": "https://www.uniprot.org/keywords/KW-0053"
    }
  ],
  "next_cursor": "",
  "query": "(apoptosis) AND category:biological_process",
  "total": 1
}

Search literature

Search the papers UniProt cites by title words, author or journal, with how many protein entries cite each one and a link to it on PubMed.

Inputs

SearchquerytextRequired
Words in the title or abstract, or fields such as author:Vogelstein or journal:Nature.
Page sizepage_sizenumber
How many to return, 1 to 500. Defaults to 25.From 1 to 500.
Next page cursorcursortext
The 'next_cursor' from the previous page, to get the page after it. Keep the other fields the same.

Outputs

citationslist
The papers on this page.
countnumber
Results on this page.
next_cursortext
Pass as 'cursor' for the next page; blank on the last.
querytext
The query sent to UniProt.
totalnumber
Results matching in all.
Example output
{
  "citations": [
    {
      "authors": [
        "Ohnishi K.",
        "Inaba H."
      ],
      "doi": "10.1023/b:appt.0000038044.40337.35",
      "id": "15314287",
      "journal": "Apoptosis",
      "pages": "591-597",
      "published": "2004",
      "pubmed_id": "15314287",
      "reviewed_protein_count": 0,
      "title": "C-terminal peptides of p53 molecules enhance radiation-induced apoptosis in human mutant p53 cancer cells.",
      "type": "UniProt indexed literatures",
      "unreviewed_protein_count": 0,
      "url": "https://pubmed.ncbi.nlm.nih.gov/15314287/",
      "volume": "9"
    }
  ],
  "count": 1,
  "next_cursor": "",
  "query": "p53 apoptosis",
  "total": 1
}

Search proteins

Search UniProtKB's protein entries by words, gene, function or UniProt's query syntax, optionally only reviewed (Swiss-Prot) entries from one organism. Returns one page with each protein's name, gene, organism and length; to see more, run it again with the next page it gives.

Inputs

Searchquerytext
Words to search for, or UniProt's query syntax such as gene:TP53 or keyword:Apoptosis. Can be left empty when an organism is picked.
Reviewed (Swiss-Prot) onlyreviewed_onlytrue/false
Only entries curators have reviewed, leaving out the far larger unreviewed (TrEMBL) set.
Organismorganismtext
Only proteins from this organism. Pick one, or type a taxon ID or name.
Ordersorttext
How to order the results. Defaults to best match first.One of: score (Best match first), annotation_score desc (Best annotated first), accession asc (Accession, A to Z), protein_name asc (Protein name, A to Z), gene asc (Gene name, A to Z), organism_name asc (Organism, A to Z), length desc (Longest first), length asc (Shortest first).
Page sizepage_sizenumber
How many to return, 1 to 500. Defaults to 25.From 1 to 500.
Next page cursorcursortext
The 'next_cursor' from the previous page, to get the page after it. Keep the other fields the same.

Outputs

countnumber
Results on this page.
next_cursortext
Pass as 'cursor' for the next page; blank on the last.
proteinslist
The proteins on this page.
querytext
The query sent to UniProt.
totalnumber
Results matching in all.
Example output
{
  "count": 1,
  "next_cursor": "",
  "proteins": [
    {
      "accession": "P04637",
      "annotation_score": 5.0,
      "entry_name": "P53_HUMAN",
      "gene": "TP53",
      "length": 393,
      "organism": "Homo sapiens",
      "protein_existence": "1: Evidence at protein level",
      "protein_name": "Cellular tumor antigen p53",
      "reviewed": true,
      "summary": "TP53 \u00b7 Cellular tumor antigen p53 \u00b7 Homo sapiens \u00b7 393 aa \u00b7 reviewed",
      "taxon_id": 9606,
      "url": "https://www.uniprot.org/uniprotkb/P04637/entry"
    }
  ],
  "query": "(gene:TP53) AND reviewed:true AND organism_id:9606",
  "total": 1
}

Search proteomes

Search the proteomes (the full protein sets of sequenced organisms) by organism, with each one's size, BUSCO completeness and genome assembly.

Inputs

SearchquerytextRequired
An organism's name, or words such as Escherichia coli K-12.
Typeproteome_typetext
Only this kind of proteome. Reference proteomes are the best-annotated ones. Leave blank for all.One of: REFERENCE (Reference proteomes), NON_REFERENCE (Other proteomes), EXCLUDED (Excluded proteomes).
Page sizepage_sizenumber
How many to return, 1 to 500. Defaults to 25.From 1 to 500.
Next page cursorcursortext
The 'next_cursor' from the previous page, to get the page after it. Keep the other fields the same.

Outputs

countnumber
Results on this page.
next_cursortext
Pass as 'cursor' for the next page; blank on the last.
proteomeslist
The proteomes on this page.
querytext
The query sent to UniProt.
totalnumber
Results matching in all.
Example output
{
  "count": 1,
  "next_cursor": "",
  "proteomes": [
    {
      "annotation_source": "Ensembl",
      "assembly_id": "GCA_000001405.29",
      "assembly_level": "full",
      "busco_score": 99.0,
      "common_name": "Human",
      "cpd_status": "Unknown",
      "gene_count": 20652,
      "id": "UP000005640",
      "modified": "2026-04-22",
      "organism": "Homo sapiens",
      "protein_count": 147520,
      "taxon_id": 9606,
      "type": "Reference proteome",
      "url": "https://www.uniprot.org/proteomes/UP000005640"
    }
  ],
  "query": "(Homo sapiens) AND proteome_type:REFERENCE",
  "total": 1
}

Search taxonomy

Search UniProt's taxonomy for organisms and groups by name, optionally of one rank, with each one's taxon ID, lineage and protein counts.

Inputs

SearchquerytextRequired
A scientific or common name, such as Drosophila or zebrafish.
Rankranktext
Only taxa of this rank. Leave blank for any rank.One of: SPECIES, SUBSPECIES, STRAIN, GENUS, FAMILY, ORDER, CLASS, PHYLUM, KINGDOM, DOMAIN.
Page sizepage_sizenumber
How many to return, 1 to 500. Defaults to 25.From 1 to 500.
Next page cursorcursortext
The 'next_cursor' from the previous page, to get the page after it. Keep the other fields the same.

Outputs

countnumber
Results on this page.
next_cursortext
Pass as 'cursor' for the next page; blank on the last.
querytext
The query sent to UniProt.
taxalist
The taxa on this page.
totalnumber
Results matching in all.
Example output
{
  "count": 1,
  "next_cursor": "",
  "query": "(homo) AND rank:SPECIES",
  "taxa": [
    {
      "common_name": "Human",
      "lineage": [
        "Eukaryota",
        "Metazoa",
        "Chordata",
        "Mammalia",
        "Primates",
        "Homo"
      ],
      "mnemonic": "HUMAN",
      "parent_id": 9605,
      "parent_name": "Homo",
      "proteome_count": 2,
      "rank": "species",
      "reviewed_protein_count": 20432,
      "scientific_name": "Homo sapiens",
      "taxon_id": 9606,
      "unreviewed_protein_count": 190356,
      "url": "https://www.uniprot.org/taxonomy/9606"
    }
  ],
  "total": 1
}

Search UniParc sequences

Search UniParc, the archive of every distinct protein sequence in the public databases, by accession, database ID, checksum, gene or organism.

Inputs

SearchquerytextRequired
An accession, a database ID, a checksum, or UniProt's query syntax such as gene:TP53 AND organism_id:9606.
Page sizepage_sizenumber
How many to return, 1 to 500. Defaults to 25.From 1 to 500.
Next page cursorcursortext
The 'next_cursor' from the previous page, to get the page after it. Keep the other fields the same.

Outputs

countnumber
Results on this page.
entrieslist
The sequences on this page.
next_cursortext
Pass as 'cursor' for the next page; blank on the last.
querytext
The query sent to UniProt.
totalnumber
Results matching in all.
Example output
{
  "count": 1,
  "entries": [
    {
      "crc64": "AD5C149FD8106131",
      "first_seen": "1989-07-01",
      "last_seen": "2026-09-02",
      "length": 393,
      "organisms": [
        "Homo sapiens",
        "Pan troglodytes"
      ],
      "uniprot_accessions": [
        "P04637",
        "K7PPA8"
      ],
      "upi": "UPI000002ED67",
      "url": "https://www.uniprot.org/uniparc/UPI000002ED67/entry"
    }
  ],
  "next_cursor": "",
  "query": "P04637",
  "total": 1
}

Search UniRef clusters

Search UniRef, which groups similar sequences into clusters at 100%, 90% and 50% identity, for example to find a protein's close relatives. Each cluster comes with its size and representative protein.

Inputs

SearchquerytextRequired
Words, a protein name or an accession whose clusters to find, such as P04637.
Identityidentitytext
Only clusters at this level of sequence identity. Leave blank for all three.One of: 1.0 (100% identical (UniRef100)), 0.9 (90% identical (UniRef90)), 0.5 (50% identical (UniRef50)).
Page sizepage_sizenumber
How many to return, 1 to 500. Defaults to 25.From 1 to 500.
Next page cursorcursortext
The 'next_cursor' from the previous page, to get the page after it. Keep the other fields the same.

Outputs

clusterslist
The clusters on this page.
countnumber
Results on this page.
next_cursortext
Pass as 'cursor' for the next page; blank on the last.
querytext
The query sent to UniProt.
totalnumber
Results matching in all.
Example output
{
  "clusters": [
    {
      "common_taxon": "Euarchontoglires",
      "common_taxon_id": 314146,
      "id": "UniRef90_P04637",
      "identity": "UniRef90",
      "member_count": 104,
      "name": "Cellular tumor antigen p53",
      "organism_count": 28,
      "representative": {
        "accessions": [
          "P04637"
        ],
        "id": "P53_HUMAN",
        "length": 393,
        "organism": "Homo sapiens (Human)",
        "protein_name": "Cellular tumor antigen p53",
        "taxon_id": 9606,
        "type": "UniProtKB ID",
        "uniparc_id": "UPI000002ED67"
      },
      "updated": "2026-09-02",
      "url": "https://www.uniprot.org/uniref/UniRef90_P04637"
    }
  ],
  "count": 1,
  "next_cursor": "",
  "query": "(P04637) AND identity:0.9",
  "total": 1
}

Submit ID mapping

Start a job that maps IDs from one database to another, such as UniProt accessions to Ensembl genes or gene names to UniProt entries. Returns a job ID for 'Get ID mapping status' and 'Get ID mapping results'.

Inputs

Fromfrom_dbtextRequired
The database the IDs are from, such as UniProtKB AC/ID or Gene Name.
Toto_dbtextRequired
The database to map them to. Only those the chosen source can map to are listed.
IDsidslistRequired
The IDs to map, up to 100,000.
Organismtaxon_idtext
Only for mapping gene names: the organism they belong to. Pick one, or type a taxon ID.

Outputs

from_dbtext
The source database.
id_countnumber
How many IDs were sent.
job_idtext
The mapping job's ID.
summarytext
The job in one line.
to_dbtext
The target database.
Example output
{
  "from_db": "UniProtKB_AC-ID",
  "id_count": 2,
  "job_id": "AoofAwrYHV",
  "summary": "Mapping 2 IDs from UniProtKB_AC-ID to Ensembl: job AoofAwrYHV",
  "to_db": "Ensembl"
}

On this page