Skip to main content
Using an AI assistant? Install the Cala skill and your agent will know how to use Cala out of the box — no extra prompting needed.
npx skills add cala-ai/cala-skill
Learn more

​
Create your API key

Get an API key to authenticate your requests. Go to our Console and create a new API key.

Get Cala's API key

Create a free Cala account and get your API key.

​
Make your first request

Both endpoints accept the same input — the difference is how they respond. Send a Cala QL expression (or a natural-language question) and choose the output shape you need. 
import requests

url = "https://api.cala.ai/v1/knowledge/query"

query = "startups.location=Spain.funding>10M.funding<50M"
payload = { "input": query }
headers = {
    "X-API-KEY": "YOUR_API_KEY",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
Same input, two output shapes.

​
Get a Structured Answer

POST /v1/knowledge/query returns JSON rows — ready for programmatic use. 
[
  { "name": "Luzia", "funding": "13M", "location": "Spain" },
  { "name": "Nomad Solar", "funding": "15M", "location": "Spain" },
  { "name": "Embat", "funding": "21.5M", "location": "Spain" },
  { "name": "Matteco", "funding": "16M+", "location": "Spain" },
  { "name": "Exoticca", "funding": "25.2M", "location": "Spain" },
  { "name": "Multiverse Computing", "funding": "12.5M", "location": "Spain" }
]

​
Get a Natural-Language Answer

POST /v1/knowledge/search returns a succinct, sourced answer in markdown. 
## Spanish Startups (€10M–€50M funding)

**Luzia** — AI assistant, €13M raised.
**Nomad Solar** — Solar energy, €15M raised.
**Embat** — Treasury management, €21.5M raised.
**Matteco** — Green hydrogen materials, €16M+ raised.
**Exoticca** — Travel tech, €25.2M raised.
**Multiverse Computing** — Quantum computing, €12.5M raised.
No parsing. No deduplication. No hallucinated data. Verified, sourced, deterministic.

​
Next steps

That’s it! You can now start using Cala to build your own applications. Deep dive into the available endpoints, params and responses in our API Reference section.