Skip to main content

​
Welcome

​
About Snow Leopard

Snow Leopard is an AI-powered data retrieval platform that helps you build business-critical AI Agents using your enterprise data on-demand, with real-time retrieval from structured data sources (SQL databases, data warehouses, etc.). No MCP setup, no ETL, and no iteration for weeks/months on context engineering. Zero to ad-hoc data retrieval in minutes!

​
How it works

  1. Natural Language Input: Ask questions about your data in plain English
  2. Intelligent Routing: Snow Leopard creates a retrieval plan in real-time for what data is needed to answer your question
  3. Live Retrieval: Snow Leopard generates native SQL queries (or API calls) on-demand and fetches live data directly from the source(s)
  4. Agent-ready Response: Returns live data in JSON-format for agent interactions, and can also provide natural language responses
  5. Response Summarization: Provides clear, actionable insights from the retrieved data

​
Why Snow Leopard?

  • Empower your AI Agents and agentic workflows with your enterprise data in real-time without ETL and pre-defined pipelines
  • Access business data locked in databases and API systems without weeks and months of setup and iteration
  • Get 90+% accurate data retrieval out of the box for critical business workflows
  • No MCP setup or tuning required

​
API Documentation

This documentation is specific to the Snow Leopard Playground. The Playground is free to use and allows you to get a sense of Snow Leopard. Get started by uploading your own SQLite datafile. See our FAQ for more details on the Playground, supported datatypes etc. There are currently multiple ways of interacting with the Snow Leopard API:
  1. Python SDK (pypi)
  2. TypeScript SDK (npm)
  3. REST endpoints

​
Python SDK

Available on pypi 
from snowleopard import SnowLeopardPlaygroundClient

client = SnowLeopardPlaygroundClient(api_key="{api_key}")
client.retrieve(
    datafile_id="{datafile_id}",
    user_query="How many superheroes are there?"
)

​
TypeScript SDK

Availabile on npm 
import { SnowLeopardPlaygroundClient } from '@snowleopard-ai/client';


const client = new SnowLeopardPlaygroundClient({
    apiKey: 'your-api-key'
});

const response = await client.retrieve(
    'your-datafile-id',
    'How many superheroes are there?'
);

console.log(response.data);
await client.close();

​
REST API

curl --request POST \
  --url https://api.snowleopard.ai/datafiles/{datafile_id}/retrieve \
  --header 'Authorization: Bearer {api_key}' \
  --header 'Content-Type: application/json' \
  --data '{"userQuery": "How many superheroes are there?"}'

​
Getting Started

To build AI agents on Snow Leopard’s Playground APIs you need to:
  1. Create API keys for authentication
  2. Get the Playground Datafile ID for the SQLite database you want to use with your agent
  3. Use our SDKs or the API directly
See below for details.

​
Authentication

All API endpoints are authenticated using API Keys, also known as Bearer Tokens. You can generate a key/token from your Snow Leopard account page.
Generate a new API Key

​
Getting your Datafile ID

Don’t have your own data? Use one of our sample datasets to get started.
To retrieve your datafile id, find the desired SQLite file on your datafiles page and click the Copy ID button in the File ID column. This will copy the file ID into your system buffer, which you can then use in the API calls to fetch live data from the SQLite datafile.

​
Using the API

Snow Leopard exposes two REST endpoints: Retrieve and Response.

​
Retrieve

Retrieve is primarily for developers building AI agents that needs to retrieve data from a database directly. It takes a natural language question (usually from the user or the agent) and returns the required data in an LLM-friendly JSON object. Behind the scenes, Snow Leopard:
  • creates a retrieval plan in real time for the data needed to answer your question
  • builds a SQL query on-demand, and
  • executes that SQL query on the database to retrieve data needed
The endpoint returns both the retrieved data and the generated SQL query for transparency. See the Retrieve API endpoint for code examples and more details.

​
Response

Response is a conversational-AI-focused endpoint. It behaves like Retrieve, but subsequently sends the retrieved data to an LLM for summarization and natural language response generation. This endpoint also returns a JSON object with the SQL query, the data retrieved, and a natural language response that summarizes the retrieved data and answers the original question. This endpoint helps you build conversational BI agents easily and quickly. See the Response API endpoint for code examples and more details.