Elicit API

• query (required)

  string — The search query string

• corpus

  string, possible values: "elicit", "pubmed", default: "elicit" — Paper corpus to search. `elicit` (default) searches Elicit's full paper index; `pubmed` restricts to PubMed.

• filters

  object — Filters to narrow search results

  • excludeKeywords

    array — Keywords to exclude from results

    Items:

    string

  • hasPdf

    boolean — Only include papers with available PDFs

  • includeKeywords

    array — Keywords that must appear in the paper

    Items:

    string

  • maxEpochS

    integer — Maximum publication date as Unix epoch seconds

  • maxQuartile

    integer — Maximum journal quartile (1 = top 25%)

  • maxYear

    integer — Maximum publication year

  • minEpochS

    integer — Minimum publication date as Unix epoch seconds

  • minYear

    integer — Minimum publication year

  • pubmedOnly

    boolean — Only include papers from PubMed

  • retracted

    string, possible values: "exclude_retracted", "include_retracted", "only_retracted" — How to handle retracted papers. Defaults to exclude_retracted.

  • typeTags

    array — Filter by study type

    Items:

    string, possible values: "Review", "Meta-Analysis", "Systematic Review", "RCT", "Longitudinal"

• maxResults

  integer, default: 10 — Maximum number of results to return (1-10000)

• searchMode

  string, possible values: "semantic", "keyword", default: "semantic" — How to interpret `query`. `semantic` (default) runs Elicit's semantic search. `keyword` sends the query as a Lucene-style boolean expression directly to the corpus search API. Mutually exclusive with `filters` / `trialFilters` — put filter expressions into the query string in keyword mode.

Content-Type: application/json

Example:

