Quickstart

curl -X POST https://tako.com/api/v1/answer \
  -H "X-API-Key: $TAKO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "How has Luka Dončić'\''s points per game trended this season?"
  }'

import os
from tako import Configuration, SearchRequest
from tako.lib import Tako

config = Configuration()
config.api_key["apiKey"] = os.environ["TAKO_API_KEY"]
client = Tako(config)

response = client.answer(SearchRequest(query="How has Luka Dončić's points per game trended this season?"))
print(response.answer)
for card in response.cards or []:
    print(card.title, card.webpage_url)

import { Tako } from "tako-sdk";

const tako = new Tako({ apiKey: process.env.TAKO_API_KEY! });

const response = await tako.answer({ query: "How has Luka Dončić's points per game trended this season?" });
console.log(response.answer);
for (const card of response.cards ?? []) {
  console.log(card.title, card.webpage_url);
}

# 1. Dispatch — returns 202 with {"run_id": "...", "status": "queued"}.
curl -X POST https://tako.com/api/v1/agent/answer/runs \
  -H "X-API-Key: $TAKO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Which of the Magnificent Seven tech companies has grown revenue the fastest over the past five years?"
  }'

# 2. Poll with the run_id until status is "completed" or "failed".
curl https://tako.com/api/v1/agent/answer/runs/RUN_ID \
  -H "X-API-Key: $TAKO_API_KEY"

import os
import time
from tako import Configuration, AnswerAgentRunRequest
from tako.lib import Tako

config = Configuration()
config.api_key["apiKey"] = os.environ["TAKO_API_KEY"]
client = Tako(config)

run = client.agent.answer.run(
    AnswerAgentRunRequest(query="Which of the Magnificent Seven tech companies has grown revenue the fastest over the past five years?")
)

# Runs can take minutes — poll on a short interval until terminal.
while run.status not in ("completed", "failed"):
    time.sleep(3)
    run = client.agent.answer.get(run.run_id)

print(run.result.answer)

import { Tako } from "tako-sdk";

const tako = new Tako({ apiKey: process.env.TAKO_API_KEY! });

let run = await tako.agent.answer.run({
  query: "Which of the Magnificent Seven tech companies has grown revenue the fastest over the past five years?",
});

// Runs can take minutes — poll on a short interval until terminal.
while (run.status !== "completed" && run.status !== "failed") {
  await new Promise((r) => setTimeout(r, 3000));
  run = await tako.agent.answer.get(run.run_id);
}

console.log(run.result?.answer);

# 1. OPTIONAL: resolve the entity and the metric to graph node ids (no credits).
ENTITY_ID=$(curl -s -G https://tako.com/api/v1/graph/search \
  -H "X-API-Key: $TAKO_API_KEY" \
  --data-urlencode "q=Palantir Technologies" \
  --data-urlencode "types=entity" | jq -r '.results[0].id')

METRIC_ID=$(curl -s -G https://tako.com/api/v1/graph/search \
  -H "X-API-Key: $TAKO_API_KEY" \
  --data-urlencode "q=federal contract obligations" \
  --data-urlencode "types=metric" | jq -r '.results[0].id')

# 2. Pin both ids into Search. strict returns only cards matching a pinned node.
CARD_URL=$(curl -s -X POST https://tako.com/api/v3/search \
  -H "X-API-Key: $TAKO_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"query\": \"Palantir federal contract obligations\",
    \"sources\": {\"data\": {\"node_ids\": [\"$ENTITY_ID\", \"$METRIC_ID\"], \"strict\": true}}
  }" | jq -r '.cards[0].webpage_url')

# 3. Contents downloads the exact numbers behind the card.
curl -X POST https://tako.com/api/v1/contents \
  -H "X-API-Key: $TAKO_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"url\": \"$CARD_URL\", \"mode\": \"inline\"}"

import os
from tako import Configuration, SearchRequest, Sources, DataSourceSettings, ContentsRequest
from tako.lib import Tako

config = Configuration()
config.api_key["apiKey"] = os.environ["TAKO_API_KEY"]
client = Tako(config)

# 1. OPTIONAL: resolve the entity and the metric to graph node ids (no credits).
entity = client.graph_search("Palantir Technologies", types="entity").results[0]
metric = client.graph_search("federal contract obligations", types="metric").results[0]

# 2. Pin both ids into Search. strict returns only cards matching a pinned node.
results = client.search(
    SearchRequest(
        query="Palantir federal contract obligations",
        sources=Sources(
            data=DataSourceSettings(node_ids=[entity.id, metric.id], strict=True)
        ),
    )
)
card = results.cards[0]

# 3. Contents downloads the exact numbers behind it — feed the CSV to your agent.
contents = client.contents(ContentsRequest(url=card.webpage_url, mode="inline"))
print(contents.contents[0].data)

import { Tako } from "tako-sdk";

const tako = new Tako({ apiKey: process.env.TAKO_API_KEY! });

// 1. OPTIONAL: resolve the entity and the metric to graph node ids (no credits).
const entity = (await tako.graphSearch({ q: "Palantir Technologies", types: "entity" })).results[0];
const metric = (await tako.graphSearch({ q: "federal contract obligations", types: "metric" })).results[0];

// 2. Pin both ids into Search. strict returns only cards matching a pinned node.
const results = await tako.search({
  query: "Palantir federal contract obligations",
  sources: { data: { node_ids: [entity.id, metric.id], strict: true } },
});
const card = results.cards![0];

// 3. Contents downloads the exact numbers behind it — feed the CSV to your agent.
const contents = await tako.contents({ url: card.webpage_url!, mode: "inline" });
console.log(contents.contents![0].data);