# Vextorium HTML Table Extractor

> Vextorium HTML Table Extractor is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-13).

Fetches a web page URL and extracts all HTML tables as structured JSON with headers, rows, and merged cell handling, skipping layout-only tables.

## Facts

- Endpoint: POST https://api.vextorium.com/extraer-tablas-html-pago?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-html-table-extractor-c48d04bb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oU-IXmOGkHRq81ssVsPla

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vextorium-html-table-extractor-c48d04bb -d '<json body>'
```

Example prompt: Can you extract all the tables from this Wikipedia page on country GDP rankings and give me the data as structured JSON? https://en.wikipedia.org/wiki/List_of_countries_by_GDP_(nominal)

## When to prefer this

Choose this endpoint when you need to extract structured tabular data from any public web page — especially Wikipedia lists, government statistics pages, or public financial reports — without writing custom scraping code. It handles merged cells and skips layout tables automatically, making it ideal for data pipelines that need clean row/column JSON from HTML. Prefer this over generic web scrapers when the target content is specifically in HTML table format and you need it ready-to-analyze with minimal post-processing.

## Known failure modes

- URL is unreachable or returns non-200 status — empty tables array or error response
- Page has no HTML tables — returns empty tables array
- Page uses JavaScript-rendered tables (client-side only) — tables may not be detected
- Invalid or malformed URL input — request fails validation
- Table index (indice) out of range — returns empty or null result
- Rate limiting or timeout on very large pages with many tables

## How this service works

Extract the HTML tables of a web page as JSON (headers and rows, merged cells handled, layout tables skipped): Wikipedia lists, public statistics or reports, ready to analyze.

## Output

Returns a JSON object with an array of extracted tables, each containing: table index, title (if present), column headers, rows as arrays of key-value objects, and row count. Also returns the final resolved URL and total number of tables found on the page. Layout tables and navigation tables are automatically skipped. Merged cells are handled and normalized.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string"
      },
      "indice": {
       "type": "integer",
       "description": "Only this table"
      },
      "max_filas": {
       "type": "integer"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "tablas": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "filas": {
          "type": [
           "array",
           "null"
          ],
          "items": {
           "type": [
            "null",
            "object"
           ],
           "properties": {
            "Nominal": {
             "type": [
              "string",
              "null"
             ]
            },
            "Country/Territory": {
             "type": [
              "null",
              "string"
             ]
            },
            "IMF ( 2026 ) [ 1 ]": {
             "type": [
              "null",
              "string"
             ]
            },
            "Regional groupings": {
             "type": [
              "null",
              "string"
             ]
            },
            "World Bank (2024) [ 6 ]": {
             "type": [
              "null",
              "string"
             ]
            },
            "World Bank (2025) [ 6 ]": {
             "type": [
              "null",
              "string"
             ]
            },
            "United Nations (2024) [ 7 ]": {
             "type": [
              "null",
              "string"
             ]
            },
            "v t e Lists of countries by GDP rankings": {
             "type": [
           
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tablas": [
   {
    "filas": [
     {
      "Country/Territory": "World",
      "IMF ( 2026 ) [ 1 ]": "126,295,331",
      "World Bank (2025) [ 6 ]": "118,350,166",
      "United Nations (2024) [ 7 ]": "111,565,144"
     },
     {
      "Country/Territory": "United States",
      "IMF ( 2026 ) [ 1 ]": "32,383,920",
      "World Bank (2025) [ 6 ]": "30,769,700",
      "United Nations (2024) [ 7 ]": "29,298,000"
     }
    ],
    "indice": 2,
    "titulo": "GDP forecast or estimate (million US$) by country",
    "columnas": [
     "Country/Territory",
     "IMF ( 2026 ) [ 1 ]"
    ],
    "num_filas": 222
   },
   {
    "filas": [
     {
      "IMF ( 2026 ) [ 1 ]": "126,295,331",
      "Regional groupings": "World",
      "World Bank (2024) [ 6 ]": "110,983,000"
     },
     {
      "IMF ( 2026 ) [ 1 ]": "73,813,712",
      "Regional groupings": "Advanced Economies/High Income [ r 1 ]",
      "World Bank (2024) [ 6 ]": "71,321,000 [ r 2 ]"
     }
    ],
    "indice": 3,
    "titulo": "GDP forecast or estimate (million US$) by region or grouping",
    "columnas": [
     "Regional groupings",
     "IMF ( 2026 ) [ 1 ]"
    ],
    "num_filas": 13
   }
  ],
  "url_final": "https://en.wikipedia.org/wiki/List_of_countries_by_GDP_(nominal)",
  "tablas_en_pagina": 8
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-html-table-extractor-c48d04bb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)