{
  "papers": [
    {
      "elicitId": null,
      "title": "",
      "authors": [
        ""
      ],
      "year": null,
      "abstract": null,
      "doi": null,
      "pmid": null,
      "venue": null,
      "citedByCount": null,
      "urls": [
        ""
      ]
    }
  ],
  "warnings": [
    {
      "corpus": "elicit",
      "searchMode": "semantic",
      "message": "",
      "warningDetails": {
        "type": "",
        "messages": [
          ""
        ]
      }
    }
  ]
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

• query (required)

  string — The search query string

• maxResults

  integer, default: 10 — Maximum number of results to return (1-10000)

• searchMode

  string, possible values: "semantic", "keyword", default: "semantic" — How to interpret `query`. `semantic` (default) runs Elicit's semantic search. `keyword` sends the query as a Lucene-style boolean expression directly to the corpus search API. Mutually exclusive with `filters` / `trialFilters` — put filter expressions into the query string in keyword mode.

• trialFilters

  object — Clinical-trials filters (phase, recruitment status, results)

  • hasResults

    boolean — Only include trials that have posted results

  • phase

    array — Clinical trial phases to include

    Items:

    string, possible values: "NA", "EARLY_PHASE1", "PHASE1", "PHASE2", "PHASE3", "PHASE4"

  • recruitmentStatus

    array — Trial recruitment statuses to include

    Items:

    string, possible values: "ACTIVE_NOT_RECRUITING", "COMPLETED", "ENROLLING_BY_INVITATION", "NOT_YET_RECRUITING", "RECRUITING", "SUSPENDED", "TERMINATED", "WITHDRAWN", "AVAILABLE"

Content-Type: application/json

Example:

{
  "trials": [
    {
      "nctId": "NCT05646706",
      "title": "",
      "summary": null,
      "url": "https://clinicaltrials.gov/study/NCT05646706",
      "overallStatus": null,
      "phase": [
        ""
      ],
      "studyType": null,
      "enrollmentCount": null,
      "conditions": [
        ""
      ],
      "interventions": [
        ""
      ],
      "leadSponsor": null,
      "startDate": null,
      "primaryCompletionDate": null,
      "completionDate": null,
      "hasResults": null,
      "lastUpdatedYear": null
    }
  ],
  "warnings": [
    {
      "corpus": "elicit",
      "searchMode": "semantic",
      "message": "",
      "warningDetails": {
        "type": "",
        "messages": [
          ""
        ]
      }
    }
  ]
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

• researchQuestion (required)

  string — The research question to investigate. Elicit will search for relevant papers, screen them, and extract data to produce a structured report.

• isPublic

  boolean, default: false — Whether the report should be publicly accessible via its URL without authentication. Defaults to false.

• maxExtractPapers

  integer, default: 10 — Maximum number of papers to include in the final extraction table. Papers are screened for relevance before extraction. Defaults to 10.

• maxSearchPapers

  integer, default: 50 — Maximum number of papers to retrieve during the search phase. More papers means a more comprehensive but slower report. Defaults to 50.

• title

  string — Optional title for the report. If provided, Elicit will use this as the report title instead of generating one automatically from the research question.

Content-Type: application/json

Example:

{
  "reportId": "5ad08bfb-cbe0-4911-a8c3-309760d33029",
  "status": "processing",
  "url": "https://elicit.com/review/5ad08bfb-cbe0-4911-a8c3-309760d33029",
  "isPublic": false
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "reports": [
    {
      "reportId": "5ad08bfb-cbe0-4911-a8c3-309760d33029",
      "status": "processing",
      "title": "What are the effects of GLP-1 receptor agonists on cardiovascular outcomes?",
      "url": "https://elicit.com/review/5ad08bfb-cbe0-4911-a8c3-309760d33029",
      "source": "api",
      "createdAt": "2025-06-15T14:30:00.000Z",
      "isPublic": false
    }
  ],
  "nextCursor": "2025-06-15T14:30:00.000Z"
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "reportId": "5ad08bfb-cbe0-4911-a8c3-309760d33029",
  "status": "processing",
  "url": "https://elicit.com/review/5ad08bfb-cbe0-4911-a8c3-309760d33029",
  "isPublic": false,
  "result": {
    "title": "GLP-1 Receptor Agonists and Cardiovascular Outcomes: A Systematic Review",
    "summary": "This review analyzed 42 studies examining the cardiovascular effects of GLP-1 receptor agonists. The evidence suggests significant reductions in major adverse cardiovascular events (MACE), with semaglutide showing the strongest effect (HR 0.74, 95% CI 0.58-0.95)...",
    "reportBody": "# Introduction\n\nGLP-1 receptor agonists have emerged as...",
    "abstract": "This systematic review examines the cardiovascular effects of..."
  },
  "error": {
    "code": "",
    "message": ""
  },
  "pdfUrl": "https://s3.amazonaws.com/...",
  "docxUrl": "https://s3.amazonaws.com/..."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

• researchQuestion (required)

  string — The research question the review is investigating.

• abstractScreening

  object — Abstract-stage screening. Supply `criteria`, `generate: true`, or both. Omit the field to skip.

  • criteria

    array — Explicit screening criteria.

    Items:

    • instructions (required)

      string — Plain-language instructions used to judge whether a paper meets this criterion

    • name (required)

      string — Short name for the criterion

  • generate

    boolean, default: false — When true, Elicit generates additional screening criteria.

• extraction

  object — Extraction stage. Supply `questions`, `generate`, or both. Omit to skip extraction entirely.

  • generate

    boolean, default: false — When true, Elicit generates additional extraction columns.

  • questions

    array — Explicit extraction columns.

    Items:

    • instructions (required)

      string — Plain-language instructions describing what to extract

    • name (required)

      string — Column header for this extraction question

    • choices

      array — Optional fixed list of allowed answers. Omit for free-text extraction. When set, the model is constrained to one of these values.

      Items:

      string

  • useFigures

    boolean, default: false — When true, model may consult figures (higher quality, slower). Subject to plan availability.

• fulltextScreening

  object — Fulltext-stage screening. Supply `criteria`, `reuseAbstractCriteria: true`, or both. Requires `abstractScreening` to be present. Omit to skip.

  • criteria

    array — Explicit fulltext-stage criteria.

    Items:

    • instructions (required)

      string — Plain-language instructions used to judge whether a paper meets this criterion

    • name (required)

      string — Short name for the criterion

  • reuseAbstractCriteria

    boolean, default: false — When true, the abstract-stage criteria are also applied at the fulltext stage.

• generateReport

  boolean, default: false — Generate a full report at the end of the review. Requires `extraction`.

• isPublic

  boolean, default: false — Whether the review should be publicly accessible via its URL without authentication. Defaults to false.

• protocolDetails

  string — Free-form context (PICO, methodology, inclusion/exclusion rationale) used when Elicit generates screening criteria, extraction columns, or the final report.

• searches

  array, default: [] — Searches that feed the review pipeline. If omitted or empty, Elicit runs a semantic search using `researchQuestion` as the query. Total search results are subject to plan-specific limits.

  Items:

  • query (required)

    string — Search query

  • corpus

    string, possible values: "elicit", "pubmed", "clinical_trials", default: "elicit" — Corpus to search. `elicit` covers ~125M papers across most domains and is the default. `pubmed` filters on literature from Pubmed only. `clinical_trials` is registered trials only.

  • maxResults

    integer, default: 200 — Maximum number of papers to retrieve from this search. Plan-specific caps apply.

  • searchMode

    string, possible values: "semantic", "keyword", default: "semantic" — `semantic` (default) uses vector-similarity retrieval; `keyword` uses literal keyword matching.

• title

  string — Optional title for the review.

Content-Type: application/json

Example:

{
  "reviewId": "",
  "status": "processing",
  "url": "",
  "isPublic": true
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "reviews": [
    {
      "reviewId": "",
      "status": "processing",
      "title": "",
      "url": "",
      "source": "api",
      "createdAt": "",
      "isPublic": true
    }
  ],
  "nextCursor": null
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "reviewId": "",
  "status": "processing",
  "url": "",
  "isPublic": true,
  "error": {
    "code": "",
    "message": ""
  },
  "data": {
    "search": {
      "csv": "",
      "xlsx": ""
    },
    "screen": {
      "csv": "",
      "xlsx": ""
    },
    "fulltext": {
      "csv": "",
      "xlsx": ""
    },
    "extract": {
      "csv": "",
      "xlsx": ""
    },
    "report": {
      "result": {
        "title": "",
        "summary": "",
        "reportBody": null,
        "abstract": null
      },
      "pdf": "",
      "docx": "",
      "txt": "",
      "bib": "",
      "ris": ""
    }
  },
  "dataFreshness": null
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request"
  }
}