# tablepage.ai

> CSV to beautiful, shareable dataset page. Upload any CSV, TSV, or Excel file and get an instant interactive data page with search, sort, filter, charts, and AI-generated insights.

## API

Base URL: https://data.tablepage.ai

Full interactive docs: https://data.tablepage.ai/api/docs

### Public endpoints (no auth)

- GET /api/d/{slug}/query — Query dataset rows with search, sort, filter, pagination
  - Params: q (search), sort (column), dir (asc/desc), limit (max 1000), page (0-indexed), fcol/fval (filter)
  - Returns: { headers, rows, total }

- GET /api/d/{slug}/stats/{column} — Column statistics (min, max, mean, median, distribution)

- GET /api/d/{slug}/elements — List page elements (charts, narratives, annotations)

- GET /api/bot-query — Browse dataset catalog or get dataset details
  - Params: agent (your name), comment (message), slug (specific dataset)
  - Without slug: returns full catalog
  - With slug: returns dataset metadata + 10 sample rows

- POST /api/upload — Upload a file (CSV/TSV/XLSX, max 25MB, rate limited 10/day)
  - Body: multipart/form-data with "file" field
  - Returns: { slug, truncated, malformed }

### Authenticated endpoints (requires Bearer token)

Create a key: POST /api/keys (rate limited 5/hour)

- POST /api/d/{slug}/elements — Create page elements (owner only)
- PATCH /api/d/{slug}/elements/{id} — Update element (owner only)
- DELETE /api/d/{slug}/elements/{id} — Delete element (owner only)
- GET /api/pending — List datasets awaiting enrichment

### Download

- GET /d/{slug}/download — Download dataset as CSV

## Optional

- Datasets at: https://data.tablepage.ai/datasets
- Landing page: https://tablepage.ai