🌐 GoDaddy Domain Availability Checker

A production-ready Python CLI tool to bulk check domain availability using the GoDaddy API.

Perfect for startup founders checking 200+ domain name options!

---

⚡ Quick Start

1. Get GoDaddy API Credentials (Free)

Visit https://developer.godaddy.com/keys and create your API key.

2. Install Dependencies

pip3 install -r requirements.txt

3. Configure API Credentials

Edit domain_checker.py and update:

API_KEY = "your_api_key_here"
API_SECRET = "your_api_secret_here"

4. Add Your Keywords

Edit words.txt with your keywords (one per line):

velocity
quantum
nexus
amplify

5. Run the Checker

python3 domain_checker.py

---

✨ Features

• ✅ Bulk Domain Checking: Check hundreds of domains automatically
• ✅ Smart Variations: Auto-checks alternatives like getword.com, wordhq.com, wordlabs.com
• ✅ Color-Coded Output: Green for available, Red for taken
• ✅ CSV Export: All results saved to results.csv
• ✅ Rate Limit Handling: Automatic retries with exponential backoff
• ✅ Real-Time Pricing: Shows annual registration cost for available domains
• ✅ macOS Native: Runs perfectly in Terminal

---

📊 Sample Output

======================================================================
  GoDaddy Domain Availability Checker
======================================================================

[1/10] Checking: velocity
  velocity.com                             ✗ TAKEN

  💡 Checking variations for 'velocity'...
  velocityhq.com                           ✓ AVAILABLE - $11.99/year
  getvelocity.com                          ✗ TAKEN
  velocitylabs.com                         ✓ AVAILABLE - $11.99/year

======================================================================
SUMMARY
======================================================================
Total domains checked: 65
Available: 12
Taken: 53
======================================================================

🎉 AVAILABLE DOMAINS (12):
  • velocityhq.com - $11.99/year
  • velocitylabs.com - $11.99/year

---

🛠️ Configuration Options

Environment Selection

OTE (Test) - Free testing environment:

API_BASE_URL = "https://api.ote-godaddy.com"

Production - Real domain checks:

API_BASE_URL = "https://api.godaddy.com"

Customize Domain Variations

Edit the DOMAIN_VARIATIONS list in domain_checker.py:

DOMAIN_VARIATIONS = [
    "{word}hq",
    "get{word}",
    "{word}labs",
    "{word}app",
    # Add your own:
    "the{word}",
    "{word}ai",
]

---

📁 Files Included

File	Description
domain_checker.py	Main Python script
words.txt	Your keyword list (one per line)
requirements.txt	Python dependencies
SETUP_GUIDE.md	Detailed setup instructions for beginners
results.csv	Output file with all results (auto-generated)

---

🔧 Requirements

• Python: 3.7+ (pre-installed on macOS)
• Dependencies: requests library
• GoDaddy API Key: Free at developer.godaddy.com

---

📖 Full Documentation

See SETUP_GUIDE.md for:

• Step-by-step setup instructions
• How to get API credentials
• Troubleshooting guide
• Tips & best practices

---

🚀 Use Cases

• Startup Founders: Check 200+ name ideas in minutes
• Domain Investors: Find available premium domains
• Branding Agencies: Discover available names for clients
• Marketers: Validate campaign domain availability

---

🎯 API Endpoints Used

• GET /v1/domains/available - Check single domain availability
• GET /v1/domains/suggest - Get domain suggestions (optional)

Full API docs: https://developer.godaddy.com/doc/endpoint/domains

---

💡 Pro Tips

1. Start with OTE: Always test with the OTE environment first
2. Batch Processing: For 200+ keywords, the script handles rate limits automatically
3. CSV Analysis: Import results.csv into Excel/Google Sheets for filtering
4. Custom Variations: Tailor the variations list to your industry (e.g., add "io", "ai" for tech startups)

---

🔒 Security

• Never commit your API credentials to version control
• Use environment variables for production deployments
• The OTE environment is safe for testing

---

📄 License

Free to use for personal and commercial projects.

---

🙋 Support

• GoDaddy API Docs: developer.godaddy.com/doc
• Get API Keys: developer.godaddy.com/keys

---

Happy domain hunting! 🎉