# 📘 Public Documentation ## 📌 Overview The HTML Table to JSON API converts any HTML table into clean, structured JSON. It is designed to handle real-world HTML, including: - malformed tables - irregular row structures - rowspan and colspan - nested tags - multiple tables - mixed content inside cells This API is perfect for scraping, automation, AI pipelines, and no-code platforms such as Zapier, Make, Bubble, Retool, and more. --- ## 🚀 Features - Convert any HTML table to JSON - Supports rowspan and colspan - Parses broken or poorly formatted HTML - Returns clean, normalized JSON - Works with multiple tables - Fast, reliable, and production-ready - Fully HTTPS secured --- ## 🧠 Use Cases - Web scraping and data extraction - Converting dashboard tables into datasets - Creating CSV/JSON from embedded HTML - Automating reports - Feeding LLMs or agents with structured data - Cleaning messy HTML before analysis - Extracting tables from emails, SaaS platforms, exports, back-office tools - Integrating with no-code workflows --- ## 🔧 Endpoint: POST /parse-table Convert an HTML table into structured JSON. 🔹 Request **URL** ``` POST https://api1.empirestats.net/parse-table ``` **HEADERS** ``` Content-Type: application/json ``` **BODY** ``` { "html": "

" } ``` --- ### 📥 **Response Example (Success)** ```json { "rows": [ [ { "text": "A", "rowspan": 1, "colspan": 1 }, { "text": "B", "rowspan": 1, "colspan": 1 } ] ] } ``` ### Response Example (No Table Found) ```json { "error": "No table element found" } ``` --- ## 🧪 **cURL Example** ```bash curl -X POST https://api1.empirestats.net/parse-table -H "Content-Type: application/json" -d '{"html":"

"}' ``` ## 🟦 JavaScript Example ```javascript fetch("https://api1.empirestats.net/parse-table", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ html: "

" }) }) .then(r => r.json()) .then(console.log); ``` ## 🐍 **Python Example** ```python import requests url = "https://api1.empirestats.net/parse-table" payload = {"html": "

"} res = requests.post(url, json=payload) print(res.json()) ``` ## ⚠️ **Error Cases** ### Invalid JSON ```json {"detail": "JSON decode error"} ``` ### Missing html field ```json { "detail": [ { "loc": ["body", "html"], "msg": "field required", "type": "value_error.missing" } ] } ``` ### No table in HTML ```json {"error": "No table element found"} ``` ---- ## 🛡 Data Handling The API processes all HTML content in memory only. No data is logged, stored, cached or shared. Do not send personal or sensitive content. ## Limitations - JavaScript is not executed - Only static HTML `` elements are supported - Very large HTML documents may impact performance - Styling, CSS and attributes unrelated to table structure are ignored