> ## 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. 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
        - 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.
        paperIds:
          type: array
          items:
            type: string
          description: Every paper cited in the statements and GO terms, deduplicated.
    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: Location term, note text, or function text, as UniProt writes it.
        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`.
        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.
    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.