---
name: tavily-search-and-extract-api
description: "Tavily Search and Extract API skill. Use when working with Tavily Search and Extract for search, extract, crawl. Covers 7 endpoints."
version: 1.0.0
generator: lapsh
---

# Tavily Search and Extract API
API version: 1.0.0

## Auth
Bearer bearer

## Base URL
https://api.tavily.com/

## Setup
1. Set Authorization header with your Bearer token
2. GET /usage -- verify access
3. POST /search -- create first search

## Endpoints

7 endpoints across 6 groups. See references/api-spec.lap for full details.

### search
| Method | Path | Description |
|--------|------|-------------|
| POST | /search | Search for data based on a query |

### extract
| Method | Path | Description |
|--------|------|-------------|
| POST | /extract | Retrieve raw web content from specified URLs |

### crawl
| Method | Path | Description |
|--------|------|-------------|
| POST | /crawl | Initiate a web crawl from a base URL |

### map
| Method | Path | Description |
|--------|------|-------------|
| POST | /map | Initiate a web mapping from a base URL |

### research
| Method | Path | Description |
|--------|------|-------------|
| POST | /research | Initiate a research task |
| GET | /research/{request_id} | Get research task status and results |

### usage
| Method | Path | Description |
|--------|------|-------------|
| GET | /usage | Get API key and account usage details |

## Common Questions

Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "Create a search?" -> POST /search
- "Create a extract?" -> POST /extract
- "Create a crawl?" -> POST /crawl
- "Create a map?" -> POST /map
- "Create a research?" -> POST /research
- "Get research details?" -> GET /research/{request_id}
- "List all usage?" -> GET /usage
- "How to authenticate?" -> See Auth section

## Response Tips
- Check response schemas in references/api-spec.lap for field details
- List endpoints may support pagination; check for limit, offset, or cursor params
- Create/update endpoints typically return the created/updated object

## CLI

```bash
# Update this spec to the latest version
npx @lap-platform/lapsh get tavily-search-and-extract-api -o references/api-spec.lap

# Search for related APIs
npx @lap-platform/lapsh search tavily-search-and-extract-api
```

## References
- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

> Generated from the official API spec by [LAP](https://lap.sh)