{"id":20935886,"url":"https://github.com/ghostery/trackerdb","last_synced_at":"2026-04-01T19:41:29.319Z","repository":{"id":75477728,"uuid":"604309451","full_name":"ghostery/trackerdb","owner":"ghostery","description":"Ghostery Tracker Database","archived":false,"fork":false,"pushed_at":"2026-03-20T17:27:21.000Z","size":4989,"stargazers_count":170,"open_issues_count":244,"forks_count":52,"subscribers_count":10,"default_branch":"main","last_synced_at":"2026-03-21T02:48:21.476Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ghostery.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"ghostery","open_collective":"ghostery"}},"created_at":"2023-02-20T19:34:22.000Z","updated_at":"2026-03-20T17:27:19.000Z","dependencies_parsed_at":"2026-03-20T12:05:09.126Z","dependency_job_id":null,"html_url":"https://github.com/ghostery/trackerdb","commit_stats":{"total_commits":9,"total_committers":3,"mean_commits":3.0,"dds":"0.33333333333333337","last_synced_commit":"f1588bd505a94c2d008ff8360d84c0b06e938f3e"},"previous_names":[],"tags_count":747,"template":false,"template_full_name":null,"purl":"pkg:github/ghostery/trackerdb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghostery%2Ftrackerdb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghostery%2Ftrackerdb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghostery%2Ftrackerdb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghostery%2Ftrackerdb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ghostery","download_url":"https://codeload.github.com/ghostery/trackerdb/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghostery%2Ftrackerdb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31291180,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-18T22:16:41.947Z","updated_at":"2026-04-01T19:41:29.278Z","avatar_url":"https://github.com/ghostery.png","language":"JavaScript","funding_links":["https://github.com/sponsors/ghostery","https://opencollective.com/ghostery"],"categories":[],"sub_categories":[],"readme":"# Ghostery Tracker Database\n\nTransparency is at the heart of [Ghostery](https://www.ghostery.com/) experience. This is why Ghostery not only [blocks ads, trackers, and other annoyances](https://www.ghostery.com/ghostery-ad-blocker), but also shows how online tracking works by [naming all the organizations](https://whotracks.me/trackers.html) that participate in data exchange over internet.\n\n## Terminology\n\nData exchange can easily uncover personal details by private identifiers, often referred to as tracking. However, not every request from an organization involves data collection (i.e., not every request an organization makes is inherently invasive). Organizations often display a range of behavioral patterns, some of which can be intrusive to user privacy, while others are benign.\n\nAt Ghostery, we're committed to describing things exactly as they are.\n\nThe structure of Ghostery Tracker Database is simple and consists of three main elements:\n* **categories** - [advertising, site analytics, consent management, etc.](docs/categories.md)\n* **organizations** - companies like [Google](db/organizations/google.eno) or [Meta](db/organizations/facebook.eno), but also open source software like [Matomo](db/organizations/matomo.eno)\n* **patterns** - that express various behaviors performed by organizations. For example, a pattern for [Google Analytics](db/patterns/google_analytics.eno) is categorized as [site analytics](docs/categories.md#site-analytics), but a pattern for [Google Tag Manager](db/patterns/google_tag_manager.eno) is categorized as [utilities](docs/categories.md#utilities).\n\n## Where is it used?\n\nThe Tracker Database is used in [Ghostery Browser Extension](https://www.ghostery.com/ghostery-ad-blocker) to categorize all requests we see while browsing the web. It is also used to publish [WhoTracks.me](https://whotracks.me/), the world's largest statistical report on the tracking online.\n\nIt is also used by universities, journalists, and companies that want to understand the nature of the web data exchange.\n\n## SDK\n\nThe Ghostery Tracker Database comes with a JavaScript SDK. Sample usage:\n\n```js\nimport { readFileSync } from 'node:fs';\nimport loadTrackerDB from '@ghostery/trackerdb';\n\nconst engine = readFileSync('./node_modules/@ghostery/trackerdb/dist/trackerdb.engine');\nconst trackerDB = await loadTrackerDB(engine);\n\nconst domainMatches = await trackerDB.matchDomain('google.com');\n\nconst urlMatches = await trackerDB.matchUrl({\n    url: 'https://google.com/gen_204',\n    type: 'xhr',\n    sourceUrl: 'https://google.com/'\n}, {\n    getDomainMetadata: true,\n});\n```\n\n## CLI\n\nGhostery Tracker Database can also be used in a command line, for example with:\n\n```sh\nnpx @ghostery/trackerdb \"https://analytics.tiktok.com\"\n```\n\nOutput:\n\n```json\n{\n  \"url\": \"https://analytics.tiktok.com\",\n  \"matches\": [\n    {\n      \"pattern\": {\n        \"key\": \"tiktok_analytics\",\n        \"name\": \"TikTok Analytics\",\n        \"category\": \"site_analytics\",\n        \"organization\": \"bytedance_inc\",\n        \"alias\": null,\n        \"website_url\": \"https://analytics.tiktok.com\",\n        \"ghostery_id\": \"4050\",\n        \"domains\": [\n          \"analytics.tiktok.com\"\n        ],\n        \"filters\": [\n          \"||analytics.tiktok.com^$3p\"\n        ]\n      },\n      \"category\": {\n        \"key\": \"site_analytics\",\n        \"name\": \"Site Analytics\",\n        \"color\": \"#87d7ef\",\n        \"description\": \"Data analytics, site usage, and performance trackers.\"\n      },\n      \"organization\": {\n        \"key\": \"bytedance_inc\",\n        \"name\": \"ByteDance Inc\",\n        \"description\": \"ByteDance, a Chinese multinational internet technology company headquartered in Beijing and legally domiciled in the Cayman Islands. Its main product is TikTok, known in China as Douyin, a video-focused social networking service.\",\n        \"website_url\": \"https://www.bytedance.com/\",\n        \"country\": \"KY\",\n        \"privacy_policy_url\": \"https://sf16-sg.tiktokcdn.com/obj/eden-sg/upsnuhpevbn/bytedance_official/PrivacyPolicy_ByteDance.com.pdf\",\n        \"privacy_contact\": \"privacy@bytedance.com\",\n        \"ghostery_id\": \"5432\"\n      }\n    }\n  ]\n}\n```\n\n## How can I get involved?\n\nWe encourage contributions from developers of all levels. If you come across any errors, such as typos, inaccuracies, or outdated information, please don't hesitate to open an issue, or, even better, send us a pull request. Your feedback is highly valued!\n\nIf you are new to the project or want an easy starting point, check out our [Good First Issues](https://github.com/ghostery/trackerdb/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22). These are beginner-friendly tasks to help you get acquainted with our project. If you are unsure about an issue or have questions, feel free to ask in the issue comments.\n\n### Data Partners\n\nBig thanks to the companies collaborating closely with us to enhance the quality of this project. Their ongoing contributions are pivotal in improving and refining the information. We highly value their partnership and dedication to achieving top-notch quality!\n\n\u003ca href=\"https://verified-data.com/\" target=\"_blank\"\u003e\u003cimg src=\"assets/logo-verified-data.svg\" height=\"64\"\u003e\u003c/a\u003e\n\n## Licensing\n\nGhostery Tracker Database is published under [CC-BY-NC-SA-4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) license which means it is free to use for non-commercial purposes. If you want to use it in your business, please contact [sales@ghostery.com](mailto:sales@ghostery.com).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fghostery%2Ftrackerdb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fghostery%2Ftrackerdb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fghostery%2Ftrackerdb/lists"}