Search
curl --request POST \
--url https://tako.com/api/v3/search \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"query": "<string>",
"effort": "fast",
"sources": {
"data": {
"count": 5,
"include_contents": false,
"mode": "inline",
"content_format": "json_compact",
"max_rows": 100,
"node_ids": [
"<string>"
],
"strict": false
},
"web": {
"count": 10,
"include_contents": false,
"include_domains": [
"<string>"
],
"exclude_domains": [
"<string>"
],
"snippet_max_chars": 10000,
"highlights": false,
"article_content_max_chars": 30000,
"published_after": "2023-12-25",
"published_before": "2023-12-25"
}
},
"location": {
"latitude": 0,
"longitude": 0
},
"country_code": "US",
"locale": "en-US",
"timezone": "<string>",
"output_settings": {
"image_dark_mode": true,
"force_refresh": false
},
"include_related": 10
}
'import requests
url = "https://tako.com/api/v3/search"
payload = {
"query": "<string>",
"effort": "fast",
"sources": {
"data": {
"count": 5,
"include_contents": False,
"mode": "inline",
"content_format": "json_compact",
"max_rows": 100,
"node_ids": ["<string>"],
"strict": False
},
"web": {
"count": 10,
"include_contents": False,
"include_domains": ["<string>"],
"exclude_domains": ["<string>"],
"snippet_max_chars": 10000,
"highlights": False,
"article_content_max_chars": 30000,
"published_after": "2023-12-25",
"published_before": "2023-12-25"
}
},
"location": {
"latitude": 0,
"longitude": 0
},
"country_code": "US",
"locale": "en-US",
"timezone": "<string>",
"output_settings": {
"image_dark_mode": True,
"force_refresh": False
},
"include_related": 10
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
query: '<string>',
effort: 'fast',
sources: {
data: {
count: 5,
include_contents: false,
mode: 'inline',
content_format: 'json_compact',
max_rows: 100,
node_ids: ['<string>'],
strict: false
},
web: {
count: 10,
include_contents: false,
include_domains: ['<string>'],
exclude_domains: ['<string>'],
snippet_max_chars: 10000,
highlights: false,
article_content_max_chars: 30000,
published_after: '2023-12-25',
published_before: '2023-12-25'
}
},
location: {latitude: 0, longitude: 0},
country_code: 'US',
locale: 'en-US',
timezone: '<string>',
output_settings: {image_dark_mode: true, force_refresh: false},
include_related: 10
})
};
fetch('https://tako.com/api/v3/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://tako.com/api/v3/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' => '<string>',
'effort' => 'fast',
'sources' => [
'data' => [
'count' => 5,
'include_contents' => false,
'mode' => 'inline',
'content_format' => 'json_compact',
'max_rows' => 100,
'node_ids' => [
'<string>'
],
'strict' => false
],
'web' => [
'count' => 10,
'include_contents' => false,
'include_domains' => [
'<string>'
],
'exclude_domains' => [
'<string>'
],
'snippet_max_chars' => 10000,
'highlights' => false,
'article_content_max_chars' => 30000,
'published_after' => '2023-12-25',
'published_before' => '2023-12-25'
]
],
'location' => [
'latitude' => 0,
'longitude' => 0
],
'country_code' => 'US',
'locale' => 'en-US',
'timezone' => '<string>',
'output_settings' => [
'image_dark_mode' => true,
'force_refresh' => false
],
'include_related' => 10
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$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://tako.com/api/v3/search"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"effort\": \"fast\",\n \"sources\": {\n \"data\": {\n \"count\": 5,\n \"include_contents\": false,\n \"mode\": \"inline\",\n \"content_format\": \"json_compact\",\n \"max_rows\": 100,\n \"node_ids\": [\n \"<string>\"\n ],\n \"strict\": false\n },\n \"web\": {\n \"count\": 10,\n \"include_contents\": false,\n \"include_domains\": [\n \"<string>\"\n ],\n \"exclude_domains\": [\n \"<string>\"\n ],\n \"snippet_max_chars\": 10000,\n \"highlights\": false,\n \"article_content_max_chars\": 30000,\n \"published_after\": \"2023-12-25\",\n \"published_before\": \"2023-12-25\"\n }\n },\n \"location\": {\n \"latitude\": 0,\n \"longitude\": 0\n },\n \"country_code\": \"US\",\n \"locale\": \"en-US\",\n \"timezone\": \"<string>\",\n \"output_settings\": {\n \"image_dark_mode\": true,\n \"force_refresh\": false\n },\n \"include_related\": 10\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
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://tako.com/api/v3/search")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"effort\": \"fast\",\n \"sources\": {\n \"data\": {\n \"count\": 5,\n \"include_contents\": false,\n \"mode\": \"inline\",\n \"content_format\": \"json_compact\",\n \"max_rows\": 100,\n \"node_ids\": [\n \"<string>\"\n ],\n \"strict\": false\n },\n \"web\": {\n \"count\": 10,\n \"include_contents\": false,\n \"include_domains\": [\n \"<string>\"\n ],\n \"exclude_domains\": [\n \"<string>\"\n ],\n \"snippet_max_chars\": 10000,\n \"highlights\": false,\n \"article_content_max_chars\": 30000,\n \"published_after\": \"2023-12-25\",\n \"published_before\": \"2023-12-25\"\n }\n },\n \"location\": {\n \"latitude\": 0,\n \"longitude\": 0\n },\n \"country_code\": \"US\",\n \"locale\": \"en-US\",\n \"timezone\": \"<string>\",\n \"output_settings\": {\n \"image_dark_mode\": true,\n \"force_refresh\": false\n },\n \"include_related\": 10\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://tako.com/api/v3/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"<string>\",\n \"effort\": \"fast\",\n \"sources\": {\n \"data\": {\n \"count\": 5,\n \"include_contents\": false,\n \"mode\": \"inline\",\n \"content_format\": \"json_compact\",\n \"max_rows\": 100,\n \"node_ids\": [\n \"<string>\"\n ],\n \"strict\": false\n },\n \"web\": {\n \"count\": 10,\n \"include_contents\": false,\n \"include_domains\": [\n \"<string>\"\n ],\n \"exclude_domains\": [\n \"<string>\"\n ],\n \"snippet_max_chars\": 10000,\n \"highlights\": false,\n \"article_content_max_chars\": 30000,\n \"published_after\": \"2023-12-25\",\n \"published_before\": \"2023-12-25\"\n }\n },\n \"location\": {\n \"latitude\": 0,\n \"longitude\": 0\n },\n \"country_code\": \"US\",\n \"locale\": \"en-US\",\n \"timezone\": \"<string>\",\n \"output_settings\": {\n \"image_dark_mode\": true,\n \"force_refresh\": false\n },\n \"include_related\": 10\n}"
response = http.request(request)
puts response.read_body{
"request_id": "<string>",
"cards": [
{
"card_id": "<string>",
"title": "<string>",
"description": "<string>",
"semantic_description": "<string>",
"webpage_url": "<string>",
"image_url": "<string>",
"embed_url": "<string>",
"sources": [
{
"source_name": "S&P Global",
"source_description": "<string>",
"url": "https://xignite.com",
"source_text": "<string>"
}
],
"methodologies": [
{
"methodology_name": "Where the Data Comes From - S&P Global",
"methodology_description": "Financial metrics standardized by S&P Global from company regulatory filings, press releases, and restatements."
}
],
"source_indexes": [],
"card_type": "<string>",
"content": {
"cost": 0,
"data": "<string>",
"records": [
{}
],
"dataset": {
"columns": [
{
"name": "<string>",
"unit": "<string>"
}
],
"rows": [
[
"<string>"
]
],
"total_rows": 123,
"truncated": true,
"ref": "<string>",
"sources": [
{
"name": "<string>",
"index": "data"
}
],
"provenance": "query"
},
"card_data": {},
"card_data_schema": {},
"url": "<string>",
"expires_at": "<string>",
"total_rows": 123,
"truncated": false,
"export_pricing": {
"baseline_usd": 123,
"row_cpm_usd": 123,
"free_rows": 123,
"max_rows_ceiling": 123
},
"manifest": [
{
"name": "<string>",
"metric": "<string>",
"entity": "<string>",
"unit": "<string>"
}
]
},
"exportable": false,
"relevance_score": 123,
"nodes": [
{
"id": "<string>",
"name": "<string>",
"description": "<string>"
}
],
"metric_definitions": [
{
"name": "<string>",
"definition": "<string>"
}
],
"data_freshness": {
"coverage_end": "2026",
"data_as_of": "2026-10-01",
"last_updated": "2026-07-14"
}
}
],
"web_results": [
{
"title": "<string>",
"url": "<string>",
"snippet": "<string>",
"source_name": "<string>",
"publish_date": "<string>",
"content": {
"cost": 0,
"data": "<string>",
"records": [
{}
],
"dataset": {
"columns": [
{
"name": "<string>",
"unit": "<string>"
}
],
"rows": [
[
"<string>"
]
],
"total_rows": 123,
"truncated": true,
"ref": "<string>",
"sources": [
{
"name": "<string>",
"index": "data"
}
],
"provenance": "query"
},
"card_data": {},
"card_data_schema": {},
"url": "<string>",
"expires_at": "<string>",
"total_rows": 123,
"truncated": false,
"export_pricing": {
"baseline_usd": 123,
"row_cpm_usd": 123,
"free_rows": 123,
"max_rows_ceiling": 123
},
"manifest": [
{
"name": "<string>",
"metric": "<string>",
"entity": "<string>",
"unit": "<string>"
}
]
},
"citation_number": 123
}
],
"usage": {
"total_cost_usd": 123,
"compute": {
"cost_usd": 123
},
"data": {
"cost_usd": 123,
"datasets": 123
}
},
"related": [
{
"query": "<string>",
"description": "<string>",
"node_ids": [
"<string>"
]
}
]
}{
"error_message": "<string>"
}{
"error_message": "<string>"
}{
"error_message": "<string>"
}{
"error_message": "<string>"
}Search Tools
Search
Search Tako knowledge cards and the web with a natural language query
POST
/
v3
/
search
Search
curl --request POST \
--url https://tako.com/api/v3/search \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"query": "<string>",
"effort": "fast",
"sources": {
"data": {
"count": 5,
"include_contents": false,
"mode": "inline",
"content_format": "json_compact",
"max_rows": 100,
"node_ids": [
"<string>"
],
"strict": false
},
"web": {
"count": 10,
"include_contents": false,
"include_domains": [
"<string>"
],
"exclude_domains": [
"<string>"
],
"snippet_max_chars": 10000,
"highlights": false,
"article_content_max_chars": 30000,
"published_after": "2023-12-25",
"published_before": "2023-12-25"
}
},
"location": {
"latitude": 0,
"longitude": 0
},
"country_code": "US",
"locale": "en-US",
"timezone": "<string>",
"output_settings": {
"image_dark_mode": true,
"force_refresh": false
},
"include_related": 10
}
'import requests
url = "https://tako.com/api/v3/search"
payload = {
"query": "<string>",
"effort": "fast",
"sources": {
"data": {
"count": 5,
"include_contents": False,
"mode": "inline",
"content_format": "json_compact",
"max_rows": 100,
"node_ids": ["<string>"],
"strict": False
},
"web": {
"count": 10,
"include_contents": False,
"include_domains": ["<string>"],
"exclude_domains": ["<string>"],
"snippet_max_chars": 10000,
"highlights": False,
"article_content_max_chars": 30000,
"published_after": "2023-12-25",
"published_before": "2023-12-25"
}
},
"location": {
"latitude": 0,
"longitude": 0
},
"country_code": "US",
"locale": "en-US",
"timezone": "<string>",
"output_settings": {
"image_dark_mode": True,
"force_refresh": False
},
"include_related": 10
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
query: '<string>',
effort: 'fast',
sources: {
data: {
count: 5,
include_contents: false,
mode: 'inline',
content_format: 'json_compact',
max_rows: 100,
node_ids: ['<string>'],
strict: false
},
web: {
count: 10,
include_contents: false,
include_domains: ['<string>'],
exclude_domains: ['<string>'],
snippet_max_chars: 10000,
highlights: false,
article_content_max_chars: 30000,
published_after: '2023-12-25',
published_before: '2023-12-25'
}
},
location: {latitude: 0, longitude: 0},
country_code: 'US',
locale: 'en-US',
timezone: '<string>',
output_settings: {image_dark_mode: true, force_refresh: false},
include_related: 10
})
};
fetch('https://tako.com/api/v3/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://tako.com/api/v3/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' => '<string>',
'effort' => 'fast',
'sources' => [
'data' => [
'count' => 5,
'include_contents' => false,
'mode' => 'inline',
'content_format' => 'json_compact',
'max_rows' => 100,
'node_ids' => [
'<string>'
],
'strict' => false
],
'web' => [
'count' => 10,
'include_contents' => false,
'include_domains' => [
'<string>'
],
'exclude_domains' => [
'<string>'
],
'snippet_max_chars' => 10000,
'highlights' => false,
'article_content_max_chars' => 30000,
'published_after' => '2023-12-25',
'published_before' => '2023-12-25'
]
],
'location' => [
'latitude' => 0,
'longitude' => 0
],
'country_code' => 'US',
'locale' => 'en-US',
'timezone' => '<string>',
'output_settings' => [
'image_dark_mode' => true,
'force_refresh' => false
],
'include_related' => 10
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$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://tako.com/api/v3/search"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"effort\": \"fast\",\n \"sources\": {\n \"data\": {\n \"count\": 5,\n \"include_contents\": false,\n \"mode\": \"inline\",\n \"content_format\": \"json_compact\",\n \"max_rows\": 100,\n \"node_ids\": [\n \"<string>\"\n ],\n \"strict\": false\n },\n \"web\": {\n \"count\": 10,\n \"include_contents\": false,\n \"include_domains\": [\n \"<string>\"\n ],\n \"exclude_domains\": [\n \"<string>\"\n ],\n \"snippet_max_chars\": 10000,\n \"highlights\": false,\n \"article_content_max_chars\": 30000,\n \"published_after\": \"2023-12-25\",\n \"published_before\": \"2023-12-25\"\n }\n },\n \"location\": {\n \"latitude\": 0,\n \"longitude\": 0\n },\n \"country_code\": \"US\",\n \"locale\": \"en-US\",\n \"timezone\": \"<string>\",\n \"output_settings\": {\n \"image_dark_mode\": true,\n \"force_refresh\": false\n },\n \"include_related\": 10\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
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://tako.com/api/v3/search")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"effort\": \"fast\",\n \"sources\": {\n \"data\": {\n \"count\": 5,\n \"include_contents\": false,\n \"mode\": \"inline\",\n \"content_format\": \"json_compact\",\n \"max_rows\": 100,\n \"node_ids\": [\n \"<string>\"\n ],\n \"strict\": false\n },\n \"web\": {\n \"count\": 10,\n \"include_contents\": false,\n \"include_domains\": [\n \"<string>\"\n ],\n \"exclude_domains\": [\n \"<string>\"\n ],\n \"snippet_max_chars\": 10000,\n \"highlights\": false,\n \"article_content_max_chars\": 30000,\n \"published_after\": \"2023-12-25\",\n \"published_before\": \"2023-12-25\"\n }\n },\n \"location\": {\n \"latitude\": 0,\n \"longitude\": 0\n },\n \"country_code\": \"US\",\n \"locale\": \"en-US\",\n \"timezone\": \"<string>\",\n \"output_settings\": {\n \"image_dark_mode\": true,\n \"force_refresh\": false\n },\n \"include_related\": 10\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://tako.com/api/v3/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"<string>\",\n \"effort\": \"fast\",\n \"sources\": {\n \"data\": {\n \"count\": 5,\n \"include_contents\": false,\n \"mode\": \"inline\",\n \"content_format\": \"json_compact\",\n \"max_rows\": 100,\n \"node_ids\": [\n \"<string>\"\n ],\n \"strict\": false\n },\n \"web\": {\n \"count\": 10,\n \"include_contents\": false,\n \"include_domains\": [\n \"<string>\"\n ],\n \"exclude_domains\": [\n \"<string>\"\n ],\n \"snippet_max_chars\": 10000,\n \"highlights\": false,\n \"article_content_max_chars\": 30000,\n \"published_after\": \"2023-12-25\",\n \"published_before\": \"2023-12-25\"\n }\n },\n \"location\": {\n \"latitude\": 0,\n \"longitude\": 0\n },\n \"country_code\": \"US\",\n \"locale\": \"en-US\",\n \"timezone\": \"<string>\",\n \"output_settings\": {\n \"image_dark_mode\": true,\n \"force_refresh\": false\n },\n \"include_related\": 10\n}"
response = http.request(request)
puts response.read_body{
"request_id": "<string>",
"cards": [
{
"card_id": "<string>",
"title": "<string>",
"description": "<string>",
"semantic_description": "<string>",
"webpage_url": "<string>",
"image_url": "<string>",
"embed_url": "<string>",
"sources": [
{
"source_name": "S&P Global",
"source_description": "<string>",
"url": "https://xignite.com",
"source_text": "<string>"
}
],
"methodologies": [
{
"methodology_name": "Where the Data Comes From - S&P Global",
"methodology_description": "Financial metrics standardized by S&P Global from company regulatory filings, press releases, and restatements."
}
],
"source_indexes": [],
"card_type": "<string>",
"content": {
"cost": 0,
"data": "<string>",
"records": [
{}
],
"dataset": {
"columns": [
{
"name": "<string>",
"unit": "<string>"
}
],
"rows": [
[
"<string>"
]
],
"total_rows": 123,
"truncated": true,
"ref": "<string>",
"sources": [
{
"name": "<string>",
"index": "data"
}
],
"provenance": "query"
},
"card_data": {},
"card_data_schema": {},
"url": "<string>",
"expires_at": "<string>",
"total_rows": 123,
"truncated": false,
"export_pricing": {
"baseline_usd": 123,
"row_cpm_usd": 123,
"free_rows": 123,
"max_rows_ceiling": 123
},
"manifest": [
{
"name": "<string>",
"metric": "<string>",
"entity": "<string>",
"unit": "<string>"
}
]
},
"exportable": false,
"relevance_score": 123,
"nodes": [
{
"id": "<string>",
"name": "<string>",
"description": "<string>"
}
],
"metric_definitions": [
{
"name": "<string>",
"definition": "<string>"
}
],
"data_freshness": {
"coverage_end": "2026",
"data_as_of": "2026-10-01",
"last_updated": "2026-07-14"
}
}
],
"web_results": [
{
"title": "<string>",
"url": "<string>",
"snippet": "<string>",
"source_name": "<string>",
"publish_date": "<string>",
"content": {
"cost": 0,
"data": "<string>",
"records": [
{}
],
"dataset": {
"columns": [
{
"name": "<string>",
"unit": "<string>"
}
],
"rows": [
[
"<string>"
]
],
"total_rows": 123,
"truncated": true,
"ref": "<string>",
"sources": [
{
"name": "<string>",
"index": "data"
}
],
"provenance": "query"
},
"card_data": {},
"card_data_schema": {},
"url": "<string>",
"expires_at": "<string>",
"total_rows": 123,
"truncated": false,
"export_pricing": {
"baseline_usd": 123,
"row_cpm_usd": 123,
"free_rows": 123,
"max_rows_ceiling": 123
},
"manifest": [
{
"name": "<string>",
"metric": "<string>",
"entity": "<string>",
"unit": "<string>"
}
]
},
"citation_number": 123
}
],
"usage": {
"total_cost_usd": 123,
"compute": {
"cost_usd": 123
},
"data": {
"cost_usd": 123,
"datasets": 123
}
},
"related": [
{
"query": "<string>",
"description": "<string>",
"node_ids": [
"<string>"
]
}
]
}{
"error_message": "<string>"
}{
"error_message": "<string>"
}{
"error_message": "<string>"
}{
"error_message": "<string>"
}Notes
- To authenticate, you’ll need a Tako API key. It’s best practice to store it as an environment variable to avoid hardcoding sensitive credentials in your code.
- Search returns Tako knowledge cards and web results for a natural language query — the results themselves, with no written answer on top. Use it when you want to render or post-process the cards and web results directly.
- Want a written answer over the same results? Use Answer — it takes the same request body and adds a synthesized
answer.
Choosing sources
sources controls where results come from — an object whose keys are the sources to search. A source is searched only if its key is present; omit sources to use the default (both sources, 5 results each):
{ "data": {} }— Tako knowledge cards from the curated knowledge graph.{ "web": {} }— web results.{ "data": {}, "web": {} }— both (same as omittingsources).
tako is accepted as a synonym for data.
Each source takes optional per-source settings: count (1–20, default 5) and include_contents (inline the underlying data). The curated-data source also supports defer_data_retrieval.
A result whose underlying data is downloadable includes a
content descriptor. Pass that result’s URL to Contents to download it — a CSV for a Tako card, or extracted text for a web page.Authorizations
Body
application/json
Shared request for POST /api/v3/search and POST /api/v1/answer.
Natural language search query.
Example:
"Intel vs Nvidia headcount since 2013"
Search effort level: 'fast' (default), 'instant', or 'deep'.
Available options:
fast, instant, deep Per-source settings. The search includes an index only if its key is present. Defaults to {data:{}, web:{}} (data and web, count 5 each). Tako accepts the legacy key 'tako' as a synonym for 'data'.
Show child attributes
Show child attributes
Optional coordinates of the end user. Resolves the location for implicit-location queries (for example, weather). An explicit location in the query overrides these coordinates.
Show child attributes
Show child attributes
ISO 3166-1 alpha-2 country code for localization.
BCP-47 locale tag for language and formatting.
IANA timezone (for example, 'America/New_York').
Settings that control the response shape.
Show child attributes
Show child attributes
Applies to POST /v3/search only. Return follow-up query suggestions in related. Omit this field to disable them. The value sets the maximum number of suggestions, from 1 to 20. POST /v1/answer accepts this field but ignores it: the answer response has no related field.
Required range:
1 <= x <= 20Response
Fast-pipeline search results (Tako cards + web results)
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Usage for one metered request. total_cost_usd is always present (the
total quoted charge). compute and data are the additive breakdown;
each appears only where it applies. total_cost_usd always equals the sum
of the components that appear.
Show child attributes
Show child attributes
Follow-up queries you can run next. Set include_related on the request to receive them. Absent when you did not ask for them, or when Tako found none.
Show child attributes
Show child attributes
⌘I