Skip to main content

​
Examples

​
Keyword Search Example

See the Keyword Search Job endpoint documentation for details. 
curl -X POST "https://discover.veritus.ai/api/v1/job/keywordSearch?limit=100&fieldsOfStudy=Computer%20Science&minCitationCount=10" \
  -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",
    "enrich": true
  }'

​
Query Search Example

See the Query Search Job endpoint documentation for details. 
curl -X POST "https://discover.veritus.ai/api/v1/job/querySearch?limit=200&year=2020:2023" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "This is a detailed query about machine learning and artificial intelligence that describes what you are looking for in academic papers.",
    "callbackUrl": "https://your-domain.com/webhook"
  }'

​
Combined Search Example

See the Combined Search Job endpoint documentation for details. 
curl -X POST "https://discover.veritus.ai/api/v1/job/combinedSearch?limit=300&openAccessPdf=true&quartileRanking=Q1,Q2&sort=citationCount:desc" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phrases": ["natural language processing", "transformer models", "BERT"],
    "query": "Recent advances in transformer-based models for natural language understanding and generation",
    "callbackUrl": "https://your-domain.com/webhook",
    "enrich": true
  }'

​
Important Notes

  1. Callback URLs: Must be valid HTTPS URLs. Localhost URLs are not allowed.
  2. Query Length: For query and combined searches, queries must be between 50 and 5000 characters.
  3. Phrases: For keyword and combined searches, you must provide between 3 and 10 phrases.
  4. Rate Limiting: API rate limits may apply (10 req/min).
  5. Job Processing: Jobs are processed asynchronously. Use the callback URL or poll the job status endpoint to check completion.
  6. Field Names: Field names in query parameters are case-sensitive. Use exact values as specified in the documentation.

​
Contact and Support

Need help or onboarding support? Email: [email protected]
Website: www.veritus.ai
Offices: Tokyo & Kobe, Japan Veritus is backed by academic and government partners including JETRO, OIST Innovation Accelerator, and Lifetime Ventures Japan.