---
title: "Tavily Crawl is a graph-based website traversal tool that can explore hundreds of paths in parallel with built-in extraction and intelligent discovery."
method: POST
path: "/tavily/crawl"
tags: ["Tavily"]
---

# Tavily Crawl is a graph-based website traversal tool that can explore hundreds of paths in parallel with built-in extraction and intelligent discovery.

`POST /tavily/crawl`

## Request

- Base URL: `https://api.orthogonal.com/mpp`
- URL: `https://api.orthogonal.com/mpp/tavily/crawl`
- Auth: none declared
- TypeScript: <https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/docs/tavily/crawl/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- object
  - `url` string, required: The root URL to begin the crawl.
  - `instructions` string: Natural language instructions for the crawler. When specified, the mapping cost increases to 2 API credits per 10 successful pages instead of 1 API credit per 10 pages.
  - `chunks_per_source` integer: Chunks are short content snippets (maximum 500 characters each) pulled directly from the source. Use chunks_per_source to define the maximum number of relevant chunks returned per source and to control the raw_content length. Chunks will appear in the raw_content field as: <chunk 1> [...] <chunk 2> [...] <chunk 3>. Available only when instructions are provided. Must be between 1 and 5.
  - `max_depth` integer: Max depth of the crawl. Defines how far from the base URL the crawler can explore.
  - `max_breadth` integer: Max number of links to follow per level of the tree (i.e., per page).
  - `limit` integer: Total number of links the crawler will process before stopping.
  - `select_paths` string[]: Regex patterns to select only URLs with specific path patterns (e.g., /docs/.*, /api/v1.*).
  - `select_domains` string[]: Regex patterns to select crawling to specific domains or subdomains (e.g., ^docs\.example\.com$).
  - `exclude_paths` string[]: Regex patterns to exclude URLs with specific path patterns (e.g., /private/.*, /admin/.*).
  - `exclude_domains` string[]: Regex patterns to exclude specific domains or subdomains from crawling (e.g., ^private\.example\.com$).
  - `allow_external` boolean: Whether to include external domain links in the final results list.
  - `include_images` boolean: Whether to include images in the crawl results.
  - `extract_depth` string: Advanced extraction retrieves more data, including tables and embedded content, with higher success but may increase latency. basic extraction costs 1 credit per 5 successful extractions, while advanced extraction costs 2 credits per 5 successful extractions.
  - `format` string: The format of the extracted web page content. markdown returns content in markdown format. text returns plain text and may increase latency.
  - `include_favicon` boolean: Whether to include the favicon URL for each result.
  - `timeout` string: Maximum time in seconds to wait for the crawl operation before timing out. Must be between 10 and 150 seconds.

## Response `200`

Successful response

## Other responses

- `402`: Payment Required (x402 / MPP / np)

## Changes

- **2026-11-08** `857e915717f4`: 1 breaking
  - added required request body
- **2026-08-25** `806e279c8d50`: 2 info
  - api tag `Tavily` added
  - api tag `Tavily API` removed

[Operation history](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/changes/tavily/crawl/post.md)

---

[API](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace.md) - [All operations](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/llms.txt) - [OpenAPI document](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/revisions/857e915717f4?raw)