> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.usescout.sh/llms.txt.
> For full documentation content, see https://docs.usescout.sh/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.usescout.sh/_mcp/server.

# API reference

The pages in this section are generated from Scout's OpenAPI specification and
grouped by product: **Search**, **Extract**, **Tasks**, **FindAll**, **Chat**
and **Monitors**. Each endpoint page documents its request and response schema
and includes an interactive explorer you can call directly.

## Base URL

```bash
https://core.usescout.sh
```

## Conventions

* Every endpoint is under the `/v1` prefix and speaks JSON over HTTPS.
* Responses are flat JSON. Cache state and timing are returned as response
  headers (`X-Cache`, `X-Elapsed-Ms`) so the body stays schema-clean.
* Most responses carry a `credits` field reporting the relative cost of the
  call.
* Every request must include `Authorization: Bearer <YOUR_API_KEY>` — see [Authentication](/authentication).

## The schema

The OpenAPI specification is also available to download or pipe into your own
tooling and SDK generators.

The version-pinned schema as JSON.

The same schema as YAML.