Find Related Papers

1 min read

get/search/research/papers/{id}/similar

Request example

curl --request GET \
  --url https://api.firecrawl.dev/v2/search/research/papers/{id}/similar \
  --header 'Authorization: Bearer <token>'

Response

{
  "success": true,
  "results": [
    {
      "paperId": "482107036680302043",
      "primaryId": "arxiv:2006.11239",
      "ids": {
        "arxiv": [
          "2006.11239"
        ]
      },
      "title": "Denoising Diffusion Probabilistic Models",
      "abstract": "We present high quality image synthesis results using diffusion probabilistic models...",
      "score": 0.032119,
      "signals": {
        "structural": 12,
        "semantic": 0.61,
        "articleRank": 0.00031,
        "seedOverlap": 2
      }
    }
  ],
  "poolSize": 40,
  "truncated": false
}

get/search/research/papers/{id}/similar

Expand from a seed paper through structural expansion and rank candidate papers against a natural-language intent. Use mode to choose similar papers, citers, or references.

For a workflow overview, see the Research Index guide.

Authorization

Authorizationstringheaderrequired#

Bearer authentication header of the form Bearer <token>, where <token> is your API key.

Path parameters

idstringrequired#

Primary seed paper reference.

Query parameters

intentstringrequired#

Natural-language ranking/filtering intent used for semantic ranking.

Length: min 1

modeenum<string>#

Structural expansion mode.

Default: "similar"

Options:similarcitersreferences

kinteger#

Maximum number of related papers to return.

Default: 40

Range: 1–500

rerankboolean#

Apply an additional rerank over fused candidates.

anchorstring#

Additional seed paper reference. Repeat this parameter for multiple anchors.

Responses

application/json

Ranked related papers.

successbooleanrequired#

resultsobject[]required#

Show child attributes

paperIdstringrequired#

Canonical paper id, or web:<url> for SERP-discovered display results.

primaryIdstringrequired#

Preferred cite/fetch id such as arxiv:<id>, pmid:<id>, pmcid:<id>, or doi:<id>.

idsobject#

Source identifiers grouped by namespace.

Show child attributes

{key}string[]#

titlestringrequired#

abstractstringrequired#

scorenumberrequired#

signalsobject#

Show child attributes

structuralnumberrequired#

Raw structural graph signal.

semanticnumberrequired#

Semantic score from the intent search.

articleRanknumberrequired#

Structural expansion article-rank score.

seedOverlapintegerrequired#

Number of distinct seeds connected to this candidate.

Range: >= 0

poolSizeintegerrequired#

Range: >= 0

truncatedbooleanrequired#

notestring#

Inspect or Read Paper Search the Developer Index