# TikTok Music Analytics POC - Project Scope

## Project Vision
Build a lightweight, functional prototype that showcases the core capabilities of a TikTok analytics tool for music industry professionals.

## Core Features

### 1. Song Tracker
- **Interface**: Simple input form
- **User Input**: Song title and artist name
- **Purpose**: Allow users to specify which song they want to track

### 2. Video Discovery
- **Technology**: Apify's Clockworks TikTok scrapers
- **Function**: Automatically find all videos that use the specified song
- **Data Source**: TikTok Sound Scraper API

### 3. Basic Analytics Dashboard
Display the following metrics for each tracked song:

#### Key Metrics
- **Total Videos**: Count of all videos using the song
- **Total Views**: Aggregate view count across all videos

#### Top Performers
- **Top 5 Videos**: 
  - Sorted by view count (descending)
  - Include direct links to TikTok videos
  - Show view counts

- **Top 5 Creators**:
  - Sorted by view count of their videos using the song
  - Include direct links to creator profiles
  - Show their video view counts for this song

### 4. Data Refresh
- **Frequency**: Daily automated refresh
- **Purpose**: Keep analytics current and relevant
- **Implementation**: Scheduled API calls to update song data

## Success Criteria

### Functional Requirements
✅ User can input song title and artist  
✅ System finds videos using that song via TikTok scraping  
✅ Dashboard displays total videos and views  
✅ Top 5 videos and creators are shown with links  
✅ Data refreshes daily  

### Technical Requirements
- Clean, simple user interface
- Reliable integration with Apify/Clockworks APIs
- Fast dashboard loading times
- Error handling for API failures
- Data persistence between refreshes

## Intentional Limitations

### What We're NOT Building
- Multi-platform support (TikTok only)
- Historical trend analysis
- Advanced filtering or segmentation
- User management or authentication
- Real-time data updates
- Export functionality
- Comparison between multiple songs

### Why These Limitations
- **Speed**: Deliver working prototype quickly
- **Focus**: Demonstrate core value proposition
- **Simplicity**: Avoid complexity that doesn't add immediate value
- **Validation**: Test market interest before expanding features

## Technical Architecture Overview

### Components
1. **Frontend**: Simple web interface for song input and dashboard
2. **Backend API**: Handle song tracking requests and data processing
3. **Data Layer**: Store song data and analytics results
4. **Scheduler**: Daily data refresh automation
5. **TikTok Integration**: Apify/Clockworks API wrapper

### Data Flow
1. User inputs song title and artist
2. System searches TikTok for videos using that song
3. Extract and aggregate video/creator data
4. Store results in database
5. Display analytics on dashboard
6. Schedule daily refresh for tracked songs

## Value Proposition

### For Music Labels
- Quick identification of how their songs perform on TikTok
- Discovery of top-performing videos and creators
- Understanding of song reach and engagement

### For Artists
- Track how their music spreads across TikTok
- Identify influential creators using their songs
- Monitor song popularity trends

### For Marketers
- Find successful TikTok content using specific songs
- Identify high-performing creators for partnerships
- Measure campaign effectiveness

## Next Phase Considerations
After POC validation, potential expansions:
- Historical data and trend analysis
- Multi-song comparison
- Creator contact information
- Performance predictions
- Integration with other platforms
- Advanced filtering and segmentation

## Success Metrics
- Working prototype demonstrates all core features
- Accurate data extraction from TikTok
- Clean, intuitive user interface
- Reliable daily data refresh
- Positive feedback from initial users