HTML to JSON

PyPI - Downloads

Convert HTML and/or HTML tables to JSON.

If this library is useful to you or if you're using this library for a business - please consider sponsoring me. Even a small sponsorship allows me to prioritize work on this library and ongoing maintainance. Thanks!

Installation

pip install html-to-json

Usage

HTML to JSON

import html_to_json

html_string = """<head>
    <title>Test site</title>
    <meta charset="UTF-8"></head>"""
output_json = html_to_json.convert(html_string)
print(output_json)

When calling the html_to_json.convert function, you can choose to not capture the text values from the html by passing in the key-word argument capture_element_values=False. You can also choose to not capture the attributes of the elements by passing capture_element_attributes=False into the function.

Example

Example input:

<head>
    <title>Floyd Hightower's Projects</title>
    <meta charset="UTF-8">
    <meta name="description" content="Floyd Hightower&#39;s Projects">
    <meta name="keywords" content="projects,fhightower,Floyd,Hightower">
</head>

Example output:

{
    "head": [
    {
        "title": [
        {
            "_value": "Floyd Hightower's Projects"
        }],
        "meta": [
        {
            "_attributes":
            {
                "charset": "UTF-8"
            }
        },
        {
            "_attributes":
            {
                "name": "description",
                "content": "Floyd Hightower's Projects"
            }
        },
        {
            "_attributes":
            {
                "name": "keywords",
                "content": "projects,fhightower,Floyd,Hightower"
            }
        }]
    }]
}

HTML Tables to JSON

In addition to converting HTML to JSON, this library can also intelligently convert HTML tables to JSON.

Currently, this library can handle three types of tables:

A. Those with table headers in the first row B. Those with table headers in the first column C. Those without table headers

Tables of type A and B are diagrammed below:

This package can handle tables with the headers in the first row or headers in the first column

Example

This code:

import html_to_json

html_string = """<table>
    <tr>
        <th>#</th>
        <th>Malware</th>
        <th>MD5</th>
        <th>Date Added</th>
    </tr>

    <tr>
        <td>25548</td>
        <td><a href="/stats/DarkComet/">DarkComet</a></td>
        <td><a href="/config/034a37b2a2307f876adc9538986d7b86">034a37b2a2307f876adc9538986d7b86</a></td>
        <td>July 9, 2018, 6:25 a.m.</td>
    </tr>

    <tr>
        <td>25547</td>
        <td><a href="/stats/DarkComet/">DarkComet</a></td>
        <td><a href="/config/706eeefbac3de4d58b27d964173999c3">706eeefbac3de4d58b27d964173999c3</a></td>
        <td>July 7, 2018, 6:25 a.m.</td>
    </tr></table>"""
tables = html_to_json.convert_tables(html_string)
print(tables)

will produce this output:

[
    [
        {
            "#": "25548",
            "Malware": "DarkComet",
            "MD5": "034a37b2a2307f876adc9538986d7b86",
            "Date Added": "July 9, 2018, 6:25 a.m."
        }, {
            "#": "25547",
            "Malware": "DarkComet",
            "MD5": "706eeefbac3de4d58b27d964173999c3",
            "Date Added": "July 7, 2018, 6:25 a.m."
        }
    ]
]

Preserving nested tags in table cells

By default, convert_tables() only captures the text of each cell, so nested tags (such as <a> elements) and their attributes are dropped. To keep them, pass one of the following keyword arguments:

record_html=True — capture each cell's inner HTML as a string.
record_children=True — capture each cell's children as JSON, using the same structure produced by convert().

If both are given, record_html takes precedence.

For example, html_to_json.convert_tables(html_string, record_html=True) on the table above produces:

[
    [
        {
            "#": "25548",
            "Malware": "<a href=\"/stats/DarkComet/\">DarkComet</a>",
            "MD5": "<a href=\"/config/034a37b2a2307f876adc9538986d7b86\">034a37b2a2307f876adc9538986d7b86</a>",
            "Date Added": "July 9, 2018, 6:25 a.m."
        }, {
            "#": "25547",
            "Malware": "<a href=\"/stats/DarkComet/\">DarkComet</a>",
            "MD5": "<a href=\"/config/706eeefbac3de4d58b27d964173999c3\">706eeefbac3de4d58b27d964173999c3</a>",
            "Date Added": "July 7, 2018, 6:25 a.m."
        }
    ]
]

