Skip to main content

Pythonic wrapper around the Wikidata SPARQL API for quick creation of datasets from Wikidata

Project description

wikidataloader

Easy pythonic wrapper around the Wikidata SPARQL API for quick creation of datasets from Wikidata.

Only supports simple, non-recursive queries - for complex queries please directly use the SPARQL API provided by Wikidata.

It does not support complex operators (ordering, datetime conversion, string/numeric filtering etc.), because these can be substituted by preprocessing the dataset in Python after retrieval.

Usage

Look up the URIs for properties (e.g. P31) and objects (e.g. Q5) on Wikidata's search engine.

from wikidataloader import WikidataQuery

results = WikidataQuery.search(
    filters={"P31": "Q5", "P27": "Q183", "P106": "Q156839"}, # {is_instance: human, country_of_origin: Germany, profession: cook}
    select=[("P21", "Gender"), ("P19", "City of Birth")],
    limit=30,
	default_language="en"
)

results.to_pandas()

For more examples, see example.ipynb

Install

Install using pip:

pip install wikidataloader

Limitations

  • Does not support recursive queries
  • Does not support labels for Lexeme queries

Project details


Download files

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

Source Distribution

wikidataloader-0.0.2.tar.gz (16.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

wikidataloader-0.0.2-py3-none-any.whl (17.2 kB view details)

Uploaded Python 3

File details

Details for the file wikidataloader-0.0.2.tar.gz.

File metadata

  • Download URL: wikidataloader-0.0.2.tar.gz
  • Upload date:
  • Size: 16.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for wikidataloader-0.0.2.tar.gz
Algorithm Hash digest
SHA256 4b978f2028b0d94d1620f2c0440e0c4f3052813f89d50e1b4aa45d5e2548d8c8
MD5 9f7784b0eb6cda54f133e8ccb630abde
BLAKE2b-256 75f878fb1e87b2a448d9f5dd12aefab8d0c592d5a84cb1fbed5f8331a02b1418

See more details on using hashes here.

File details

Details for the file wikidataloader-0.0.2-py3-none-any.whl.

File metadata

  • Download URL: wikidataloader-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 17.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for wikidataloader-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 6cfa73e232e01917c72ed54c2abaa7b2fb2bd6866eebda5802787d09526958eb
MD5 36a40a6ddbb14ea8fefcf1e1bb22f2d6
BLAKE2b-256 165b4af9b42fde3e74575e6923228df3ab2f1ea80a82f114f2cb5fd9b5fffc22

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page