Find Proteins
find_proteinsSearch UniProtKB by gene, organism, keyword, EC number, or name to find matching protein entries with accession, mnemonic, and review status.
Instructions
Search UniProtKB by structured filters and return matching entries (accession, mnemonic, recommended name, reviewed flag, organism). Requires at least one anchor: gene symbol, mnemonic, EC number, keyword (KW-id or label), OR organism_taxon together with name_contains (matched per word, in any order, case-insensitive). Reviewed (Swiss-Prot) hits are ranked first. UniProt SPARQL has no general full-text index, so for broad text use search_example_queries or run_sparql_query. Pair with get_protein for full detail. Results are ordered reviewed-first, then by mnemonic, then accession (stable across pages). Cold search can take several seconds; an identical repeat is cached (~0 ms). If you already know the accession, call get_protein directly -- it is far faster than a cold search. Signature: find_proteins(gene=, organism_taxon=, reviewed=, keyword=, ec_number=, mnemonic=, name_contains=, limit=, offset=).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gene | No | Gene symbol, e.g. BRCA1. | |
| organism_taxon | No | NCBI taxon id, e.g. 9606 for human. | |
| reviewed | No | True = Swiss-Prot only; False = TrEMBL only. | |
| keyword | No | UniProt keyword (KW-id like KW-0007, or a label). | |
| ec_number | No | EC number, e.g. 2.7.11.1. | |
| mnemonic | No | Entry mnemonic, e.g. BRCA1_HUMAN. | |
| name_contains | No | Words to match in the recommended protein name. Multi-word input matches per word (each word must appear, in any order), so 'polynucleotide kinase' matches 'Bifunctional polynucleotide phosphatase/kinase'. Case-insensitive. | |
| limit | No | Max results per page. | |
| offset | No | Pagination offset. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| success | No | ||
| _meta | No | ||
| error_code | No | ||
| message | No | ||
| retryable | No | ||
| recovery_action | No | ||
| field | No | ||
| allowed_values | No | ||
| hint | No | ||
| count | No | ||
| proteins | No | ||
| truncated | No | ||
| reviewed_count | No | ||
| reviewed_hint | No |