🌐 PulseDomain AI

🚀 Getting Started

Welcome to PulseDomain AI! This comprehensive guide will help you get started with our AI-powered domain name generator that creates brandable domain suggestions based on current news trends.

Quick Start

1. Enter a news topic - Type keywords related to current trends
2. Configure settings - Choose your business focus and preferences
3. Generate domains - Click the generate button to get AI suggestions
4. Check availability - Verify which domains are available for registration
5. Register your domain - Use our Porkbun integration to secure your domain

👤 User Guide

🔑 API Key Configuration

PulseDomain AI requires API keys for optimal functionality:

📊 Domain Generation Process

⚙️ Configuration Options

🔧 API Reference

Complete API documentation for developers who want to integrate with PulseDomain AI programmatically.

🚀 Domain Generation API

{
  "geminiApiKey": "your-gemini-api-key",
  "newsQuery": "artificial intelligence",
  "wordCount": 5,
  "maxDomains": 10,
  "tldPreferences": ".com,.io,.ai",
  "businessFocus": "technology",
  "includeKeywords": true,
  "timeRange": "24h",
  "fetchDepth": "light",
  "mediastackApiKey": "optional-mediastack-key",
  "gnewsApiKey": "optional-gnews-key",
  "newsapiApiKey": "optional-newsapi-key",
  "currentsApiKey": "optional-currents-key"
}

{
  "success": true,
  "suggestions": [
    {
      "domain": "aitrend.com",
      "available": true,
      "tld": ".com",
      "brandability": 8.5,
      "memorability": 9.2,
      "overallScore": 8.8,
      "reasoning": "Combines AI trend focus with memorable branding"
    }
  ],
  "metadata": {
    "newsQuery": "artificial intelligence",
    "articlesFound": 15,
    "generatedAt": "2025-06-26T21:00:00.000Z"
  }
}

🔍 Domain Availability API

{
  "success": true,
  "domain": "example.com",
  "result": {
    "available": false,
    "source": "whois",
    "confidence": "high",
    "checkedAt": "2025-06-26T21:00:00.000Z"
  }
}

📦 Batch Domain Check API

{
  "domains": ["example1.com", "example2.io", "example3.ai"]
}

{
  "success": true,
  "results": [
    {
      "domain": "example1.com",
      "available": false,
      "source": "whois"
    },
    {
      "domain": "example2.io",
      "available": true,
      "source": "whois"
    }
  ],
  "summary": {
    "total": 3,
    "available": 1,
    "unavailable": 2
  }
}

✨ Features

⚙️ Configuration

🔐 Environment Variables

Configure PulseDomain AI using environment variables:

# Required
GEMINI_API_KEY=your_gemini_api_key_here

# Optional News APIs
MEDIASTACK_API_KEY=your_mediastack_key
GNEWS_API_KEY=your_gnews_key
NEWSAPI_API_KEY=your_newsapi_key
CURRENTS_API_KEY=your_currents_key

# Server Configuration
PORT=3000
NODE_ENV=production

# Security
SESSION_SECRET=your_session_secret
ENCRYPTION_KEY=your_encryption_key

🎛️ Advanced Settings

🔧 Troubleshooting

💡 Examples

const response = await fetch('/generate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    geminiApiKey: 'your-api-key',
    newsQuery: 'artificial intelligence',
    maxDomains: 5,
    businessFocus: 'technology'
  })
});

const data = await response.json();
console.log(data.suggestions);

import requests

response = requests.post('http://localhost:3000/generate', json={
    'geminiApiKey': 'your-api-key',
    'newsQuery': 'artificial intelligence',
    'maxDomains': 5,
    'businessFocus': 'technology'
})

data = response.json()
print(data['suggestions'])

curl -X POST http://localhost:3000/generate \
  -H "Content-Type: application/json" \
  -d '{
    "geminiApiKey": "your-api-key",
    "newsQuery": "artificial intelligence",
    "maxDomains": 5,
    "businessFocus": "technology"
  }'

📝 Changelog