# API reference

> Calls are JSON over HTTPS at `https://api.clawifi.dev` with your key as a bearer token. The pages below are generated from the OpenAPI spec of Clawifi 1.10.0; account-management, billing and local-only routes are left out.

Canonical page: https://clawifi.dev/api-reference

- **Auth:** Signup, login, verify email, reset password, and API key management happen in the [console](https://clawifi.dev/account); calls use the key.
- **Runtime:** Fetch, browse, scrape, search, map, crawl, extract, and job routes.
- **Billing:** Account-gated checkout and portal sessions backed by Stripe; the price table is public at `GET /billing/manifest`.

## Search

| Endpoint | What it does | MCP tool |
| --- | --- | --- |
| [POST /search/free](https://clawifi.dev/docs/api/post-search-free) | Search Free | `search_free` |
| [POST /search/content](https://clawifi.dev/docs/api/post-search-content) | Search Content |  |
| [POST /search/free/bundle](https://clawifi.dev/docs/api/post-search-free-bundle) | Search Free Bundle |  |
| [GET /search/free/status](https://clawifi.dev/docs/api/get-search-free-status) | Search Free Status |  |

## Read

| Endpoint | What it does | MCP tool |
| --- | --- | --- |
| [POST /fetch](https://clawifi.dev/docs/api/post-fetch) | Fetch Url | `fetch_url` |
| [POST /scrape](https://clawifi.dev/docs/api/post-scrape) | Scrape Url | `scrape_url` |
| [POST /extract](https://clawifi.dev/docs/api/post-extract) | Extract Url | `extract_url` |

## Browse

| Endpoint | What it does | MCP tool |
| --- | --- | --- |
| [POST /browse](https://clawifi.dev/docs/api/post-browse) | Browse Url |  |
| [POST /browse/cloud](https://clawifi.dev/docs/api/post-browse-cloud) | Cloud Render |  |

## Map and crawl

| Endpoint | What it does | MCP tool |
| --- | --- | --- |
| [POST /map](https://clawifi.dev/docs/api/post-map) | Map Site | `map_site` |
| [POST /crawl](https://clawifi.dev/docs/api/post-crawl) | Crawl Site |  |
| [POST /crawls](https://clawifi.dev/docs/api/post-crawls) | Start Crawl | `start_crawl` |
| [GET /crawls/{crawl_id}](https://clawifi.dev/docs/api/get-crawls-crawl-id) | Get Crawl | `get_crawl` |
| [POST /crawls/{crawl_id}/stop](https://clawifi.dev/docs/api/post-crawls-crawl-id-stop) | Stop Crawl |  |
| [POST /crawls/{crawl_id}/resume](https://clawifi.dev/docs/api/post-crawls-crawl-id-resume) | Resume Crawl |  |
| [DELETE /crawls/{crawl_id}](https://clawifi.dev/docs/api/delete-crawls-crawl-id) | Delete Crawl |  |

## Batch

| Endpoint | What it does | MCP tool |
| --- | --- | --- |
| [POST /fetch/batch](https://clawifi.dev/docs/api/post-fetch-batch) | Batch Fetch |  |
| [POST /browse/batch](https://clawifi.dev/docs/api/post-browse-batch) | Batch Browse |  |

## Jobs

| Endpoint | What it does | MCP tool |
| --- | --- | --- |
| [POST /jobs](https://clawifi.dev/docs/api/post-jobs) | Create Job | `create_job` |
| [GET /jobs/{job_id}](https://clawifi.dev/docs/api/get-jobs-job-id) | Get Job | `get_job` |
| [GET /jobs/{job_id}/events](https://clawifi.dev/docs/api/get-jobs-job-id-events) | Job Events |  |
| [GET /jobs/{job_id}/errors](https://clawifi.dev/docs/api/get-jobs-job-id-errors) | Job Errors |  |
| [DELETE /jobs/{job_id}](https://clawifi.dev/docs/api/delete-jobs-job-id) | Cancel Job |  |

## Research

| Endpoint | What it does | MCP tool |
| --- | --- | --- |
| [POST /research](https://clawifi.dev/docs/api/post-research) | Research |  |
| [POST /research/plan](https://clawifi.dev/docs/api/post-research-plan) | Research Plan |  |
| [POST /research/bundle](https://clawifi.dev/docs/api/post-research-bundle) | Research Bundle |  |

## History

| Endpoint | What it does | MCP tool |
| --- | --- | --- |
| [GET /history](https://clawifi.dev/docs/api/get-history) | List History | `list_history` |
| [GET /history/{operation_id}](https://clawifi.dev/docs/api/get-history-operation-id) | Get History Operation |  |
| [GET /history/{operation_id}/result](https://clawifi.dev/docs/api/get-history-operation-id-result) | Get History Result |  |
| [POST /history/{operation_id}/rerun](https://clawifi.dev/docs/api/post-history-operation-id-rerun) | Rerun History Operation |  |

## Monitors

| Endpoint | What it does | MCP tool |
| --- | --- | --- |
| [GET /monitors](https://clawifi.dev/docs/api/get-monitors) | List Monitors | `list_monitors` |
| [POST /monitors](https://clawifi.dev/docs/api/post-monitors) | Create Monitor |  |
| [GET /monitors/{monitor_id}](https://clawifi.dev/docs/api/get-monitors-monitor-id) | Get Monitor |  |
| [POST /monitors/{monitor_id}/run](https://clawifi.dev/docs/api/post-monitors-monitor-id-run) | Run Monitor Now |  |
| [GET /monitors/{monitor_id}/diffs](https://clawifi.dev/docs/api/get-monitors-monitor-id-diffs) | List Monitor Diffs |  |
| [POST /monitors/estimate](https://clawifi.dev/docs/api/post-monitors-estimate) | Estimate Monitor |  |
| [POST /webhooks/endpoints](https://clawifi.dev/docs/api/post-webhooks-endpoints) | Create Webhook Endpoint |  |

## Packages and datasets

| Endpoint | What it does | MCP tool |
| --- | --- | --- |
| [POST /packages/search](https://clawifi.dev/docs/api/post-packages-search) | Search Packages |  |
| [POST /datasets/search](https://clawifi.dev/docs/api/post-datasets-search) | Search Datasets |  |
| [POST /academic/search](https://clawifi.dev/docs/api/post-academic-search) | Search Academic |  |

## Domain records

| Endpoint | What it does | MCP tool |
| --- | --- | --- |
| [POST /osint/domain](https://clawifi.dev/docs/api/post-osint-domain) | Domain Recon |  |
| [POST /osint/dns](https://clawifi.dev/docs/api/post-osint-dns) | Domain Dns |  |

## Account

| Endpoint | What it does | MCP tool |
| --- | --- | --- |
| [GET /account/me](https://clawifi.dev/docs/api/get-account-me) | Account Me | `account` |
| [GET /usage](https://clawifi.dev/docs/api/get-usage) | Usage Summary |  |
| [GET /usage/tokens-saved](https://clawifi.dev/docs/api/get-usage-tokens-saved) | Tokens Saved |  |
| [GET /account/referrals](https://clawifi.dev/docs/api/get-account-referrals) | Account Referrals |  |
| [GET /billing/manifest](https://clawifi.dev/docs/api/get-billing-manifest) | Billing Manifest |  |
| [GET /product/manifest](https://clawifi.dev/docs/api/get-product-manifest) | Product Manifest |  |
| [GET /sources/catalog](https://clawifi.dev/docs/api/get-sources-catalog) | Source Catalog |  |
| [GET /health](https://clawifi.dev/docs/api/get-health) | Health |  |