Documentation

Everything you need to consume or contribute to the lists.

List format

Each generated list is a plain-text file served as text/plain; charset=utf-8. Rules:

• One domain per line.
• UTF-8 encoding, LF line endings, trailing newline.
• Lines beginning with # are comments (a short provenance header is prepended).
• Domains are lowercase, deduplicated and sorted deterministically.

Domain syntax

Accepted: example.com, sub.example.com, example.co.uk. Rejected: URLs, paths, query strings, ports, IP addresses, localhost, wildcards and underscores.

Raw list usage

Fetch any list directly:

curl -fsSL https://dns.itisuniqueofficial.com/social/domains.txt

Large categories are chunked into domains-1.txt, domains-2.txt, … at 50,000 domains per file. domains.txt is the complete aggregate.

Metadata / API

Static JSON endpoints, regenerated on every build:

• /lists.json
• /stats.json
• /<category>/index.json

Automation

Pull requests trigger validation and a build test. Merges to main regenerate every list, JSON file, the sitemap and the site, then deploy to Cloudflare Pages. A scheduled integrity check re-verifies everything periodically.

Contribution process

See the contribution page and CONTRIBUTING.md.

Release process

There are no manual releases. Production is a direct reflection of the main branch: every merged, validated change is deployed automatically.

Security model

All pull requests are treated as untrusted input. CI runs with least-privilege permissions, never exposes secrets to fork PRs, and never executes contributor-provided content. Domain data is treated strictly as text — never as executable content. See SECURITY.md.

Disclaimer

This project provides community-maintained domain classification lists. Inclusion of a domain does not constitute a claim that the domain is malicious, unlawful, or unsafe unless the relevant category and project methodology explicitly state otherwise.