Answer

Answer

curl --request POST \
  --url https://tako.com/api/v1/answer \
  --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/v1/answer"

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/v1/answer', 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/v1/answer",
  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/v1/answer"

	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/v1/answer")
  .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/v1/answer")

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

{
  "answer": "<string>",
  "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
    }
  }
}

{
  "error_message": "<string>"
}

{
  "error_message": "<string>"
}

{
  "error_message": "<string>"
}

{
  "error_message": "<string>"
}

POST

answer

Answer

curl --request POST \
  --url https://tako.com/api/v1/answer \
  --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/v1/answer"

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/v1/answer', 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/v1/answer",
  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/v1/answer"

	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/v1/answer")
  .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/v1/answer")

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

{
  "answer": "<string>",
  "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
    }
  }
}

{
  "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.
Answer retrieves the same results as Search and adds a written answer grounded in them. It takes the same request body as Search — the response adds the synthesized answer alongside the cards and web results.
Use Answer when you want prose to show a user; use Search when you only need the underlying cards and web results.

Answer replaces the legacy Grounding endpoint. New integrations should use POST /v1/answer.

Choosing sources

sources controls where the answer is grounded — an object whose keys are the sources to ground in. A source is used only if its key is present; omit sources to use the default (both sources, 5 results each):

{ "data": {} } — grounded in Tako’s curated knowledge graph.
{ "web": {} } — grounded in the live web.
{ "data": {}, "web": {} } — both (same as omitting sources).

The legacy value 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.

Authorizations

X-API-Key

string

header

required

Body

application/json

Shared request for POST /api/v3/search and POST /api/v1/answer.

query

string

required

Natural language search query.

Example:

"Intel vs Nvidia headcount since 2013"

effort

enum<string>

default:fast

Search effort level: 'fast' (default), 'instant', or 'deep'.

Available options:

fast,

instant,

deep

sources

Sources · object

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

location

GeoLocation · object | null

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

country_code

string

default:US

ISO 3166-1 alpha-2 country code for localization.

locale

string

default:en-US

BCP-47 locale tag for language and formatting.

timezone

string | null

IANA timezone (for example, 'America/New_York').

output_settings

OutputSettings · object | null

Settings that control the response shape.

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 <= 20

Response

Synthesized answer grounded in Tako results, web results, or both

Response for POST /api/v1/answer: the synthesized answer plus the retrieval behind it.

answer

string

required

Synthesized text answer.

request_id

string

required

cards

TakoCard · object[]

Tako cards backing the answer; cards[0] is the lead card — the best one to show alongside the answer.

Show child attributes

web_results

WebResult · object[]

Show child attributes

usage

Usage · object | null

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

⌘I

Getting Started

Build with Tako

API Reference

Integrations

Additional Resources

Notes

Choosing sources

Authorizations

Body

Response

​Notes

​Choosing sources

Authorizations

Body

Response

Notes

Choosing sources