Skip to main content

Base URL

The base URL for all API endpoints is:
https://discover.veritus.ai/api

Complete Workflow: Check Credits, Create Job, and Check Status

# Step 1: Check your credit balance
# See: /learn/search-api/user-credits
curl -X GET "https://discover.veritus.ai/api/v1/user/getCredits" \
  -H "Authorization: Bearer YOUR_API_KEY"
# Step 2: Create a keyword search job (credits will be deducted)
# See: /learn/search-api/jobs-keyword-search
JOB_RESPONSE=$(curl -X POST "https://discover.veritus.ai/api/v1/job/keywordSearch?limit=100" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phrases": ["machine learning", "neural networks", "deep learning"],
    "callbackUrl": "https://your-domain.com/webhook"
  }')

# Extract job ID from response (example)
JOB_ID="507f1f77bcf86cd799439011"
# Step 3: Check job status
# See: /learn/search-api/jobs-status
curl -X GET "https://discover.veritus.ai/api/v1/job/507f1f77bcf86cd799439011" \
  -H "Authorization: Bearer YOUR_API_KEY"

Search with Multiple Filters

# See: /learn/search-api/jobs-combined-search
curl -X POST "https://discover.veritus.ai/api/v1/job/combinedSearch?limit=200&fieldsOfStudy=Computer%20Science,Mathematics&minCitationCount=50&openAccessPdf=true&quartileRanking=Q1,Q2,Q3&year=2020:2023&sort=citationCount:desc" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phrases": ["artificial intelligence", "machine learning", "deep learning"],
    "query": "Recent advances in AI and machine learning research",
    "enrich": true
  }'

Get Paper Details and Citations

# See: /learn/search-api/papers-get
curl -X GET "https://discover.veritus.ai/api/v1/papers/12345678" \
  -H "Authorization: Bearer YOUR_API_KEY"