Developer Documentation
Query verified datasets programmatically, build data connectors, or connect an AI agent to structured data. Everything runs through one REST API plus an MCP server.
The four documentation files
All four are plain text or JSON, readable without JavaScript, without an account and without a key.
- Agent guide (
/api/v1/guide): Agent quick reference. Endpoints, filter and sort syntax, response shapes, worked examples.
- OpenAPI spec (
/api/v1/openapi.json): Machine-readable OpenAPI 3 spec of every documented path.
- Quickstart (
/api/v1/apps/quickstart): Build your first data app on autario, with copy-paste calls.
- Sandbox SDK (
/api/v1/sandbox-sdk.js): The single-file browser SDK a sandboxed app loads to read data through the gated bridge.
Data API v1
The v1 API lets you discover, inspect and query any dataset you have access to. It is written for human developers and for AI agents. Public endpoints need no authentication; private endpoints use a key and secret pair from your account.
Base URL: https://autario.com/api/v1
Authentication
Private endpoints take an x-api-key and an x-api-secret header. Create the pair under Account, tab API Keys. The secret is shown once at creation.
Public endpoints
No authentication. Rate limit 120 requests per minute per IP; every response carries X-RateLimit-Limit and X-RateLimit-Remaining headers. Search and list datasets, read a schema, query rows with filters, sorting, field selection, server-side aggregations and summary-only reads.
Response shapes
- Public data reads at /public/datasets/:id/data return { total, limit, offset, data }.
- Private queries at /datasets/:id/query return { meta: { total, returned, limit, offset }, data }.
MCP integration
Connect Claude, ChatGPT or any MCP client to autario over the remote endpoint at https://autario.com/mcp, or run the autario-mcp package locally with an API key. Roughly 35 tools cover search, schema reads, queries, statistics and chart publishing.
Build a data app
Data apps run in a sandboxed iframe on autario and read data through a gated bridge, so your code never holds a key. The quickstart walks through the whole path from an anonymous first read to submission. Build a data app on autario
Every response returns an X-Request-ID header. Quote it when reporting a bug and the server logs can be correlated to your exact request.