Skip to main content
whotracks.me

Bringing Transparency to online tracking - built by Cliqz and Ghostery.


This repository contains:

  • data on trackers and websites as shown on whotracks.me (WTM)

  • database mapping tracker domains to companies

  • code to render the whotracks.me site

Installation

Python 3.6 is needed to build the site. We recommend creating a virtualenv (or pipenv) to install the dependencies.

From Pypi

$ pip install whotracksme

From source

$ pip install -e .

That’s all you need to get started!

Using the data

To get started with the data, everything you need can be found in whotracksme.data:

from whotracksme.data.loader import DataSource

data = DataSource()

# available entities
data.trackers
data.companies
data.sites

For examples of scripts, have a look in the contrib folder!

Building the site

Building the site requires a few extra dependencies, not installed by default to not make the installation heavier than it needs to be. You will need to install whotracksme from the repository, because not all assets are packaged with whotracksme released on pypi:

$ pip install -e '.[dev]'

Once this is done, you will have access to a whotracksme entry point that can be used this way:

$ whotracksme website [serve]

The serve part is optional and can be used while making changes on the website.

All generated artifacts can be found in the _site/ folder.

Tests

To run tests, you will need pytest, or simply install whotacksme with the dev extra:

$ pip install -e '.[dev]'
$ pytest

Publishing a new version

$ pip install twine
$ python setup.py sdist bdist_wheel
$ twine upload --username cliqz-oss dist/*

Contributing

We are happy to take contributions on: * Guest articles for our blog in the topics of tracking, privacy and security. Feel free to use the data in this repository if you need inspiration. * Feature requests that are doable using the WTM database. * Curating our database of tracker profiles. Open an issue if you spot anything odd.

Right to Amend

Please read our Guideline for 3rd parties wanting to suggest corrections to their data.

License

The content of this project itself is licensed under the Creative Commons Attribution 4.0 license, and the underlying source code used to generate and display that content is licensed under the MIT license.

Metadata

Release files for whotracksme 2018.4

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

Source distribution (sdist)

Source distribution for whotracksme 2018.4
File Size Uploaded Provenance Actions
whotracksme-2018.4.tar.gz 51.5 MB Without provenance Details for whotracksme-2018.4.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for whotracksme 2018.4
File Interpreter ABI Platform Actions
whotracksme-2018.4-py3.6.egg Legacy Egg format - - Details for whotracksme-2018.4-py3.6.egg
whotracksme-2018.4-py3-none-any.whl Python 3 none any Details for whotracksme-2018.4-py3-none-any.whl

Total release size: 155.3 MB

Release files / whotracksme-2018.4.tar.gz

Download URL whotracksme-2018.4.tar.gz
Size 51.5 MB
Tags Source
SHA-256 checksum
How to use checksums
a1f1815a1c2452e57288337fdd68f98c23b75cef2b97b405935651bc4e238be6
BLAKE2b-256 checksum
How to use checksums
d32b6a2e87e737bebad3a848614eac7c56b0ff1fcfe40a9fe1c5d31ca5a3f664
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / whotracksme-2018.4-py3.6.egg

Download URL whotracksme-2018.4-py3.6.egg
Size 51.9 MB
Tags Egg
SHA-256 checksum
How to use checksums
f1c673c14b0ef37d251586958bd626ba62c25dfcbfd7cfa829c99fc10dbb820a
BLAKE2b-256 checksum
How to use checksums
71480b045b46523da46347af19fdae9165fd4ec9a5e65454933f59b0293b024d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / whotracksme-2018.4-py3-none-any.whl

Download URL whotracksme-2018.4-py3-none-any.whl
Size 51.9 MB
Tags Python 3
SHA-256 checksum
How to use checksums
21dfd37535d5b0ccd1d4fbb44d5366a0f2f470138d2054d463f0417998c679b9
BLAKE2b-256 checksum
How to use checksums
516106b0483cfd13d1c56e936298edd980a0acb42d0b371552bf6a160dd2a090
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for whotracksme 2018.4

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page