Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

Combine XPath, CSS Selectors and JSONPath for Web data extracting.

Project description

license Pypi Status Python version Package version PyPI - Downloads GitHub last commit Code style: black Build Status codecov Documentation Status

Combine XPath, CSS Selectors and JSONPath for Web data extracting.



Install the stable version from PYPI.

pip install "data-extractor[jsonpath-extractor]"  # for extracting JSON data
pip install "data-extractor[lxml]"  # for extracting HTML data

Or install the latest version from Github.

pip install "data-extractor[jsonpath-extractor] @ git+"

Extract JSON data

Currently supports to extract JSON data with below optional dependencies

install one dependency of them to extract JSON data.

Extract HTML(XML) data

Currently supports to extract HTML(XML) data with below optional dependencies


from data_extractor import Field, Item, JSONExtractor

class Count(Item):
    followings = Field(JSONExtractor("countFollowings"))
    fans = Field(JSONExtractor("countFans"))

class User(Item):
    name_ = Field(JSONExtractor("name"), name="name")
    age = Field(JSONExtractor("age"), default=17)
    count = Count()

assert User(JSONExtractor("data.users[*]"), is_many=True).extract(
        "data": {
            "users": [
                    "name": "john",
                    "age": 19,
                    "countFollowings": 14,
                    "countFans": 212,
                    "name": "jack",
                    "description": "",
                    "countFollowings": 54,
                    "countFans": 312,
) == [
    {"name": "john", "age": 19, "count": {"followings": 14, "fans": 212}},
    {"name": "jack", "age": 17, "count": {"followings": 54, "fans": 312}},




  • type annotations #63 #64


  • .utils.Property with “Customized names” support #64
  • rename .abc to .core and mark elder duplciated #65

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for data-extractor, version 0.9.0
Filename, size File type Python version Upload date Hashes
Filename, size data_extractor-0.9.0-py3-none-any.whl (14.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size data_extractor-0.9.0.tar.gz (13.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page