Firecrawl Research Related Papers
Find arXiv papers through the citation graph and rank and filter candidates by research intent. Required parameters: `seed_ids` is an array of 1–10 actual paper IDs obtained from paper search or inspection; the first is the primary seed and later IDs are anchors. `intent` is a nonempty natural-language description of the research topic or relevance criteria. Optional parameters: `mode` is `similar` (default; co-citation/bibliographic coupling), `citers` (papers citing a seed), or `references` (papers cited by a seed). `k` is an integer from 1 to 500 specifying the maximum number returned. `rerank` is a boolean that enables an additional rerank over fused candidates. Defaults for `k` and `rerank` are not specified. Additional input parameters are not accepted. Returns `results`, an array of ranked candidates, and `poolSize`, the number of candidates evaluated before ranking. Optional `note` describes candidate production and `agent_hints` contains provider guidance. Candidate entries may include `paperId`, `primaryId`, source identifiers in `ids`, `title`, `authors`, `abstract`, `categories`, `createdDate`, and `updateDate`; metadata is not guaranteed to be present and some fields allow null. This is seed-based retrieval, not a guarantee of exhaustive coverage or a full-text retrieval operation. The configured synchronous SimpleMapping returns results directly; it has no separate task submission, polling, or result-fetch workflow. The provider describes `similar` as performing multi-round expansion internally, which does not imply an asynchronous client lifecycle.
Pricing
| Condition | Charge |
|---|---|
| Each call | 0 credits/call |
Each call has a fixed charge of 0 credits.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
k | integer | No | Maximum number of related papers to return. | — |
mode | enum (similar | citers | references) | No | No parameter description. | — |
intent | string | Yes | Natural-language description of the research topic or relevance criteria used to rank and filter results. | — |
rerank | boolean | No | Apply an additional rerank over the fused candidates. | — |
seed_ids | array | Yes | One to ten seed paper IDs. The first is the primary seed; subsequent IDs are anchors for citation-graph expansion. Use actual IDs returned by paper search or inspection. | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Key
