Skip to content

lif3time-secr3t-c0de/Keyword-Explorer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

8 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ” Keyword Explorer

Live Demo Next.js TypeScript PostgreSQL Prisma

Real-time keyword research platform with live data from Google, YouTube, Bing, Amazon, and DuckDuckGo. Built for SEO professionals, content creators, and growth marketers.

Live Demo


✨ Features

πŸ” Multi-Source Keyword Discovery

  • Google Autocomplete - Real-time suggestions
  • YouTube Autocomplete - Video keyword ideas
  • Bing Autosuggest - Alternative search data
  • Amazon Completion - Product research
  • DuckDuckGo Suggestions - Privacy-focused source

πŸ“Š Smart Keyword Metrics

  • Search volume estimation
  • Keyword difficulty (0-100)
  • CPC (Cost Per Click) analysis
  • Competition level (HIGH/MEDIUM/LOW)
  • Intent detection (Informational/Commercial/Transactional/Navigational)
  • 12-month trend forecasting

🎯 Advanced Features

  • Competitor Gap Analysis - Compare any two domains
  • Saved Keyword Lists - Organize and export
  • Search History - Track your research
  • CSV Export - Download results
  • Multi-Platform Support - 10+ platforms including Google, YouTube, Amazon, eBay, app stores, and social media

🎨 Modern UI/UX

  • Responsive design (mobile + desktop)
  • Dark/Light mode toggle
  • Real-time search results
  • Beautiful loading states
  • Accessible components

πŸ› οΈ Tech Stack

Category Technologies
Framework Next.js 15 (App Router)
Language TypeScript
Styling Tailwind CSS 4
Database PostgreSQL (Neon) + Prisma ORM
State Management TanStack Query
Validation Zod
Deployment Vercel
UI Components Headless UI, Heroicons, Lucide React

πŸš€ Live Demo

Experience the app now: πŸ‘‰ https://keyword-explorer-three.vercel.app


πŸ“¦ Installation

Prerequisites

  • Node.js 18+
  • npm or yarn
  • PostgreSQL database (or use Neon for free)

Step-by-Step Setup

  1. Clone the repository
git clone https://github.com/lif3time-secr3t-c0de/Keyword-Explorer.git
cd Keyword-Explorer
  1. Install dependencies
npm install
  1. Configure environment variables
cp .env.example .env

Edit .env with your database URL and settings.

  1. Set up database
# Push schema to database
npx prisma db push

# (Optional) Open Prisma Studio
npx prisma studio
  1. Run development server
npm run dev
  1. Open your browser
http://localhost:3000

πŸ”§ Environment Variables

Create a .env file in the root directory:

# Database (PostgreSQL)
DATABASE_URL="postgresql://user:password@host:port/database"

# Keyword Engine Settings
KEYWORD_API_TIMEOUT_MS=4500           # Timeout per request (ms)
KEYWORD_FETCH_CONCURRENCY=8           # Parallel requests
KEYWORD_QUERY_LIMIT=28                 # Query expansions per search

# Cache Configuration
KEYWORD_CACHE_TTL_SECONDS=900          # 15 minutes cache
KEYWORD_PERSIST_CACHE=false            # Enable/disable DB caching

πŸ“‘ API Endpoints

Method Endpoint Description
GET /api/keywords?seed=gaming&platform=GOOGLE Get keyword suggestions
POST /api/keywords Same as GET with JSON body
GET /api/lists Get all saved lists
POST /api/lists Create new list
DELETE /api/lists?id=123 Delete a list
GET /api/user/history Get search history

Keyword Endpoint Parameters

Parameter Required Default Description
seed or q βœ… - Seed keyword (min 2 chars)
platform βœ… - GOOGLE, YOUTUBE, BING, AMAZON, etc.
language or lang ❌ en Language code (e.g., 'en', 'es')
country ❌ US ISO country code
limit ❌ 120 Results limit (10-250)

πŸ—„οΈ Database Schema

// Users, Lists, Keywords, Search History, Cache
// See prisma/schema.prisma for full schema

🌐 Deployment

Deploy to Vercel (Recommended)

  1. Push code to GitHub
  2. Import project at vercel.com
  3. Add environment variables
  4. Deploy!

Your app will be live at: https://keyword-explorer-three.vercel.app


πŸ“Š Performance

  • Lighthouse Scores:
    • Performance: 95+
    • SEO: 100
    • Accessibility: 98
    • Best Practices: 100

πŸ§ͺ Testing

# Run linter
npm run lint

# Build for production
npm run build

# Start production server
npm start

🀝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit changes (git commit -m 'Add AmazingFeature')
  4. Push to branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ“„ License

Copyright Β© 2026 Wali Raza. All rights reserved.

This project uses a Custom Commercial License.

βœ… Free Personal & Development Use

You are free to use, modify, and distribute this software for:

  • Personal projects
  • Educational purposes
  • Non-commercial development
  • Learning and experimentation

No permission needed for these uses - just retain the copyright notice.

πŸ’Ό Commercial Use (Paid License Required)

A one-time paid license is required if you are:

  • A company or organization using this software
  • Using this software to generate revenue
  • Incorporating into a commercial product
  • Using for internal business operations
  • Offering commercial services based on this software

πŸ“§ To Obtain a Commercial License:

  1. Email: thisiswaliraza@gmail.com
  2. Include details about your intended use
  3. Pay one-time license fee (amount to be agreed)
  4. Receive written permission before commercial deployment

Contact for licensing: thisiswaliraza@gmail.com


Unauthorized commercial use is prohibited. See the LICENSE file for full terms.


πŸ‘¨β€πŸ’» Author

Wali Raza


πŸ™ Acknowledgments

  • Next.js team for the amazing framework
  • Vercel for seamless deployment
  • Neon for free PostgreSQL hosting
  • Open source community for inspiration

πŸ“¬ Contact

For support or inquiries:


⭐ Star this repo if you find it useful! ⭐

Live Demo


Made with ❀️ by Wali Raza


πŸ”— Quick Links