Proto is not affiliated with EMBL-EBI. This toolkit is open source and builds on the implementation produced by this organization. Product names, logos, and trademarks are the property of their respective owners.

```bibtex theme={null} @article{blum2025interpro, title={{InterPro}: the protein sequence classification resource in 2025}, author={Blum, Matthias and Andreeva, Antonina and Florentino, Laise Cavalcanti and Chuguransky, Sara Rocio and Grego, Tiago and Hobbs, Emma and Pinto, Beatriz Lazaro and Orr, Ailsa and Paysan-Lafosse, Typhaine and Ponamareva, Irina and Salazar, Gustavo A. and Bordin, Nicola and Bork, Peer and Bridge, Alan and Colwell, Lucy and Gough, Julian and Haft, Daniel H. and Letunic, Ivica and Llinares-L{\'o}pez, Felipe and Marchler-Bauer, Aron and Meng-Papaxanthos, Laetitia and Mi, Huaiyu and Natale, Darren A. and Orengo, Christine A. and Pandurangan, Arun P. and Piovesan, Damiano and Rivoire, Catherine and Sigrist, Christian J. A. and Thanki, Narmada and Thibaud-Nissen, Fran{\c{c}}oise and Thomas, Paul D. and Tosatto, Silvio C. E. and Wu, Cathy H. and Bateman, Alex}, journal={Nucleic Acids Research}, volume={53}, number={D1}, pages={D444--D456}, year={2025}, publisher={Oxford University Press}, doi={10.1093/nar/gkae1082} } ```

Copy citation

### InterProScan Fetch (`interproscan-fetch`) Retrieves InterPro domain annotations for a protein, either by direct REST lookup of a UniProt accession or by submitting a raw sequence to the iprscan5 service, and returns the resolved accession, sequence length, the list of member-database hits, the source URL, the iprscan5 job ID on the sequence path, and the raw API entries. #### API Reference

Source UniProt accession for direct entry lookup against `interpro/api/entry/all/protein/uniprot/{acc}/`. Raw protein sequence for the iprscan5 submit-and-scan path. Requires `config.email`.

Source Required by EBI's iprscan5 endpoint when submitting a sequence; ignored on the direct UniProt-lookup path. Defaults to the `INTERPROSCAN_EMAIL` environment variable; an explicit value passed to the config overrides the env var. Submit-only — restrict iprscan5 to a subset of member databases. `None` runs the EBI default set (every application enabled, matching upstream `appl[]` defaults). Include GO term cross-references in the output. Maps to iprscan5's `goterms` form param on the submit path; filters parser output on the direct path. Fetch Reactome/KEGG/MetaCyc pathway cross-references after an iprscan5 sequence submission. Has no effect on the UniProt-id path — InterPro's UniProt-keyed endpoint does not return pathway data, so this stays empty on that path regardless of the flag. Submit-only — `nucleic` tells iprscan5 to 6-frame translate the input. Available options: `protein`, `nucleic` Verbosity level (0=quiet, 1=info, 2=debug, 3=raw subprocess stderr). `True` is coerced to `1` and `False` to `0`. Device to run the tool on. Maximum execution time in seconds. `None` waits indefinitely. Random seed. When set, tools run reproducibly up to small GPU float noise (see `BaseToolOutput.approx_equal`), and the seed participates in cache keys. When None, cacheable seed-sensitive tools skip cache until seeded.

Source Resolved UniProt accession; `None` when the sequence path returns a result without a UniProt cross-reference. Length of the queried protein. All hits across all member databases, in the order returned by the API. Member-DB accession (e.g. `"PF00870"`, `"IPR011615"`, `"G3DSA:1.10.10.10"`). Human-readable domain / family name. Category — `family`, `domain`, `repeat`, `active_site`, `conserved_site`, `homologous_superfamily`, `binding_site`, `ptm`, or `unknown`. Source database (`"pfam"`, `"panther"`, `"cathgene3d"`, …). Parent InterPro accession; `None` when the member-DB hit is not yet integrated. 1-indexed inclusive start residue. 1-indexed inclusive end residue. Per-DB score — e-value or bit-score depending on the member database. `None` when not reported. Underlying HMM / profile / model identifier. Whether this is InterPro's representative match for the protein (one per parent IPR entry). GO term IDs cross-referenced from this entry. Pathway IDs (Reactome, MetaCyc, …) cross-referenced from this entry. `len(domains)`. iprscan5 job ID for the submit path; empty string for the direct-lookup path. Canonical InterPro entry URL for the resolved accession (or the iprscan5 result URL on the sequence path). Raw API JSON entries — one per InterPro entry on the direct path, one per match on the sequence path — for advanced consumers.

#### Applications Use this to attach domain, family, and site annotation to a protein before design or filtering: identify the residues of an `active_site` or `conserved_site` match to lock before a redesign loop, partition a sequence into typed family and domain regions, or collect GO and pathway cross-references for functional grouping. The resolved accession and the parent InterPro identifiers compose with the [UniProt](https://bio-pro.mintlify.app/tools/database-retrieval/uniprot) and [AlphaFold DB](https://bio-pro.mintlify.app/tools/database-retrieval/alphafold-db) tools for accession resolution and structural context. #### Usage Tips * **The sequence-submission path requires a contact email.** When `sequence` is provided, `config.email` must be set. Provide it either via the `email` config attribute or via the `INTERPROSCAN_EMAIL` environment variable; an explicit config value overrides the env var. The tool raises a clear `ValueError` before contacting the server if neither is set. The direct accession path ignores `email`. * **Provide exactly one of `uniprot_id` or `sequence`.** The input validator rejects a call that supplies both or neither. * **`score` units are not uniform across rows.** The field carries whichever value the source member database publishes, an e-value for some databases and a bit-score for others, so filter by `member_database` before comparing scores. * **The direct path returns no pathway cross-references.** InterPro's UniProt-keyed endpoint does not surface pathway data, so `pathways` stays empty on that path regardless of configuration. Pathways are only populated on the sequence-submission path. * **A direct lookup raises when the accession is not indexed.** Very recent or removed UniProt accessions outside InterPro's coverage return no entries, surfacing as a `ValueError` rather than an empty result.