# samoaalamdari/youtube_data_collection_and_analysis architecture

> Architecture diagram of the GitHub repository samoaalamdari/youtube_data_collection_and_analysis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/samoaalamdari/youtube_data_collection_and_analysis
- Repository: https://github.com/samoaalamdari/youtube_data_collection_and_analysis

## Overview

This is a notebook-based exploration of YouTube trending videos and channel analytics. The documented workflow fetches trending-video data from YouTube, turns it into a DataFrame for analysis, and presents findings through plots; a separate documented use case analyzes a selected channel. The tree contains only the notebook, so its path is used for the documented components, but the notebook implementation was not sampled. Relationships below reflect README examples and stated capabilities, not inspected notebook internals.

Main entry points: [`YouTubeDataCollectionAndAnalysis.ipynb`](https://github.com/samoaalamdari/youtube_data_collection_and_analysis/blob/main/YouTubeDataCollectionAndAnalysis.ipynb) (Video DataFrame)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Data collection"]
  node_trending["Trending video collection"]
  node_dataset["Video DataFrame"]
end

subgraph group_analysis["Analytics"]
  node_category["Category analysis"]
  node_duration["Duration analysis"]
  node_publishing["Publishing patterns"]
  node_metadata["Tag effectiveness"]
  node_channel["Channel analysis"]
end

subgraph group_presentation["Reporting and visualization"]
  node_report["Channel report"]
  node_visuals["Visualizations"]
end

node_analyst(("Analyst"))
node_youtube["YouTube Data API"]

node_analyst -->|"requests data"| node_trending
node_trending -->|"fetches videos"| node_youtube
node_trending -->|"returns records"| node_dataset
node_analyst -->|"analyzes data"| node_dataset
node_dataset -->|"counts categories"| node_category
node_dataset -->|"analyzes duration"| node_duration
node_dataset -->|"analyzes timing"| node_publishing
node_dataset -->|"assesses tags"| node_metadata
node_analyst -->|"selects channel"| node_channel
node_channel -->|"generates report"| node_report
node_dataset -->|"plots findings"| node_visuals

click node_trending "https://github.com/samoaalamdari/youtube_data_collection_and_analysis/blob/main/YouTubeDataCollectionAndAnalysis.ipynb"
click node_dataset "https://github.com/samoaalamdari/youtube_data_collection_and_analysis/blob/main/YouTubeDataCollectionAndAnalysis.ipynb"
click node_category "https://github.com/samoaalamdari/youtube_data_collection_and_analysis/blob/main/YouTubeDataCollectionAndAnalysis.ipynb"
click node_duration "https://github.com/samoaalamdari/youtube_data_collection_and_analysis/blob/main/YouTubeDataCollectionAndAnalysis.ipynb"
click node_publishing "https://github.com/samoaalamdari/youtube_data_collection_and_analysis/blob/main/YouTubeDataCollectionAndAnalysis.ipynb"
click node_metadata "https://github.com/samoaalamdari/youtube_data_collection_and_analysis/blob/main/YouTubeDataCollectionAndAnalysis.ipynb"
click node_channel "https://github.com/samoaalamdari/youtube_data_collection_and_analysis/blob/main/YouTubeDataCollectionAndAnalysis.ipynb"
click node_report "https://github.com/samoaalamdari/youtube_data_collection_and_analysis/blob/main/YouTubeDataCollectionAndAnalysis.ipynb"
click node_visuals "https://github.com/samoaalamdari/youtube_data_collection_and_analysis/blob/main/YouTubeDataCollectionAndAnalysis.ipynb"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_trending,node_dataset toneBlue
class node_category,node_duration,node_publishing,node_metadata,node_channel toneAmber
class node_report,node_visuals,node_youtube toneMint
class node_analyst toneIndigo
```

## Components

### Data collection

- [Trending video collection](https://github.com/samoaalamdari/youtube_data_collection_and_analysis/blob/main/YouTubeDataCollectionAndAnalysis.ipynb): `YouTubeDataCollectionAndAnalysis.ipynb`
- [Video DataFrame](https://github.com/samoaalamdari/youtube_data_collection_and_analysis/blob/main/YouTubeDataCollectionAndAnalysis.ipynb): `YouTubeDataCollectionAndAnalysis.ipynb`

### Analytics

- [Category analysis](https://github.com/samoaalamdari/youtube_data_collection_and_analysis/blob/main/YouTubeDataCollectionAndAnalysis.ipynb): `YouTubeDataCollectionAndAnalysis.ipynb`
- [Duration analysis](https://github.com/samoaalamdari/youtube_data_collection_and_analysis/blob/main/YouTubeDataCollectionAndAnalysis.ipynb): `YouTubeDataCollectionAndAnalysis.ipynb`
- [Publishing patterns](https://github.com/samoaalamdari/youtube_data_collection_and_analysis/blob/main/YouTubeDataCollectionAndAnalysis.ipynb): `YouTubeDataCollectionAndAnalysis.ipynb`
- [Tag effectiveness](https://github.com/samoaalamdari/youtube_data_collection_and_analysis/blob/main/YouTubeDataCollectionAndAnalysis.ipynb): `YouTubeDataCollectionAndAnalysis.ipynb`
- [Channel analysis](https://github.com/samoaalamdari/youtube_data_collection_and_analysis/blob/main/YouTubeDataCollectionAndAnalysis.ipynb): `YouTubeDataCollectionAndAnalysis.ipynb`

### Reporting and visualization

- [Channel report](https://github.com/samoaalamdari/youtube_data_collection_and_analysis/blob/main/YouTubeDataCollectionAndAnalysis.ipynb): `YouTubeDataCollectionAndAnalysis.ipynb`
- [Visualizations](https://github.com/samoaalamdari/youtube_data_collection_and_analysis/blob/main/YouTubeDataCollectionAndAnalysis.ipynb): `YouTubeDataCollectionAndAnalysis.ipynb`

### Other components

- **Analyst**
- **YouTube Data API**

## Connections

- Analyst → Trending video collection: requests data (evidence: `README.md`)
- Trending video collection → YouTube Data API: fetches videos (evidence: `README.md`)
- Trending video collection → Video DataFrame: returns records (evidence: `README.md`)
- Analyst → Video DataFrame: analyzes data (evidence: `README.md`)
- Video DataFrame → Category analysis: counts categories (evidence: `README.md`)
- Video DataFrame → Duration analysis: analyzes duration (evidence: `README.md`)
- Video DataFrame → Publishing patterns: analyzes timing (evidence: `README.md`)
- Video DataFrame → Tag effectiveness: assesses tags (evidence: `README.md`)
- Analyst → Channel analysis: selects channel (evidence: `README.md`)
- Channel analysis → Channel report: generates report (evidence: `README.md`)
- Video DataFrame → Visualizations: plots findings (evidence: `README.md`)
