Analytics Toolkit¶

AI-powered data analysis in one API. Upload datasets from remote URLs, run natural-language queries, generate visualizations, and bundle multiple data sources into a single queryable dataset.

Base URL¶

https://analytics.toolkitapi.io/v1/

Full interactive reference: analytics.toolkitapi.io/documentation

Quick Start¶

Ask a natural-language question about a dataset:

curl -X POST "https://analytics.toolkitapi.io/v1/analyze" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"data_url": "https://example.com/data.csv", "file_type": "csv", "prompt": "What are the top 5 values?"}'

import requests

r = requests.post(
    "https://analytics.toolkitapi.io/v1/analyze",
    headers={"X-API-Key": "YOUR_KEY"},
    json={
        "data_url": "https://example.com/data.csv",
        "file_type": "csv",
        "prompt": "What are the top 5 values?",
    },
)
print(r.json()["summary"])

const r = await fetch("https://analytics.toolkitapi.io/v1/analyze", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    data_url: "https://example.com/data.csv",
    file_type: "csv",
    prompt: "What are the top 5 values?",
  }),
});
const data = await r.json();
console.log(data.summary);

Browse all analytics endpoints →

Categories¶

Data Sources¶

Endpoint	Description
`POST /v1/analyze`	Analyze a dataset — upload a CSV, JSON, Parquet, or Excel URL and receive an AI-generated summary, inferred schema, and preview rows
`GET /v1/datasets/{dataset_id}/schema`	Retrieve the inferred schema and column metadata for a previously analyzed dataset

Query & Analysis¶

Endpoint	Description
`POST /v1/save`	Save a named query definition for later re-execution
`POST /v1/query/{query_id}`	Execute a saved query against a dataset
`GET /v1/jobs/{job_id}`	Poll the status and results of an asynchronous analytics job

Visualization¶

Endpoint	Description
`POST /v1/visualize`	Render a chart from a dataset; returns Plotly JSON or a hosted PNG/SVG
`POST /v1/validate-chart`	Validate a chart configuration against the schema without rendering

Export & Bundles¶

Endpoint	Description
`POST /v1/datasets/bundle`	Join 2–5 remote data sources into a single named dataset

Example: Analyze a Dataset¶

curl -X POST "https://analytics.toolkitapi.io/v1/analyze" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/data/sales.csv",
    "format": "csv"
  }'

Example: Visualize Data¶

curl -X POST "https://analytics.toolkitapi.io/v1/visualize" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "dataset_id": "ds_abc123",
    "chart_type": "bar",
    "x": "month",
    "y": "revenue"
  }'

Language and Transliteration

Data Sources