pmid:, pmcid:, and doi: references work the same way arxiv: ones do.
- Find papers by topic, method, benchmark, author, or category
- Inspect canonical paper metadata and source ids
- Read the passages in one paper that answer a specific question
- Expand from strong seed papers to related papers, citers, or references
- Look up a protein’s curated location and function, with the evidence kind for each statement and the papers UniProt cites
To give your agent access to the Research Index, we strongly recommend using our CLI or MCP, combined with our dedicated research skill, which you can install with:
How this relates to /search
Firecrawl has two things named “research”, and they are not the same feature:
Use the Research Index when you are doing literature work: finding papers, reading them, and following citations. Use
categories: ["research"] when you want ordinary web pages that happen to live on academic domains.
Endpoints
The research index GitHub search was removed.
GET /search/research/github and the legacy GET /research/github were removed on 2026-11-03. Both paths now return 410 Gone. Search GitHub issues, pull requests, and READMEs with the Developer Index instead.Search papers
Search paper abstracts with a natural-language query. The response returns ranked papers with canonicalpaperId, preferred primaryId, source ids, title, abstract, authors, creation and update dates, score, and optional ranking signals.
authors: author substring filter; all filters must matchcategories: paper category filter, such ascs.LGfrom: inclusive created/updated lower bound,YYYY-MM-DDto: inclusive created/updated upper bound,YYYY-MM-DDsort:relevance(default) ordate_desc, which returns the newest of the most relevant matches, newest first by created date. It does not list every paper in a date range; addfrom(andto) for that.
Biomedical example
Most of the index is life sciences, so clinical and molecular biology queries work the same way:primaryId in whichever namespace the source uses, so biomedical hits come back as pmid:<id>, pmcid:<id>, or doi:<doi>. Feed that value straight back into the inspect, read, and related endpoints below.
Inspect a paper
Use a canonicalpaperId or a source-specific primaryId. Accepted primaryId forms are arxiv:<id>, pmid:<id>, pmcid:<id>, and doi:<doi> — for example curl -s ".../v2/search/research/papers/pmid:<id>" for a PubMed record.
Read paper passages
Addquery to the same paper path to retrieve the top full-text passages for a question. This is useful for verifying whether a candidate paper actually contains a method, dataset, constraint, or result before you include it.
Find related papers
Expand from one or more seed papers through semantic expansion and rank the candidates against a natural-languageintent.
similar: co-citation and bibliographic-coupling neighborhoodciters: papers that cite the seedreferences: papers cited by the seed
Look up a protein
Look up one named protein and get what UniProtKB/Swiss-Prot curators record about it: its subcellular location, its function, and its GO cellular-component terms, plus its disease, PTM, subunit, tissue specificity and domain annotation, its sequence features and its interactions. Each statement carries its evidence kind and, where UniProt cites one, the PubMed paper behind it as apmid: id, in the form inspect and read accept. Swiss-Prot is the reviewed section of UniProtKB, and an entry outside it returns not_found.
protein: one identifier. A UniProt accession (Q6P087), an entry name (RUSD3_HUMAN), a gene symbol (RPUSD3), or an exact protein name (Mitochondrial mRNA pseudouridine synthase RPUSD3).organism: the organism a gene symbol or protein name is looked up in. An NCBI taxon id (9606), a scientific name (Homo sapiens), or a UniProt common name (Human). Defaults to9606, human.
subcellularLocation and function hold UniProt’s statements in UniProt’s order. A location statement with note: true is the free-text note of a location comment. goCellularComponent lists only the GO terms with one of these experimental GO evidence codes: IDA, HDA, IPI, IMP, IEP, EXP, HTP, IGI. A GO term’s paperIds is empty when no paper is loaded for it, and only GO terms of human entries have paper ids.
An entry also carries these fields, which the example leaves out:
disease,ptm,subunit,tissueSpecificityanddomain: UniProt’s statements on those topics, in UniProt’s order, with the sametextandevidenceas a function statement. A disease statement names its disease indiseaseName, withdiseaseAcronymand the OMIM id inmimIdwhen UniProt gives them.features: up to 50 sequence features in UniProt’s order, such as chains, domains, modified residues and binding sites. Each has atype,startandendresidue positions, adescription, UniProt’s featureid, aligandandligandIdon binding sites, andevidence.featureCountgives the full number. Natural variants, mutagenesis results and isoform sequences are left out, andvariantCountgives their number.interactions: up to 25 binary interactions from IntAct, those with the most experiments first. Each names thepartneraccession andpartnerGene, says whether the partner is from another organism inorganismDiffers, and gives the number ofexperimentsand theintactIds. Interactions carry no evidence kind and no paper.interactionCountgives the full number.lengthandmass: residues and daltons of the canonical sequence.pdbCrossReferenceCount: how many PDB structures the UniProt entry cross-references.
paperIds collects every paper cited anywhere in the entry once, so it can include papers cited only in disease, ptm, subunit, tissueSpecificity, domain or features. To find the statement a paper supports, look for its paperId in the evidence items.
From MCP, call firecrawl_research_lookup_protein with protein and, optionally, organism.
How a lookup resolves
The lookup matches whole identifiers and does not read free text, so a question such as “where is RPUSD3 localized” returnsmatch: "not_found". Use paper search for questions. Accessions, entry names, gene symbols and protein names match in any case.
- A primary accession or an entry name names one entry. An isoform suffix such as
-2is dropped, andorganismdoes not narrow the match. - A secondary accession is an older accession that UniProt keeps on the current entry, and a match on one has
matchedBy: "secondary_accession". When UniProt split an entry, its old accession stays on each new entry, and the lookup returns them asambiguous. - A gene symbol or a protein name is looked up in
organism. A primary gene symbol wins over a synonym. A protein name is a recommended or alternative full name. - When the symbol or name fits one entry,
matchisfound. When it fits several,matchisambiguous.candidateslists up to 10 of them, with identifiers and no annotation, andcandidateCountgives the full number. Call again with one candidate’saccession. - When nothing in
organismmatches, the lookup checks other organisms and returns what it finds asambiguous, even when that is a single entry. The lookup never guesses between proteins and never switches species silently. - Anything else is
not_found, with status200.
protein that is missing, empty, or longer than 200 characters, an empty organism, or an unknown query parameter returns 400 with error: "Invalid query parameters" and details. An organism that matches no organism in the data, or a name shared by more than one taxon, returns 400 with code: "BAD_REQUEST" and an error that says what to pass. The organism check runs before the lookup, so it applies even when protein is an accession. A lookup that runs past its 2-second limit returns 504 with code: "GATEWAY_TIMEOUT". If no answer arrives within 5 seconds, the API returns 504 with an empty body.
Evidence kinds
Each statement has one or moreevidence items. kind names the type of evidence, and eco gives the Evidence and Conclusion Ontology (ECO) code that UniProt attaches. See UniProt’s evidence guide for the full definitions.
An evidence item has a
paperId when UniProt cites a PubMed paper for it. A by_similarity or sequence_analysis statement is inferred, not measured on this protein.
Attribution
Protein data from UniProtKB/Swiss-Prot. Copyright UniProt Consortium. Licensed under CC BY 4.0. No warranty, see the UniProt license. Selected fields, reformatted. Every200 response repeats this in notice and names the UniProt release in release.
