{"id":20268805,"url":"https://github.com/patrikx3/freenom","last_synced_at":"2025-08-19T10:31:31.804Z","repository":{"id":57317518,"uuid":"93992927","full_name":"patrikx3/freenom","owner":"patrikx3","description":"🌐  Feenom Promise/Async/Await","archived":false,"fork":false,"pushed_at":"2024-07-15T05:56:49.000Z","size":230,"stargazers_count":33,"open_issues_count":0,"forks_count":4,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-12-05T00:09:28.646Z","etag":null,"topics":["async","corifeus","extra","freenom","freenom-api","p3x","promise"],"latest_commit_sha":null,"homepage":"https://www.corifeus.com/freenom","language":"JavaScript","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/patrikx3.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}},"created_at":"2017-06-11T08:55:15.000Z","updated_at":"2024-10-02T05:17:38.000Z","dependencies_parsed_at":"2024-07-15T07:07:04.438Z","dependency_job_id":null,"html_url":"https://github.com/patrikx3/freenom","commit_stats":{"total_commits":272,"total_committers":1,"mean_commits":272.0,"dds":0.0,"last_synced_commit":"100bf81b497bb757e61495d0f057df7aeee9b2f9"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patrikx3%2Ffreenom","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patrikx3%2Ffreenom/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patrikx3%2Ffreenom/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patrikx3%2Ffreenom/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/patrikx3","download_url":"https://codeload.github.com/patrikx3/freenom/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229866119,"owners_count":18136417,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["async","corifeus","extra","freenom","freenom-api","p3x","promise"],"created_at":"2024-11-14T12:20:11.347Z","updated_at":"2025-08-19T10:31:31.790Z","avatar_url":"https://github.com/patrikx3.png","language":"JavaScript","funding_links":["https://paypal.me/patrikx3","https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=QZVM4V6HVZJW6"],"categories":[],"sub_categories":[],"readme":"[//]: #@corifeus-header\n\n  [![NPM](https://img.shields.io/npm/v/p3x-freenom.svg)](https://www.npmjs.com/package/p3x-freenom)  [![Donate for PatrikX3 / P3X](https://img.shields.io/badge/Donate-PatrikX3-003087.svg)](https://paypal.me/patrikx3) [![Contact Corifeus / P3X](https://img.shields.io/badge/Contact-P3X-ff9900.svg)](https://www.patrikx3.com/en/front/contact) [![Corifeus @ Facebook](https://img.shields.io/badge/Facebook-Corifeus-3b5998.svg)](https://www.facebook.com/corifeus.software)  [![Uptime ratio (90 days)](https://network.corifeus.com/public/api/uptime-shield/31ad7a5c194347c33e5445dbaf8.svg)](https://network.corifeus.com/status/31ad7a5c194347c33e5445dbaf8)\n\n\n\n\n\n# 🌐 Freenom API - Promise and auto renew expiring domains v2025.4.122\n\n\n  \n🌌 **Bugs are evident™ - MATRIX️**  \n🚧 **This project is under active development!**  \n📢 **We welcome your feedback and contributions.**  \n    \n\n\n\n### NodeJS LTS is supported\n\n### 🛠️ Built on NodeJs version\n\n```txt\nv22.13.1\n```\n\n\n\n\n\n# 📝 Description\n\n                        \n[//]: #@corifeus-header:end\n\n## To be able to register and renew FREE DOMAINS\n\nBefore, we were able to register and renew with free domains, but by now, these functions are allowed and working ONLY with PAID domains.\n\n### Some links\nhttp://www.freenom.com/en/resellers.html  \nhttp://www.freenom.com/en/termsandconditions.html  \n  \n## API\n\nhttp://www.freenom.com/en/freenom-api.html\n\nI am using these only right now. So no other functions but very easy to add in and Promise based.\n\n```js\nconst Freenom = require('p3x-freenom');\nconst freenom = await Freenom({\n    email: 'p3x@corifeus',\n    password: 'password',\n});\n\nawait freenom.service.ping();\n\nawait freenom.domain.search({\n    domainname: 'patrikx3.com',\n    domaintype: 'FREE'\n})\n\nawait freenom.domain.delete({ domainname: 'random.tk'));\n\nawait freenom.domain.register({\n        domainname: [\n            'random.tk',\n            'random1.tk',\n            'random2.tk',\n        ],\n        domaintype: 'FREE',\n        period: '1Y',\n        nameserver: [\n            'ns1.ns.tk',\n            'ns2.ns.tk',\n        ]\n})\n\nawait freenom.domain.delete, {  domainname: domains })\n\n// if you have no domain in the list, instead of\n// giving an empty list, it shows and error!!!\n// so make sure you have one in the domain list\n// because freenom.domain.expiringRenew will of course\n// throw an error as well!!!\nawait freenom.domain.list()\n```\n\n# The good extra functions \n\nIt automatically renew the free domains (it checks if it is within 14 days expiry and then does it).\n\n```js\n// just a helper, you don't relly need it\nconst renewable = await freenom.domain.expiring({\n    expiry: '60 days',\n});\n\n// the magic\nawait freenom.domain.expiringRenew({\n    period: '12M',\n})\n```\n    \n[//]: #@corifeus-footer\n\n---\n\n## 🚀 Quick and Affordable Web Development Services\n\nIf you want to quickly and affordably develop your next digital project, visit [corifeus.eu](https://corifeus.eu) for expert solutions tailored to your needs.\n\n---\n\n## 🌐 Powerful Online Networking Tool  \n\nDiscover the powerful and free online networking tool at [network.corifeus.com](https://network.corifeus.com).  \n\n**🆓 Free**  \nDesigned for professionals and enthusiasts, this tool provides essential features for network analysis, troubleshooting, and management.  \nAdditionally, it offers tools for:  \n- 📡 Monitoring TCP, HTTP, and Ping to ensure optimal network performance and reliability.  \n- 📊 Status page management to track uptime, performance, and incidents in real time with customizable dashboards.  \n\nAll these features are completely free to use.  \n\n---\n\n## ❤️ Support Our Open-Source Project  \nIf you appreciate our work, consider ⭐ starring this repository or 💰 making a donation to support server maintenance and ongoing development. Your support means the world to us—thank you!  \n\n---\n\n### 🌍 About My Domains  \nAll my domains, including [patrikx3.com](https://patrikx3.com), [corifeus.eu](https://corifeus.eu), and [corifeus.com](https://corifeus.com), are developed in my spare time. While you may encounter minor errors, the sites are generally stable and fully functional.  \n\n---\n\n### 📈 Versioning Policy  \n**Version Structure:** We follow a **Major.Minor.Patch** versioning scheme:  \n- **Major:** 📅 Corresponds to the current year.  \n- **Minor:** 🌓 Set as 4 for releases from January to June, and 10 for July to December.  \n- **Patch:** 🔧 Incremental, updated with each build.  \n\n**🚨 Important Changes:** Any breaking changes are prominently noted in the readme to keep you informed.\n\n---\n\n\n[**P3X-FREENOM**](https://corifeus.com/freenom) Build v2025.4.122\n\n [![NPM](https://img.shields.io/npm/v/p3x-freenom.svg)](https://www.npmjs.com/package/p3x-freenom)  [![Donate for PatrikX3 / P3X](https://img.shields.io/badge/Donate-PatrikX3-003087.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=QZVM4V6HVZJW6)  [![Contact Corifeus / P3X](https://img.shields.io/badge/Contact-P3X-ff9900.svg)](https://www.patrikx3.com/en/front/contact) [![Like Corifeus @ Facebook](https://img.shields.io/badge/LIKE-Corifeus-3b5998.svg)](https://www.facebook.com/corifeus.software)\n\n\n\n\n\n[//]: #@corifeus-footer:end\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpatrikx3%2Ffreenom","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpatrikx3%2Ffreenom","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpatrikx3%2Ffreenom/lists"}