Tavily Search API

Tavily — Search

Data from Tavily.

Category: Search And Extraction

Known example parameters are illustrative and may be incomplete; inspect all required inputs before running.

Discover

curl https://keepbal.com/apis/v1/discover -H 'Authorization: Bearer YOUR_KEEPBAL_KEY' -H 'Content-Type: application/json' -d '{"query":"Tavily"}'

Inspect

curl https://keepbal.com/apis/v1/inspect -H 'Authorization: Bearer YOUR_KEEPBAL_KEY' -H 'Content-Type: application/json' -d '{"publicId":"tavily/search"}'

curl

curl https://keepbal.com/apis/v1/tavily/search \
  -H 'Authorization: Bearer YOUR_KEEPBAL_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"body":{"query":"latest research"}}'

MCP run_tool

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run_tool",
    "arguments": {
      "tool": "tavily/search",
      "input": {
        "body": {
          "query": "latest research"
        }
      }
    }
  }
}

Python

import json, os, requests

# Inspect first and replace input_data with the required parameters.
input_data = json.loads("{\"body\":{\"query\":\"latest research\"}}")
response = requests.post(
    "https://keepbal.com/apis/v1/tavily/search",
    headers={"Authorization": "Bearer " + os.environ["KEEPBAL_API_KEY"]},
    json=input_data,
)
response.raise_for_status()
print(response.json())

Errors and billing

Failed provider calls are not charged. HTTP 400 invalid_request means invalid JSON or parameters, including missing pathParams. HTTP 401 missing_api_key or invalid_api_key means authentication is required. HTTP 402 insufficient_credits means insufficient balance; top up before retrying. HTTP 503 provider_unavailable means the provider is unavailable. A pending run can settle later; poll GET /apis/v1/runs/{id} instead of starting another execution.

Frequently asked questions

How much does this API cost?

Variable: provider price plus 35%

How do I start?

Create a KeepBal account with $1 free credit, obtain an API key, and inspect this tool before running it.

Related tools

MCP documentation

Start with $1 free credit