while html_to_json.convert_tables(html_string, record_children=True) produces:

[
    [
        {
            "#": [{"_value": "25548"}],
            "Malware": [{"a": [{"_attributes": {"href": "/stats/DarkComet/"}, "_value": "DarkComet"}]}],
            "MD5": [{"a": [{"_attributes": {"href": "/config/034a37b2a2307f876adc9538986d7b86"}, "_value": "034a37b2a2307f876adc9538986d7b86"}]}],
            "Date Added": [{"_value": "July 9, 2018, 6:25 a.m."}]
        }, {
            "#": [{"_value": "25547"}],
            "Malware": [{"a": [{"_attributes": {"href": "/stats/DarkComet/"}, "_value": "DarkComet"}]}],
            "MD5": [{"a": [{"_attributes": {"href": "/config/706eeefbac3de4d58b27d964173999c3"}, "_value": "706eeefbac3de4d58b27d964173999c3"}]}],
            "Date Added": [{"_value": "July 7, 2018, 6:25 a.m."}]
        }
    ]
]

Development

This project uses uv for dependency and environment management. Python 3.10+ is required.

uv sync
uv run pytest
./scripts/lint.sh

Credits

This package was created with Cookiecutter and fhightower's Python project template.

Release files for html-to-json 3.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for html-to-json 3.0.0
File	Size	Uploaded
html_to_json-3.0.0.tar.gz	542.6 kB	May 13, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for html-to-json 3.0.0
File	Interpreter	ABI	Platform	Reset
html_to_json-3.0.0-py3-none-any.whl 7.4 kB May 13, 2026	Python 3	none	any	Details

Total release size: 550.0 kB

Release files / html_to_json-3.0.0.tar.gz

Download URL	html_to_json-3.0.0.tar.gz
Size	542.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`1f58229aff7ca10f510415280c466c637e4a895885dd8aac6838f389254e795a`
BLAKE2b-256 checksum How to use checksums	`949a865878032c9a1b30ee172a6d5eb036645179619320c96e7af3f08d30f0b6`
Upload date	May 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/fhightower/html-to-json
Publishing commit: github.com/fhightower/html-to-json/tree/0202da7421aa6e12dc22e0684957730f31ba9b19

Workflow

Publishing configuration: github.com/fhightower/html-to-json/blob/0202da7421aa6e12dc22e0684957730f31ba9b19/.github/workflows/python-publish.yml
Publishing logs: github.com/fhightower/html-to-json/actions/runs/25793356977/attempts/1

Artifact

Subject: html_to_json-3.0.0.tar.gz
SHA-256 checksum: 1f58229aff7ca10f510415280c466c637e4a895885dd8aac6838f389254e795a Verifying attestations

Release files / html_to_json-3.0.0-py3-none-any.whl

Download URL	html_to_json-3.0.0-py3-none-any.whl
Size	7.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`5ea910fc6d9609f5e1a04b2fd13a06c462a4d144ae64bfd49103d41125e244d3`
BLAKE2b-256 checksum How to use checksums	`defc9b77c9aaf53076d49fada65f12db2dc688b4c359cf82cb89d608413613d3`
Upload date	May 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/fhightower/html-to-json
Publishing commit: github.com/fhightower/html-to-json/tree/0202da7421aa6e12dc22e0684957730f31ba9b19

Workflow

Publishing configuration: github.com/fhightower/html-to-json/blob/0202da7421aa6e12dc22e0684957730f31ba9b19/.github/workflows/python-publish.yml
Publishing logs: github.com/fhightower/html-to-json/actions/runs/25793356977/attempts/1

Artifact

Subject: html_to_json-3.0.0-py3-none-any.whl
SHA-256 checksum: 5ea910fc6d9609f5e1a04b2fd13a06c462a4d144ae64bfd49103d41125e244d3 Verifying attestations