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

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