Skip to main content

​
Credits Deduction

Credits are automatically deducted when a job is created. The deduction happens before the job is queued. Veritus has three credit pools: Basic, Pro, and Private Key.
  • How many credits does a job cost?
    • You’re charged 1 credit per 100 results requested
    • Examples: limit=100 → 1 credit, limit=200 → 2 credits, limit=300 → 3 credits
  • Which credit pool is used?
    • If scraperKey is provided: Uses Private Key Credits (privateKeyCreditsBalance) and enrichment is always enabled
    • If scraperKey is not provided and enrich=true: Uses Pro Credits (proCreditsBalance)
    • If scraperKey is not provided and enrich=false: Uses Basic Credits (basicCreditsBalance)
  • Insufficient Credits: If you don’t have enough credits, the request will fail with a 403 Forbidden error: 
    {
  "error": "Insufficient credits"
}

​
Important Notes

  • Credits are deducted immediately when a job is created (before queuing)
  • Credits required = 1 credit per 100 results requested (e.g., limit 100 = 1 credit, limit 200 = 2 credits, limit 300 = 3 credits)
  • Pro credits are used when enrich=true, Basic credits when enrich=false, and Private Key credits when scraperKey is provided
  • Always check your credit balance using the Get User Credits endpoint before creating jobs
  • If job creation fails due to insufficient credits, no credits are deducted

​
Private Key Credits

Private Key lets you bring your own Firecrawl API key via scraperKey when creating a job.
  • scraperKey is optional, but if provided it must be a valid Firecrawl key with at least 50 remaining credits
  • Firecrawl website: firecrawl.dev
  • Private Key uses a separate credit pool (privateKeyCreditsBalance / privateKeyCreditsTotal)
  • When scraperKey is present, enrichment is always enabled and Private Key credits are used

​
Checking Your Credits

Use the Get User Credits endpoint to check your current credit balance: 
curl -X GET "https://discover.veritus.ai/api/v1/user/getCredits" \
  -H "Authorization: Bearer YOUR_API_KEY"