from tavily import TavilyClient

tavily_client = TavilyClient(api_key="tvly-YOUR_API_KEY")
response = tavily_client.search("Who is Leo Messi?")

print(response)

const { tavily } = require("@tavily/core");

const tvly = tavily({ apiKey: "tvly-YOUR_API_KEY" });
const response = await tvly.search("Who is Leo Messi?");

console.log(response);

curl --request POST \
  --url https://api.tavily.com/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "who is Leo Messi?",
  "search_depth": "basic",
  "chunks_per_source": 3,
  "max_results": 1,
  "topic": "general",
  "time_range": null,
  "start_date": "2025-02-09",
  "end_date": "2025-12-29",
  "include_published_date": false,
  "filter_by_published_date": false,
  "max_age_hours": 24,
  "include_answer": false,
  "include_raw_content": false,
  "include_images": false,
  "include_image_descriptions": false,
  "include_favicon": false,
  "include_domains": [],
  "exclude_domains": [],
  "include_domains_mode": "restrict",
  "country": null,
  "language": "en",
  "filter_by_language": false,
  "auto_parameters": false,
  "exact_match": false,
  "include_usage": false,
  "safe_search": false
}
'

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tavily.com/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => 'who is Leo Messi?',
    'search_depth' => 'basic',
    'chunks_per_source' => 3,
    'max_results' => 1,
    'topic' => 'general',
    'time_range' => null,
    'start_date' => '2025-02-09',
    'end_date' => '2025-12-29',
    'include_published_date' => false,
    'filter_by_published_date' => false,
    'max_age_hours' => 24,
    'include_answer' => false,
    'include_raw_content' => false,
    'include_images' => false,
    'include_image_descriptions' => false,
    'include_favicon' => false,
    'include_domains' => [
        
    ],
    'exclude_domains' => [
        
    ],
    'include_domains_mode' => 'restrict',
    'country' => null,
    'language' => 'en',
    'filter_by_language' => false,
    'auto_parameters' => false,
    'exact_match' => false,
    'include_usage' => false,
    'safe_search' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tavily.com/search"

	payload := strings.NewReader("{\n  \"query\": \"who is Leo Messi?\",\n  \"search_depth\": \"basic\",\n  \"chunks_per_source\": 3,\n  \"max_results\": 1,\n  \"topic\": \"general\",\n  \"time_range\": null,\n  \"start_date\": \"2025-02-09\",\n  \"end_date\": \"2025-12-29\",\n  \"include_published_date\": false,\n  \"filter_by_published_date\": false,\n  \"max_age_hours\": 24,\n  \"include_answer\": false,\n  \"include_raw_content\": false,\n  \"include_images\": false,\n  \"include_image_descriptions\": false,\n  \"include_favicon\": false,\n  \"include_domains\": [],\n  \"exclude_domains\": [],\n  \"include_domains_mode\": \"restrict\",\n  \"country\": null,\n  \"language\": \"en\",\n  \"filter_by_language\": false,\n  \"auto_parameters\": false,\n  \"exact_match\": false,\n  \"include_usage\": false,\n  \"safe_search\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.tavily.com/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"who is Leo Messi?\",\n  \"search_depth\": \"basic\",\n  \"chunks_per_source\": 3,\n  \"max_results\": 1,\n  \"topic\": \"general\",\n  \"time_range\": null,\n  \"start_date\": \"2025-02-09\",\n  \"end_date\": \"2025-12-29\",\n  \"include_published_date\": false,\n  \"filter_by_published_date\": false,\n  \"max_age_hours\": 24,\n  \"include_answer\": false,\n  \"include_raw_content\": false,\n  \"include_images\": false,\n  \"include_image_descriptions\": false,\n  \"include_favicon\": false,\n  \"include_domains\": [],\n  \"exclude_domains\": [],\n  \"include_domains_mode\": \"restrict\",\n  \"country\": null,\n  \"language\": \"en\",\n  \"filter_by_language\": false,\n  \"auto_parameters\": false,\n  \"exact_match\": false,\n  \"include_usage\": false,\n  \"safe_search\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tavily.com/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"who is Leo Messi?\",\n  \"search_depth\": \"basic\",\n  \"chunks_per_source\": 3,\n  \"max_results\": 1,\n  \"topic\": \"general\",\n  \"time_range\": null,\n  \"start_date\": \"2025-02-09\",\n  \"end_date\": \"2025-12-29\",\n  \"include_published_date\": false,\n  \"filter_by_published_date\": false,\n  \"max_age_hours\": 24,\n  \"include_answer\": false,\n  \"include_raw_content\": false,\n  \"include_images\": false,\n  \"include_image_descriptions\": false,\n  \"include_favicon\": false,\n  \"include_domains\": [],\n  \"exclude_domains\": [],\n  \"include_domains_mode\": \"restrict\",\n  \"country\": null,\n  \"language\": \"en\",\n  \"filter_by_language\": false,\n  \"auto_parameters\": false,\n  \"exact_match\": false,\n  \"include_usage\": false,\n  \"safe_search\": false\n}"

response = http.request(request)
puts response.read_body

{
  "query": "Who is Leo Messi?",
  "answer": "Lionel Messi, born in 1987, is an Argentine footballer widely regarded as one of the greatest players of his generation. He spent the majority of his career playing for FC Barcelona, where he won numerous domestic league titles and UEFA Champions League titles. Messi is known for his exceptional dribbling skills, vision, and goal-scoring ability. He has won multiple FIFA Ballon d'Or awards, numerous La Liga titles with Barcelona, and holds the record for most goals scored in a calendar year. In 2014, he led Argentina to the World Cup final, and in 2015, he helped Barcelona capture another treble. Despite turning 36 in June, Messi remains highly influential in the sport.",
  "images": [],
  "results": [
    {
      "title": "Lionel Messi Facts | Britannica",
      "url": "https://www.britannica.com/facts/Lionel-Messi",
      "content": "Lionel Messi, an Argentine footballer, is widely regarded as one of the greatest football players of his generation. Born in 1987, Messi spent the majority of his career playing for Barcelona, where he won numerous domestic league titles and UEFA Champions League titles. Messi is known for his exceptional dribbling skills, vision, and goal",
      "score": 0.81025416,
      "raw_content": null,
      "published_date": "Tue, 11 Mar 2025 17:00:00 GMT",
      "favicon": "https://britannica.com/favicon.png",
      "images": [
        {
          "url": "<string>",
          "description": "<string>"
        }
      ],
      "id": "a3f9c2-04"
    }
  ],
  "response_time": "1.67",
  "auto_parameters": {
    "topic": "general",
    "search_depth": "basic"
  },
  "usage": {
    "credits": 1
  },
  "request_id": "123e4567-e89b-12d3-a456-426614174111"
}

{
  "detail": {
    "error": "<400 Bad Request, (e.g Invalid topic. Must be 'general' or 'news'.)>"
  }
}

{
  "detail": {
    "error": "Unauthorized: missing or invalid API key."
  }
}

{
  "detail": [
    {
      "type": "string_type",
      "loc": [
        "body",
        "query"
      ],
      "msg": "Input should be a valid string",
      "input": []
    }
  ]
}

{
  "detail": {
    "error": "Your request has been blocked due to excessive requests. Please reduce the rate of requests."
  }
}

{
  "detail": {
    "error": "<432 Custom Forbidden Error (e.g This request exceeds your plan's set usage limit. Please upgrade your plan or contact support@tavily.com)>"
  }
}

{
  "detail": {
    "error": "This request exceeds the pay-as-you-go limit. You can increase your limit on the Tavily dashboard."
  }
}

{
  "detail": {
    "error": "Live content fetching is temporarily unavailable on your plan due to high demand. Retry shortly, or omit max_age_hours/fetch_timeout to be served from cache."
  }
}

{
  "detail": {
    "error": "Internal Server Error"
  }
}