curl

Elicit API — curl Examples

Minimal shell scripts showing how to call the Elicit API with curl.

Prerequisites

• curl
• jq for JSON formatting
• An Elicit API key (account settings)

export ELICIT_API_KEY="your-api-key"

Examples

1. Search papers

Search for academic papers with a research question.

./1_search.sh

2. Filtered search

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

./2_filtered_search.sh

3. Create a report

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

./3_create_report.sh

4. Search clinical trials

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

./4_search_trials.sh

5. Run a systematic review

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

./5_systematic_review.sh

6. List sessions

List your reports and systematic reviews, newest first.

./6_list_sessions.sh

Adapting these examples

These scripts hardcode their queries for simplicity. To use your own:

curl -s "https://elicit.com/api/v2/search/papers" \
  -H "Authorization: Bearer ${ELICIT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "your research question here",
    "maxResults": 5
  }' | jq .

See the API documentation for all available parameters and filters.