POST

Search the web and return ranked results with snippets (max_results, basic/advanced depth). Powered by the Tavily API

/v1/search/web

Powered by Tavily

Request → Response

Examples from schemas.json.

Requestapplication/json
POST /v1/search/web
Content-Type: application/json

{
  "query": "latest AI agent payments",
  "max_results": 5,
  "search_depth": "basic"
}
Responseapplication/json
HTTP/1.1 200 OK
Content-Type: application/json

// Endpoint-specific body after 402 settlement

Overview

Search the web and return ranked results with snippets (max_results, basic/advanced depth). Powered by the Tavily API.

Search API built for AI agents and LLMs.

Request schema

Body: JSON · application/json

FieldTypeDescription
querystringrequired
max_resultsintegerrequiredmin: 1
search_depthstringrequiredenum: basic, advanced
include_domainsarrayoptional
exclude_domainsarrayoptional
IMPLEMENTATION
curl -X POST https://api.tools402.dev/v1/search/web \
  -H "Content-Type: application/json" \
  -d '{
  "query": "latest AI agent payments",
  "max_results": 5,
  "search_depth": "basic"
}'

402 payment flow omitted — see Integrations for settlement.