{"id":16759447,"url":"https://github.com/pogzyb/czdsdump","last_synced_at":"2026-04-02T17:03:41.006Z","repository":{"id":237111376,"uuid":"790260360","full_name":"pogzyb/czdsdump","owner":"pogzyb","description":"Download domain data from the Centralized Zone Database Service","archived":false,"fork":false,"pushed_at":"2026-03-27T23:02:41.000Z","size":47,"stargazers_count":17,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-28T05:43:52.086Z","etag":null,"topics":["centralized-zone-database-service","cybersecurity","czds","domain-names","research","threat-hunting","threat-intelligence"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pogzyb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2024-04-22T14:58:16.000Z","updated_at":"2026-03-27T23:01:29.000Z","dependencies_parsed_at":null,"dependency_job_id":"2dbb7b33-ceb1-4799-87d9-107fd0d9da1d","html_url":"https://github.com/pogzyb/czdsdump","commit_stats":null,"previous_names":["pogzyb/czdsdump"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/pogzyb/czdsdump","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pogzyb%2Fczdsdump","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pogzyb%2Fczdsdump/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pogzyb%2Fczdsdump/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pogzyb%2Fczdsdump/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pogzyb","download_url":"https://codeload.github.com/pogzyb/czdsdump/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pogzyb%2Fczdsdump/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31311045,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":["centralized-zone-database-service","cybersecurity","czds","domain-names","research","threat-hunting","threat-intelligence"],"created_at":"2024-10-13T04:08:09.075Z","updated_at":"2026-04-02T17:03:40.993Z","avatar_url":"https://github.com/pogzyb.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# czdsdump\n\nUtility for dumping zone files from the Centralized Zone Data Service to an S3 Bucket or File System.\n\n\u003e The Centralized Zone Data Service (CZDS) is an online portal where any interested party can request access to the Zone Files provided by participating generic Top-Level Domains (gTLDs).\n\nCreate ICANN account: https://czds.icann.org/home\n\n### Examples\n\nLocal\n```\ngit clone https://github.com/pogzyb/czdsdump.git\n\ncd czdsdump\ngo build -o czdsdump .\n\n# all zones\n./czdsdump download all -v -o /tmp -u \u003cuser\u003e -p \u003cpassword\u003e\n\n# one zone (\".com\")\n./czdsdump download one -v -o /tmp -u \u003cuser\u003e -p \u003cpassword\u003e -z com\n```\n\nDocker\n```\ndocker pull ghcr.io/pogzyb/czdsdump:latest\ndocker run -v ./data/:/tmp/czds/ ghcr.io/pogzyb/czdsdump download all -v -o /tmp/czds/ -u \u003cuser\u003e -p \u003cpassword\u003e\n```\n\nDump to an S3 bucket\n```\n# assumes you have aws credentials and region set in `.env.aws`\ndocker pull ghcr.io/pogzyb/czdsdump:latest\ndocker run --env-file .env.aws ghcr.io/pogzyb/czdsdump download all -v -o s3://mybucket/czds/2026-03-28/ -u \u003cuser\u003e -p \u003cpassword\u003e\n```\n\nDump only one zone\n```\ndocker pull ghcr.io/pogzyb/czdsdump:latest\n# only downloads data from \".com\" zone\ndocker run -v ./data/:/tmp/czds/ ghcr.io/pogzyb/czdsdump download one -v -o /tmp/czds/ -u \u003cuser\u003e -p \u003cpassword\u003e -z com\n```\n\n### Resources / Information\n\nWhat are these files?\n\n\u003e The registry operator’s zone data contains the mapping of domain names, associated name server names, and IP addresses for those name servers. These details are updated by the registry operator for its respective TLDs whenever information changes or a domain name is added or removed. \n\u003e https://czds.icann.org/help\n\nIn short, these files are .txt files containing the domain names for the given registry. For example, the zone file for \".com\" would contain all the registered .com domain names at that given time.\n\nHow often should you dump these files?\n\n\u003e  ICANN begins the daily collection of zone files from the registry operators at 00:00 UTC, and the process takes no more than 6 hours. This means that all updated zone files are available for download from CZDS after 06:00 UTC. End users of CZDS can freely download each of the latest available zone files once their access request has been approved by the registry operator of the TLD.\n\n\u003e Zone files are updated once per day starting at 00:00 UTC, so an end user of CZDS should only download each TLD zone file a maximum of once per 24-hour period. \n\u003e https://czds.icann.org/help\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpogzyb%2Fczdsdump","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpogzyb%2Fczdsdump","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpogzyb%2Fczdsdump/lists"}