Cost Estimation

POST /v1/estimate

Calculate the estimated cost of an operation before executing it. No crawling or extraction is performed.

Request

curl -X POST "https://scraperone.agentispro.com/v1/estimate" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "operation": "company_crawl",
    "depth": "standard",
    "url": "chiesi.com"
  }'

Request Parameters

Parameter	Type	Required	Default	Description
`operation`	`string`	Yes	—	Operation type (see below)
`depth`	`string`	No	`"standard"`	Operation depth: `quick`, `standard`, `deep`
`url`	`string`	No	`null`	URL to check cache availability

Operation Types

Operation	Description	Base Credits
`scrape`	Single URL scrape	1.0
`company_crawl`	Company intelligence	5.0
`person_crawl`	Person intelligence	3.0
`contact_crawl`	Contact extraction	2.0
`news_monitor`	News monitoring	1.5
`research`	Deep research	8.5

Response

{
  "operation": "company_crawl",
  "estimated_credits": 5.0,
  "estimated_cost_usd": 0.020,
  "cache_available": true,
  "breakdown": [
    {"step": "Homepage crawl", "credits": 1.0},
    {"step": "About page crawl", "credits": 1.0},
    {"step": "Team page crawl", "credits": 1.0},
    {"step": "LLM extraction", "credits": 2.0}
  ]
}

Response Fields

Field	Type	Description
`operation`	`string`	Requested operation
`estimated_credits`	`float`	Estimated credit cost
`estimated_cost_usd`	`float`	Estimated USD cost
`cache_available`	`boolean`	Whether cached data exists
`breakdown`	`CostBreakdown[]`	Per-step cost breakdown

Cache Checking

When url is provided, the estimate checks if cached data is available:

Cache Hit

{
  "operation": "company_crawl",
  "estimated_credits": 0.0,
  "estimated_cost_usd": 0.0,
  "cache_available": true,
  "breakdown": [
    {"step": "Cache lookup", "credits": 0.0}
  ]
}

Cache Miss

{
  "operation": "company_crawl",
  "estimated_credits": 5.0,
  "estimated_cost_usd": 0.020,
  "cache_available": false,
  "breakdown": [...]
}

Credit Pricing

Credits	USD
1.0	$0.004
5.0	$0.020
10.0	$0.040

Depth Multipliers

Depth	Multiplier
`quick`	0.5x
`standard`	1.0x
`deep`	2.0x

Example: Deep Company Crawl

curl -X POST "https://scraperone.agentispro.com/v1/estimate" \
  -d '{"operation": "company_crawl", "depth": "deep"}'

{
  "operation": "company_crawl",
  "estimated_credits": 10.0,
  "estimated_cost_usd": 0.040,
  "cache_available": false,
  "breakdown": [
    {"step": "Homepage crawl", "credits": 1.0},
    {"step": "About page crawl", "credits": 1.0},
    {"step": "Team page crawl", "credits": 1.0},
    {"step": "Products page crawl", "credits": 1.0},
    {"step": "News page crawl", "credits": 1.0},
    {"step": "Additional subpages", "credits": 2.0},
    {"step": "LLM extraction (deep)", "credits": 3.0}
  ]
}

Use Cases

Pre-flight Check

Before executing an expensive operation, check the cost:

const estimate = await fetch('/v1/estimate', {
  method: 'POST',
  body: JSON.stringify({
    operation: 'research',
    depth: 'deep',
    url: 'large-company.com'
  })
});
 
if (estimate.estimated_credits > userCredits) {
  alert('Insufficient credits');
} else {
  // Proceed with research
}

Credit Management

Use estimates to build credit budgets and usage forecasts.

Estimates are approximate. Actual costs may vary slightly based on page complexity and LLM token usage.

Error Handling

Invalid Operation

{
  "error": "Validation error",
  "detail": "Invalid operation. Must be one of: scrape, company_crawl, person_crawl, contact_crawl, news_monitor, research",
  "status_code": 400
}

Cost Estimation

On this page