Search UniProtKB and return matching protein entries.

Use this to find proteins by gene, name, organism, keyword, length, etc. Returns a compact summary (accession, entry name, protein name, gene, organism, length, Swiss-Prot/TrEMBL) by default. Pass reviewed=True to restrict to curated Swiss-Prot entries, and organism_id to filter by species. The total match count is always reported so you can page or narrow.

Fetch one UniProtKB entry.

'summary' returns a clean digest: protein/gene names, organism, length, function, subcellular location, family/domains, key features, PTMs, keywords, and top cross-references (PDB, AlphaFold, Ensembl, RefSeq, InterPro, GO). Use 'json' for the complete record, 'fasta' for the sequence, 'txt' for the flat file, or 'gff' for feature coordinates.

Return raw FASTA sequence(s) for one or more UniProtKB accessions.

A single accession uses the entry endpoint; a list uses the batch /accessions endpoint. Well-formed but unknown/obsolete accessions are dropped silently (a note reports the count discrepancy), but a malformed-format accession makes UniProt reject the whole request — so pass syntactically valid accessions.

Map identifiers between databases via UniProt's async ID-mapping service.

Submits a job, polls until it finishes, then returns the mapped pairs plus any unmapped input ids. When to_db is 'UniProtKB'/'UniProtKB-Swiss-Prot' each result is enriched with the protein name, entry name, and organism. Use 'UniProtKB_AC-ID' as from_db when starting from UniProt accessions. Validates the database pair against the live UniProt config and, on an invalid value, returns the allowed databases.

Resolve a taxonomy name or id.

Pass a numeric taxon id to fetch that record, or a name to search. Returns the taxon id, scientific/common names, rank, and lineage — letting you turn an organism name into the organism_id used by search_uniprotkb.

Search UniRef clusters (sequence-similarity clusters of UniProt proteins).

UniRef100/90/50 group sequences at 100/90/50% identity. Returns cluster id, name, member/organism counts, and the representative member. Use identity to restrict to one clustering level.

Search UniProt proteomes (the protein set of an organism's genome).

Returns the proteome id (UPID), organism, proteome type (Reference / Non-reference / etc.), and protein/gene counts. Filter by organism_id and set reference_only=True for reference proteomes.