> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Look Up Protein

Look up one protein by UniProt accession, entry name, gene symbol, or exact protein name. The response gives its curated subcellular location, function, and GO cellular-component terms from UniProtKB/Swiss-Prot, the reviewed section of UniProtKB, along with its disease, PTM, subunit, tissue specificity and domain statements, sequence features, and interactions. Each statement carries its evidence kind and, where UniProt cites one, a `pmid:` paper id in the form [`GET /search/research/papers/{id}`](https://docs.firecrawl.dev/api-reference/endpoint/research-paper) accepts. A GO term's `paperIds` can be empty, and only GO terms of human entries have paper ids.

`match` says how the lookup resolved:

* `found`: one entry matched, and `protein` holds its annotation.
* `ambiguous`: the identifier names more than one entry, or matched only outside the requested organism. `candidates` lists up to 10 entries. Call again with one candidate's `accession`.
* `not_found`: no entry matches. This is a `200`, not a `404`.

Protein data from UniProtKB/Swiss-Prot. Copyright [UniProt Consortium](https://www.uniprot.org). Licensed under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). No warranty, see the [UniProt license](https://www.uniprot.org/help/license). Selected fields, reformatted. Every `200` response repeats this in `notice` and names the UniProt release in `release`.

For the resolution rules and the evidence kinds, see the [Research Index guide](https://docs.firecrawl.dev/features/research.md#look-up-a-protein).


## OpenAPI

````yaml api-reference/v2-openapi.json GET /search/research/proteins
openapi: 3.0.0
info:
  title: Firecrawl API
  version: v2
  description: >-
    API for interacting with Firecrawl services to perform web scraping and
    crawling tasks.
  contact:
    name: Firecrawl Support
    url: https://firecrawl.dev/support
    email: support@firecrawl.dev
servers:
  - url: https://api.firecrawl.dev/v2
security:
  - bearerAuth: []
paths:
  /search/research/proteins:
    get:
      tags:
        - Research
      summary: Look up a protein
      operationId: researchLookupProtein
      parameters:
        - name: protein
          in: query
          required: true
          description: >-
            One protein identifier, 1 to 200 characters after trimming: a
            UniProt accession (`Q6P087`, or `Q6P087-2` for an isoform), an entry
            name (`RUSD3_HUMAN`), a gene symbol (`RPUSD3`), or an exact protein
            name (`Mitochondrial mRNA pseudouridine synthase RPUSD3`).
          schema:
            type: string
            maxLength: 200
            minLength: 1
        - name: organism
          in: query
          required: false
          description: >-
            Organism that scopes a gene symbol or protein name: an NCBI taxon id
            (`9606`), a scientific name (`Homo sapiens`), or a UniProt common
            name (`Human`), matched without regard to case. Accessions and entry
            names ignore it.
          schema:
            type: string
            minLength: 1
            default: '9606'
      responses:
        '200':
          description: >-
            Lookup result. `match` is `found`, `ambiguous`, or `not_found`. A
            protein that matches no entry is a `200` with `match: "not_found"`,
            not a `404`.
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/ResearchProteinFoundResponse'
                  - $ref: '#/components/schemas/ResearchProteinAmbiguousResponse'
                  - $ref: '#/components/schemas/ResearchProteinNotFoundResponse'
                discriminator:
                  propertyName: match
                  mapping:
                    found: '#/components/schemas/ResearchProteinFoundResponse'
                    ambiguous: '#/components/schemas/ResearchProteinAmbiguousResponse'
                    not_found: '#/components/schemas/ResearchProteinNotFoundResponse'
              examples:
                found:
                  summary: One entry matched
                  value:
                    success: true
                    release: 2026_04
                    match: found
                    protein:
                      accession: Q6P087
                      entryName: RUSD3_HUMAN
                      gene: RPUSD3
                      synonyms: []
                      name: Mitochondrial mRNA pseudouridine synthase RPUSD3
                      organism:
                        taxonId: 9606
                        scientificName: Homo sapiens
                        commonName: Human
                      matchedBy: gene
                      url: https://www.uniprot.org/uniprotkb/Q6P087/entry
                      subcellularLocation:
                        - text: Mitochondrion matrix
                          note: false
                          evidence:
                            - kind: experimental
                              eco: ECO:0000269
                              paperId: pmid:27974379
                        - text: >-
                            Localizes to mitochondrial RNA granules, platforms
                            for post-transcriptional RNA modification and
                            ribosome assembly
                          note: true
                          evidence:
                            - kind: experimental
                              eco: ECO:0000269
                              paperId: pmid:27974379
                            - kind: experimental
                              eco: ECO:0000269
                              paperId: pmid:28082677
                      function:
                        - text: >-
                            Catalyzes uridine to pseudouridine isomerization
                            (pseudouridylation) of specific mitochondrial mRNAs
                            (mt-mRNAs), a post-transcriptional modification
                            necessary for their translation. Acts at position
                            390 in COXI mt-mRNA and at position 697-699 in
                            mitochondrial COXIII mt-mRNA (PubMed:27974379). As a
                            component of a functional protein-RNA module,
                            consisting of RCC1L, NGRN, RPUSD3, RPUSD4, TRUB2,
                            FASTKD2 and 16S mitochondrial ribosomal RNA (16S
                            mt-rRNA), controls 16S mt-rRNA abundance and may
                            play a role in mitochondrial ribosome biogenesis
                            (PubMed:27667664)
                          note: false
                          evidence:
                            - kind: experimental
                              eco: ECO:0000269
                              paperId: pmid:27667664
                            - kind: experimental
                              eco: ECO:0000269
                              paperId: pmid:27974379
                      goCellularComponent:
                        - id: GO:0005759
                          term: mitochondrial matrix
                          code: IDA
                          assignedBy: FlyBase
                          paperIds:
                            - pmid:27974379
                        - id: GO:0005739
                          term: mitochondrion
                          code: IDA
                          assignedBy: FlyBase
                          paperIds:
                            - pmid:28082677
                        - id: GO:0035770
                          term: ribonucleoprotein granule
                          code: IDA
                          assignedBy: FlyBase
                          paperIds:
                            - pmid:28082677
                      paperIds:
                        - pmid:27974379
                        - pmid:28082677
                        - pmid:27667664
                    notice: >-
                      Protein data from UniProtKB/Swiss-Prot release 2026_04.
                      Copyright UniProt Consortium, https://www.uniprot.org. CC
                      BY 4.0, https://creativecommons.org/licenses/by/4.0/. No
                      warranty, see https://www.uniprot.org/help/license.
                      Selected fields, reformatted.
                ambiguous:
                  summary: A gene symbol that names two entries
                  value:
                    success: true
                    release: 2026_04
                    match: ambiguous
                    candidates:
                      - accession: C0HLS1
                        entryName: OSCRI_HUMAN
                        gene: SCRIB
                        name: SCRIB overlapping open reading frame protein
                        organism:
                          taxonId: 9606
                          scientificName: Homo sapiens
                          commonName: Human
                        matchedBy: gene
                      - accession: Q14160
                        entryName: SCRIB_HUMAN
                        gene: SCRIB
                        name: Protein scribble homolog
                        organism:
                          taxonId: 9606
                          scientificName: Homo sapiens
                          commonName: Human
                        matchedBy: gene
                    candidateCount: 2
                    notice: >-
                      Protein data from UniProtKB/Swiss-Prot release 2026_04.
                      Copyright UniProt Consortium, https://www.uniprot.org. CC
                      BY 4.0, https://creativecommons.org/licenses/by/4.0/. No
                      warranty, see https://www.uniprot.org/help/license.
                      Selected fields, reformatted.
                notFound:
                  summary: No entry matched
                  value:
                    success: true
                    release: 2026_04
                    match: not_found
                    notice: >-
                      Protein data from UniProtKB/Swiss-Prot release 2026_04.
                      Copyright UniProt Consortium, https://www.uniprot.org. CC
                      BY 4.0, https://creativecommons.org/licenses/by/4.0/. No
                      warranty, see https://www.uniprot.org/help/license.
                      Selected fields, reformatted.
        '400':
          description: >-
            Invalid request. A `protein` that is missing, empty, or longer than
            200 characters, or an empty `organism`, returns `error: "Invalid
            query parameters"` with `details`. An `organism` that matches no
            organism, or a name shared by more than one taxon, returns `code:
            "BAD_REQUEST"`.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  code:
                    type: string
                    example: BAD_REQUEST
                  error:
                    type: string
                    example: >-
                      unknown organism 'unicorn': pass an NCBI taxon ID such as
                      9606, a scientific name such as Homo sapiens, or a UniProt
                      common name such as Human
                  details:
                    type: array
                    description: >-
                      The parameters that failed validation, on an `Invalid
                      query parameters` error.
                    items:
                      type: object
        '401':
          description: Missing or invalid bearer token
        '429':
          description: Rate limit exceeded
        '500':
          description: Internal server error
        '504':
          description: The lookup exceeded its time limit
      security:
        - bearerAuth: []
components:
  schemas:
    ResearchProteinFoundResponse:
      type: object
      title: Found
      required:
        - success
        - release
        - match
        - protein
        - notice
      properties:
        success:
          type: boolean
        release:
          type: string
          description: UniProt release the lookup reads, such as `2026_04`.
        match:
          type: string
          enum:
            - found
        protein:
          $ref: '#/components/schemas/ResearchProteinEntry'
        notice:
          type: string
          description: Attribution and license notice for the UniProt data.
    ResearchProteinAmbiguousResponse:
      type: object
      title: Ambiguous
      required:
        - success
        - release
        - match
        - candidates
        - candidateCount
        - notice
      properties:
        success:
          type: boolean
        release:
          type: string
          description: UniProt release the lookup reads, such as `2026_04`.
        match:
          type: string
          enum:
            - ambiguous
        candidates:
          type: array
          maxItems: 10
          items:
            $ref: '#/components/schemas/ResearchProteinCandidate'
          description: >-
            Up to 10 matching entries, those in the requested organism first,
            then by accession. Candidates carry no annotation.
        candidateCount:
          type: integer
          minimum: 1
          description: Full number of matching entries.
        notice:
          type: string
          description: Attribution and license notice for the UniProt data.
    ResearchProteinNotFoundResponse:
      type: object
      title: Not found
      required:
        - success
        - release
        - match
        - notice
      properties:
        success:
          type: boolean
        release:
          type: string
          description: UniProt release the lookup reads, such as `2026_04`.
        match:
          type: string
          enum:
            - not_found
        notice:
          type: string
          description: Attribution and license notice for the UniProt data.
    ResearchProteinEntry:
      type: object
      required:
        - accession
        - entryName
        - synonyms
        - name
        - organism
        - matchedBy
        - url
        - subcellularLocation
        - function
        - goCellularComponent
        - disease
        - ptm
        - subunit
        - tissueSpecificity
        - domain
        - interactions
        - interactionCount
        - features
        - featureCount
        - variantCount
        - paperIds
      properties:
        accession:
          type: string
          description: Primary UniProt accession, such as `Q6P087`.
        entryName:
          type: string
          description: UniProt entry name, such as `RUSD3_HUMAN`.
        gene:
          type: string
          description: Primary gene name. Left out when UniProt gives none.
        synonyms:
          type: array
          items:
            type: string
          description: Gene synonyms.
        name:
          type: string
          description: Recommended full protein name.
        organism:
          $ref: '#/components/schemas/ResearchProteinOrganism'
        matchedBy:
          $ref: '#/components/schemas/ResearchProteinMatchedBy'
        url:
          type: string
          format: uri
          description: UniProt page for the entry.
        subcellularLocation:
          type: array
          items:
            $ref: '#/components/schemas/ResearchProteinStatement'
          description: Subcellular location statements, in UniProt order.
        function:
          type: array
          items:
            $ref: '#/components/schemas/ResearchProteinStatement'
          description: Function statements, in UniProt order.
        goCellularComponent:
          type: array
          items:
            $ref: '#/components/schemas/ResearchProteinGoTerm'
          description: >-
            GO cellular-component terms with one of these experimental GO
            evidence codes: IDA, HDA, IPI, IMP, IEP, EXP, HTP, IGI.
        length:
          type: integer
          description: Residues in the canonical sequence.
        mass:
          type: integer
          description: Mass of the canonical sequence, in daltons.
        disease:
          type: array
          items:
            $ref: '#/components/schemas/ResearchProteinStatement'
          description: >-
            Disease statements, in UniProt order. Each names its disease in
            `diseaseName` when UniProt gives one.
        ptm:
          type: array
          items:
            $ref: '#/components/schemas/ResearchProteinStatement'
          description: Post-translational modification statements, in UniProt order.
        subunit:
          type: array
          items:
            $ref: '#/components/schemas/ResearchProteinStatement'
          description: Subunit structure statements, in UniProt order.
        tissueSpecificity:
          type: array
          items:
            $ref: '#/components/schemas/ResearchProteinStatement'
          description: Tissue specificity statements, in UniProt order.
        domain:
          type: array
          items:
            $ref: '#/components/schemas/ResearchProteinStatement'
          description: Domain statements, in UniProt order.
        interactions:
          type: array
          maxItems: 25
          items:
            $ref: '#/components/schemas/ResearchProteinInteraction'
          description: >-
            Up to 25 binary interactions from IntAct, those with the most
            experiments first. They carry no evidence kind and no paper.
        interactionCount:
          type: integer
          minimum: 0
          description: Full number of interactions.
        features:
          type: array
          maxItems: 50
          items:
            $ref: '#/components/schemas/ResearchProteinFeature'
          description: >-
            Up to 50 sequence features in UniProt order, such as chains,
            domains, modified residues and binding sites. Natural variants,
            mutagenesis results and isoform sequences are left out.
        featureCount:
          type: integer
          minimum: 0
          description: >-
            Full number of features, not counting natural variants, mutagenesis
            results and isoform sequences.
        variantCount:
          type: integer
          minimum: 0
          description: >-
            Number of natural variants, mutagenesis results and isoform
            sequences UniProt records for the entry. The response does not list
            them.
        pdbCrossReferenceCount:
          type: integer
          minimum: 0
          description: Number of PDB structures the UniProt entry cross-references.
        paperIds:
          type: array
          items:
            type: string
          description: >-
            Every paper cited anywhere in the entry, once each: in the
            statements of every field, the GO terms and the features. It can
            hold papers cited only in `disease`, `ptm`, `subunit`,
            `tissueSpecificity`, `domain` or `features`.
    ResearchProteinCandidate:
      type: object
      required:
        - accession
        - entryName
        - name
        - organism
        - matchedBy
      properties:
        accession:
          type: string
          description: >-
            Primary UniProt accession. Pass it as `protein` to look this entry
            up.
        entryName:
          type: string
        gene:
          type: string
          description: Primary gene name. Left out when UniProt gives none.
        name:
          type: string
          description: Recommended full protein name.
        organism:
          $ref: '#/components/schemas/ResearchProteinOrganism'
        matchedBy:
          $ref: '#/components/schemas/ResearchProteinMatchedBy'
    ResearchProteinOrganism:
      type: object
      required:
        - taxonId
        - scientificName
      properties:
        taxonId:
          type: integer
          description: NCBI taxon id.
        scientificName:
          type: string
        commonName:
          type: string
          description: UniProt common name. Left out when UniProt gives none.
    ResearchProteinMatchedBy:
      type: string
      enum:
        - accession
        - secondary_accession
        - entry_name
        - gene
        - synonym
        - name
      description: >-
        Which identifier matched the entry. `secondary_accession` is an older
        accession that UniProt keeps on the current entry. An older accession
        that UniProt kept on several entries after a split returns `ambiguous`.
        `synonym` is a gene synonym. `name` is a recommended or alternative full
        protein name.
    ResearchProteinStatement:
      type: object
      required:
        - text
        - note
        - evidence
      properties:
        text:
          type: string
          description: >-
            Statement text as UniProt writes it: a location term, a location
            note, or the text of a function, disease, PTM, subunit, tissue
            specificity or domain comment.
        note:
          type: boolean
          description: '`true` for the free-text note of a location comment.'
        molecule:
          type: string
          description: Isoform or chain the statement applies to, such as `Isoform 2`.
        topology:
          type: string
          description: >-
            Membrane topology, on location statements, such as `Single-pass type
            I membrane protein`.
        orientation:
          type: string
          description: >-
            Membrane orientation, on location statements, such as `Cytoplasmic
            side`.
        diseaseName:
          type: string
          description: Disease a disease statement is about, when UniProt names one.
        diseaseAcronym:
          type: string
          description: Acronym of that disease, when UniProt gives one.
        mimId:
          type: string
          description: OMIM id of that disease, such as `191170`.
        evidence:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/ResearchProteinEvidence'
          description: >-
            Evidence for the statement. A statement UniProt leaves without
            evidence has one item with `kind: "untagged"`.
    ResearchProteinGoTerm:
      type: object
      required:
        - id
        - term
        - code
        - assignedBy
        - paperIds
      properties:
        id:
          type: string
          description: GO term id, such as `GO:0005759`.
        term:
          type: string
          description: GO term name, such as `mitochondrial matrix`.
        code:
          type: string
          description: GO evidence code, such as `IDA`.
        assignedBy:
          type: string
          description: Database that assigned the term.
        paperIds:
          type: array
          items:
            type: string
          description: >-
            `pmid:` id of each PubMed paper cited for the term. Empty when no
            paper is loaded for the term. Only GO terms of human entries have
            paper ids.
    ResearchProteinInteraction:
      type: object
      required:
        - partner
        - organismDiffers
        - experiments
        - intactIds
      properties:
        partner:
          type: string
          description: >-
            UniProt accession of the interacting protein. It may be an
            unreviewed entry.
        partnerMolecule:
          type: string
          description: >-
            Isoform or chain of the partner, when the interaction is with one
            form of it.
        partnerGene:
          type: string
          description: Gene name of the partner.
        molecule:
          type: string
          description: Isoform or chain of this entry that interacts.
        organismDiffers:
          type: boolean
          description: '`true` when the partner is from another organism.'
        experiments:
          type: integer
          description: Number of experiments IntAct holds for the interaction.
        intactIds:
          type: array
          items:
            type: string
          description: IntAct ids of this entry and of the partner.
    ResearchProteinFeature:
      type: object
      required:
        - type
        - evidence
      properties:
        type:
          type: string
          enum:
            - initiator_methionine
            - signal
            - propeptide
            - transit_peptide
            - chain
            - peptide
            - topological_domain
            - transmembrane
            - intramembrane
            - domain
            - repeat
            - zinc_finger
            - dna_binding
            - region
            - coiled_coil
            - motif
            - active_site
            - binding_site
            - site
            - non_standard_residue
            - modified_residue
            - lipidation
            - glycosylation
            - disulfide_bond
            - cross_link
          description: UniProt feature type.
        start:
          type: integer
          description: >-
            First residue, counted from 1. Left out when UniProt gives no
            position.
        end:
          type: integer
          description: >-
            Last residue, counted from 1. Left out when UniProt gives no
            position.
        molecule:
          type: string
          description: >-
            Isoform whose sequence the positions count on, when it is not the
            canonical one.
        description:
          type: string
          description: Feature description, such as a domain name or a modification.
        id:
          type: string
          description: UniProt id of the feature, such as `PRO_0000185246`.
        ligand:
          type: string
          description: Ligand name, on binding sites.
        ligandId:
          type: string
          description: Ligand id, on binding sites, such as a ChEBI id.
        evidence:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/ResearchProteinEvidence'
          description: >-
            Evidence for the feature. A feature UniProt leaves without evidence
            has one item with `kind: "untagged"`.
    ResearchProteinEvidence:
      type: object
      required:
        - kind
      properties:
        kind:
          type: string
          enum:
            - experimental
            - large_scale_experimental
            - author_statement
            - curator_inference
            - by_similarity
            - sequence_analysis
            - imported
            - untagged
          description: >-
            Evidence kind, mapped from the ECO code UniProt attaches to the
            statement.
        eco:
          type: string
          description: >-
            ECO code, such as `ECO:0000269`. Left out only when `kind` is
            `untagged`.
        paperId:
          type: string
          description: >-
            PubMed paper the evidence cites, such as `pmid:27974379`, in the
            form `GET /search/research/papers/{id}` accepts.
        fromProtein:
          type: string
          description: >-
            Accession of the related UniProt entry the statement is inferred
            from, on `by_similarity` evidence.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.