cli

Elicit API — CLI

A command-line tool for searching papers and clinical trials and creating reports from your terminal. No dependencies beyond the Python standard library.

Setup

export ELICIT_API_KEY="your-api-key"   # get one at https://elicit.com/settings

No pip install needed — the script uses only urllib and other stdlib modules.

Usage

Search papers

python elicit.py search "effects of sleep deprivation on cognition"

With filters:

python elicit.py search "CBT for insomnia" --type RCT --min-year 2020
python elicit.py search "CRISPR gene editing" --pubmed-only --max-results 10
python elicit.py search "vaccine efficacy" --min-year 2020 --max-year 2024

Search clinical trials

python elicit.py trials "semaglutide for weight loss"
python elicit.py trials "semaglutide for weight loss" --phase PHASE3 --has-results
python elicit.py trials "CAR-T lymphoma" --recruitment-status RECRUITING

Create a report

Reports take 5-15 minutes. The CLI polls and shows progress:

python elicit.py report "What is the evidence for melatonin improving sleep quality?"

Create without waiting:

python elicit.py report "melatonin and sleep quality" --no-wait

Control the scope:

python elicit.py report "melatonin and sleep" --search-papers 100 --extract-papers 20

List sessions

Lists your reports and systematic reviews, newest first:

python elicit.py sessions
python elicit.py sessions --status completed --limit 5
python elicit.py sessions --type systematicReview

Resume a paused session

If a report or review runs out of quota mid-run, its status becomes pausedForInsufficientQuota. Once quota is available again:

python elicit.py resume <session-id>

Raw JSON output

Add --json to any command to get the raw API response:

python elicit.py search "sleep deprivation" --json
python elicit.py report "melatonin and sleep" --json

Available filters

Paper search (search):

Flag	Description	Example
--min-year	Earliest publication year	--min-year 2020
--max-year	Latest publication year	--max-year 2024
--type	Study type	--type RCT, --type Meta-analysis
--pubmed-only	Restrict to PubMed-indexed papers	--pubmed-only
--max-results	Max papers to return	--max-results 10

Trial search (trials):

Flag	Description	Example
--phase	Trial phase, repeatable	--phase PHASE2 --phase PHASE3
--recruitment-status	Recruitment status, repeatable	--recruitment-status RECRUITING
--has-results	Only trials with posted results	--has-results
--max-results	Max trials to return	--max-results 10