---
title: "Estimate credit usage without executing a collection"
method: POST
path: "/v2/cost/estimate"
---

# Estimate credit usage without executing a collection

`POST /v2/cost/estimate`

## Request

- Base URL: `https://api.deepsfetch.com`
- URL: `https://api.deepsfetch.com/v2/cost/estimate`
- Auth: HTTP bearer

## Request body

- object
  - `kind` 'fetch' | 'scrape' | 'map' | 'crawl' | 'collection' | 'structured' | 'extract' | 'search', required
  - `limit` integer
  - `plannedLane` 'http_basic' | 'cf_browser' | 'unlocker_http' | 'managed_browser'
  - `costControl` object
    - `maxCredits` integer: Additional task credit cap. External AI provider costs are excluded.
    - `cacheMode` 'fresh' | 'prefer'
    - `maxAgeSeconds` integer
    - `allowFallback` boolean
    - `taskId` string: Optional shared task identifier for a multi-step operation in this workspace.
  - `aiMode` 'managed' | 'byok'
  - `mode` 'page' | 'byok'
  - `sources` string[]: Combine Web, News, Images, Developer and Research. Developer and Research use domain filters without additional DeepSFetch credits.
  - `source` 'web' | 'news' | 'images': Web pages, news articles or images. One provider request per search.
  - `category` 'general' | 'developer' | 'research': Domain allowlist for Web results; use general with News or Images. No additional DeepSFetch credits.
  - `collectionEngine` 'auto' | 'premium': Opt in to the independent 1-credit engine. Basic and browser retries included. Premium requires a prior failed offer and explicit 12-credit approval.
  - `engineStrategy` 'auto' | 'basic' | 'enhanced'

## Response `200`

Credit range, assumptions, caps and currently available monthly budget

- CostEstimate
  - `currency` 'credits'
  - `min` number
  - `max` number
  - `allowed` boolean
  - `reason` string, nullable
  - `components` object[]
  - `monthly` object
  - `external` boolean
  - `assumptions` string[]

---

[API](https://skmtc.dev/deepsfetch/apis/deepsfetch-api.md) · [All operations](https://skmtc.dev/deepsfetch/apis/deepsfetch-api/llms.txt) · [OpenAPI document](https://skmtc.dev/deepsfetch/apis/deepsfetch-api/revisions/d027e0aecb6f?raw)