> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getclean.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> getclean's own MCP server is at https://mcp.getclean.ai/mcp. The /mcp path of this docs site is Mintlify's search over these pages, not getclean.
> Every answer of the API opens with outcome. A page that could not be read is a record whose outcome says why, never an HTTP error; read outcome before anything else.
> The API's contract is the OpenAPI 3.1 file at https://docs.getclean.ai/openapi.yaml; the SDKs are generated from it.
> The product's name is written getclean, in lower case.

# What each call costs

> Calls are charged in 7 units, such as one unit for a fetch and one for each model step. Reading a stored record costs nothing, and neither does a fetch that failed. Every charged response says what it cost.

A call is charged for the work it did, counted in units. The price of each unit is on your account, and `get_limits` returns it.

## The 7 units

| Unit | Charged for |
| - | - |
| `contents` | One fetch or one upload that returned content. |
| `document_pages` | Each page of a document that was read. |
| `recognized_pages` | Each page that was read from its picture, on top of the unit for the page. |
| `model_steps` | Each piece of work by a model: a summary, a filled schema, the judged highlights of one call. |
| `screenshots` | Each picture of a page. |
| `searches` | Each search. |
| `datasource_queries` | Each wording on each datasource of a search. |

## What each call uses

| Call | Units |
| - | - |
| A fetch of a web page | One `contents`. |
| A fetch or an upload of a document | One `contents`, one `document_pages` for each page read, and one `recognized_pages` for each scanned page. |
| A summary, a filled schema, or judged highlights | One `model_steps` each, inside a fetch or on a stored record. |
| A search | One `searches`, one `datasource_queries` for each wording on each datasource, and by default 2 `model_steps`: the ranking, and the choice of datasources. |
| A fetch inside a search | The units of a fetch. |
| A batch | The sum of its fetches or its searches. |

A long scan is the most expensive call there is, because each of its pages uses 2 page units.

## What costs nothing

* A fetch that failed, was refused, or needs a person.
* Every read of a stored record: the whole record, a section, the blocks, the links.
* A highlight that is found word for word.
* A comparison of 2 records.
* The bytes of a page as served, which is the format `raw_html`.
* A read of a stored search, the catalog of datasources, and `get_limits`.
* A model step that failed or was cut by the time limit.
* A request that is sent again with the same idempotency key.

One case is charged although no text comes back: a fetch of a web page with a `baseline_fingerprint` whose text is unchanged. The page has to be read in full to compare it, so the fetch is charged as a fetch.

## Read what a call cost

Every charged response has `cost`. This one is cut to its units.

```json Part of a response theme={"theme":"css-variables"}
{
  "cost": {
    "units": { "contents": 1, "model_steps": 2 },
    "replayed": false
  }
}
```

`cost` also has `actual`, the amount charged, and `ceiling`, the most the call could have cost. `replayed` is `true` on a response that was returned again for a repeated request, and such a response is not charged a second time.

To limit what a call can cost before you send it, see [Set a spending limit that no call can pass](https://docs.getclean.ai/understand/costs-and-budgets.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.