python

Elicit API — Python Examples

Minimal scripts showing how to call the Elicit API from Python.

Prerequisites

• Python 3.7+
• requests library
• An Elicit API key (account settings)

pip install requests
export ELICIT_API_KEY="your-api-key"

Examples

1. Search papers

Search for academic papers with a research question.

python 1_search.py

2. Filtered search

Narrow results by study type, publication year, and journal quartile.

python 2_filtered_search.py

3. Create a report

Generate an AI-powered research report. Reports take 5-15 minutes — the script polls until completion.

python 3_create_report.py

4. Search clinical trials

Search ClinicalTrials.gov with filters for phase, recruitment status, and posted results.

python 4_search_trials.py

5. Run a systematic review

Screen papers against your criteria and extract data into columns, with exports for each stage.

python 5_systematic_review.py

6. List sessions

List your reports and systematic reviews, newest first.

python 6_list_sessions.py

Notes

• These examples use the requests library for readability. For a zero-dependency alternative, see the CLI tool, which uses only urllib from the standard library.
• Error handling is intentionally minimal to keep the examples readable.

See the API documentation for all available parameters and filters.