CheckCeleb

A YouTube channel analytics dashboard. Search any channel by name or @handle and get a breakdown of views, engagement, upload timing, and more.

🌐 Live site: check-celeb.vercel.app

Features

• Search by channel name or @handle
• Custom date range (14 / 21 / 30 / 60 day presets or manual input)
• Views trend over time
• Engagement rate per video (likes + comments / views)
• Average views by day of week
• Shorts vs regular video comparison
• TOP 5 most-viewed videos
• Comment word cloud from top 5 videos (English and Korean stopwords filtered)

Tech Stack

• Next.js 16 (App Router)
• TypeScript
• Tailwind CSS v4
• Recharts (charts)
• d3-cloud (word cloud layout)
• YouTube Data API v3

Getting Started

1. Clone the repo

git clone https://github.com/itshyunseunglee/CheckCeleb.git
cd CheckCeleb
npm install

2. Set up environment variables

cp .env.example .env.local

Open .env.local and add your YouTube API key:

YOUTUBE_API_KEY=your_api_key_here

You can get one from the Google Cloud Console. Enable YouTube Data API v3 and create a credential.

API Quota

YouTube Data API has a default limit of 10,000 units/day. The live site runs on a shared quota, so heavy usage may temporarily return a "quota exceeded" error. If that happens, try again the next day when the quota resets.

Action	Quota used (approx)
Channel search	~100 units
Video list (up to 200 videos)	~8 units
Comment word cloud	~5 units per video

To self-host without quota limits, clone the repo and add your own API key.

Project Structure

app/
  api/youtube/          # API routes (search, channel, videos, comments)
  results/[channelId]/  # Channel analysis page
components/
  charts/               # Recharts chart components
  sections/             # Analysis sections (overview, top5, word cloud)
  ui/                   # Shared UI (card, spinner, error message)
lib/
  utils.ts              # Formatters and date helpers
types/
  index.ts              # Shared types