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
| Action | What it does |
|---|---|
| Get disease | Get a disease by its UniProt ID: definition, acronym, other names, keywords and cross-references. |
| 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. |
| 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. |
| Get keyword | Get a keyword: its definition, category, synonyms, matching GO terms, the keywords above and below it, and protein counts. |
| 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. |
| 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 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. |
| 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. |
| 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). |
| Get UniRef cluster | Get a UniRef cluster: its size, the organisms it spans, its representative protein and sequence, and a page of its members. |
| 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. |
| Search diseases | Search the human diseases UniProt links to proteins, with each one's definition, other names and OMIM and MeSH references. |
| 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. |
| 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. |
| 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. |
| Search proteomes | Search the proteomes (the full protein sets of sequenced organisms) by organism, with each one's size, BUSCO completeness and genome assembly. |
| 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. |
| Search UniParc sequences | Search UniParc, the archive of every distinct protein sequence in the public databases, by accession, database ID, checksum, gene or organism. |
| 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. |
| 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. |
Get disease
Get a disease by its UniProt ID: definition, acronym, other names, keywords and cross-references.
Inputs
- Disease ID
disease_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 ID
job_idtextRequired - The mapping job's ID, from 'Submit ID mapping'.
- Page size
page_sizenumber - How many to return, 1 to 500. Defaults to 25.From 1 to 500.
- Next page cursor
cursortext - 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 ID
job_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 ID
keyword_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
- Accession
accessiontextRequired - 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
- Accession
accessiontextRequired - 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 ID
proteome_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
- Taxon
taxon_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 ID
upitextRequired - The sequence's UniParc ID, such as UPI000002ED67.
- Current records only
active_onlytrue/false - Leave out database records that have since been retired.
- Records per page
page_sizenumber - How many database records to list, 1 to 500. Defaults to 25.From 1 to 500.
- Next page cursor
cursortext - 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 ID
cluster_idtextRequired - The UniRef cluster, such as UniRef90_P04637. 'Search UniRef clusters' shows it.
- Members per page
page_sizenumber - How many members to list, 1 to 500. Defaults to 25.From 1 to 500.
- Next page cursor
cursortext - 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
- Accession
accessiontextRequired - 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 feature
typeslist - 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
- Search
querytextRequired - A disease's name, acronym or words, such as cystic fibrosis.
- Page size
page_sizenumber - How many to return, 1 to 500. Defaults to 25.From 1 to 500.
- Next page cursor
cursortext - 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
- Search
querytextRequired - Words to look for in keywords, such as kinase.
- Category
categorytext - 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 size
page_sizenumber - How many to return, 1 to 500. Defaults to 25.From 1 to 500.
- Next page cursor
cursortext - 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
- Search
querytextRequired - Words in the title or abstract, or fields such as author:Vogelstein or journal:Nature.
- Page size
page_sizenumber - How many to return, 1 to 500. Defaults to 25.From 1 to 500.
- Next page cursor
cursortext - 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
- Search
querytext - 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) only
reviewed_onlytrue/false - Only entries curators have reviewed, leaving out the far larger unreviewed (TrEMBL) set.
- Organism
organismtext - Only proteins from this organism. Pick one, or type a taxon ID or name.
- Order
sorttext - 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 size
page_sizenumber - How many to return, 1 to 500. Defaults to 25.From 1 to 500.
- Next page cursor
cursortext - 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
- Search
querytextRequired - An organism's name, or words such as Escherichia coli K-12.
- Type
proteome_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 size
page_sizenumber - How many to return, 1 to 500. Defaults to 25.From 1 to 500.
- Next page cursor
cursortext - 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
- Search
querytextRequired - A scientific or common name, such as Drosophila or zebrafish.
- Rank
ranktext - Only taxa of this rank. Leave blank for any rank.One of:
SPECIES,SUBSPECIES,STRAIN,GENUS,FAMILY,ORDER,CLASS,PHYLUM,KINGDOM,DOMAIN. - Page size
page_sizenumber - How many to return, 1 to 500. Defaults to 25.From 1 to 500.
- Next page cursor
cursortext - 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
- Search
querytextRequired - An accession, a database ID, a checksum, or UniProt's query syntax such as gene:TP53 AND organism_id:9606.
- Page size
page_sizenumber - How many to return, 1 to 500. Defaults to 25.From 1 to 500.
- Next page cursor
cursortext - 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
- Search
querytextRequired - Words, a protein name or an accession whose clusters to find, such as P04637.
- Identity
identitytext - 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 size
page_sizenumber - How many to return, 1 to 500. Defaults to 25.From 1 to 500.
- Next page cursor
cursortext - 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
- From
from_dbtextRequired - The database the IDs are from, such as UniProtKB AC/ID or Gene Name.
- To
to_dbtextRequired - The database to map them to. Only those the chosen source can map to are listed.
- IDs
idslistRequired - The IDs to map, up to 100,000.
- Organism
taxon_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"
}