# 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-11).

Fetches a webpage and extracts all HTML tables from it, returning structured rows, columns, and titles for each table found.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/html-tables?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-html-table-extractor-865a4f4e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_thrj--KzEdxvn2Bz4Oa6t

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-865a4f4e -d '<json body>'
```

Example prompt: Can you extract all the HTML tables from https://en.wikipedia.org/wiki/List_of_countries_by_GDP_(nominal) and give me the data as structured JSON rows and columns?

## When to prefer this

Choose this endpoint when you need to extract structured tabular data directly from a public webpage — especially Wikipedia, government statistics pages, or financial data portals — without writing your own scraper. It's ideal for one-off or pay-per-call data needs where setting up a full scraping pipeline isn't worth the overhead. Use the index parameter when you know which specific table you want to avoid processing noise from other tables on the page.

## Known failure modes

- URL is unreachable or returns a non-200 HTTP status — no tables returned
- Page contains no HTML tables — empty tables array
- Specified table index does not exist on the page — empty or null result
- Page requires JavaScript rendering — static HTML scraper may miss dynamically loaded tables
- Rate-limited or blocked by the target website — request may fail or return partial data

## 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

A JSON object containing an array of tables found on the page. Each table includes its index, title, column headers, number of rows, and an array of row objects (key-value pairs matching column names to cell values). Also returns the final resolved URL after any redirects and the total count of tables on the page.

## 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"
      },
      "index": {
       "type": "integer",
       "description": "Only this table"
      },
      "max_rows": {
       "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": {
      "tables": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "rows": {
          "type": [
           "array",
           "null"
          ],
          "items": {
           "type": [
            "null",
            "object"
           ],
           "properties": {
            "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"
             ]
            }
           }
          }
         },
         "index": {
          "type": [
           "null",
           "number"
          ]
         },
         "title": {
          "type": [
           "null",
           "string"

… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tables": [
   {
    "rows": [
     {
      "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"
     }
    ],
    "index": 2,
    "title": "GDP forecast or estimate (million US$) by country",
    "columns": [
     "Country/Territory",
     "IMF ( 2026 ) [ 1 ]"
    ],
    "num_rows": 222
   },
   {
    "rows": [
     {
      "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 ]"
     }
    ],
    "index": 3,
    "title": "GDP forecast or estimate (million US$) by region or grouping",
    "columns": [
     "Regional groupings",
     "IMF ( 2026 ) [ 1 ]"
    ],
    "num_rows": 13
   }
  ],
  "url_final": "https://en.wikipedia.org/wiki/List_of_countries_by_GDP_(nominal)",
  "tables_on_page": 8
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-html-table-extractor-865a4f4e/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)