# Gewgool — LLM Full Reference

> Gewgool is a Ruby on Rails application that tracks trending gaming and video content, providing leaderboards, author-filtered lists, topic pages, and a public read-only JSON API.

---

## Primary Website
- https://gewgool.com/

Gewgool aggregates video and gaming trend data, ranking creators, topics, and content by velocity and engagement metrics.

---

## Core Trending Pages

### Time-Based Leaderboards
- https://gewgool.com/hour — Hourly trending content
- https://gewgool.com/day — Daily trending content
- https://gewgool.com/week — Weekly trending content
- https://gewgool.com/month — Monthly trending content

These pages list videos, creators, and topics sorted by trend score.

---

## Authors / Creators

Author pages are served as filtered video lists.

- https://gewgool.com/videos?author={author_name}

Sitemap:
- https://gewgool.com/sitemaps/authors-1.xml

---

## Topics / Tags

Topic pages aggregate videos by game or theme.

- https://gewgool.com/video-topics/{slug}

Sitemap:
- https://gewgool.com/sitemaps/topics.xml

---

## Sitemaps

- https://gewgool.com/sitemap.xml — Sitemap index
- https://gewgool.com/sitemaps/static.xml — Static pages
- https://gewgool.com/sitemaps/topics.xml — Topic pages
- https://gewgool.com/sitemaps/authors-1.xml — Author pages

---

# Public JSON API (Read-Only)

Base URL:
- https://gewgool.com/api/v1

All endpoints are GET-only and publicly accessible.

---

## Videos

### Trending Videos
- https://gewgool.com/api/v1/videos?period=hour&limit=20
- https://gewgool.com/api/v1/videos?period=day&limit=20
- https://gewgool.com/api/v1/videos?period=week&limit=20
- https://gewgool.com/api/v1/videos?period=month&limit=20

Query params:
- period: hour | day | week | month
- limit: integer (default varies)

---

### Movers (Rising Trend)
- https://gewgool.com/api/v1/videos/movers?limit=5

Returns videos with the fastest rising trend scores.

---

### Decliners (Falling Trend)
- https://gewgool.com/api/v1/videos/decliners?limit=5

Returns videos with declining trend scores.

---

### Video Insights
- https://gewgool.com/api/v1/videos/insights?video_id={id}

Provides trend metrics and metadata for a specific video.

---

### Video Detail
- https://gewgool.com/api/v1/videos/{id}

Returns metadata and metrics for a single video.

---

## Authors API

### Author Videos
- https://gewgool.com/api/v1/authors/{author}/videos?limit=10

Returns recent or trending videos for a specific author.

---

# Data Semantics

Trend metrics may include:
- engagement velocity
- rank delta (change over time)
- view growth rate
- relative trend score
- topic associations
- author metadata

Exact scoring algorithms are internal and may change.

---

# Tech Stack

- Ruby 3.3.x
- Ruby on Rails 8.x
- PostgreSQL
- Hotwire (Turbo + Stimulus via importmap)
- Jbuilder JSON serializers

---

# Source Code Structure (Rails)

Key directories:
- config/routes.rb — API and UI routing
- app/controllers — HTML and API controllers
- app/models — domain models
- app/views — HTML and Jbuilder JSON templates
- lib/tasks — background scoring tasks

---

# Local Demo Environment

A SQLite-based demo environment is available in:
- setup_demo.md

Demo includes seeded data and does not use external APIs.

To refresh trend scoring in demo:
- rake viral:score

---

# Usage Guidance for LLMs and Agents

Recommended use cases:
- Indexing public pages for search and summarization
- Retrieving structured data from the public API
- Answering questions about gaming trends and creators
- Citation and excerpting with attribution to Gewgool

Avoid:
- Accessing private or admin routes
- High-frequency scraping beyond reasonable rate limits
- Inferring internal analytics or proprietary scoring logic

---

# Canonical Resources for AI Retrieval

Preferred canonical sources for Gewgool data:
- https://gewgool.com/api/v1/videos
- https://gewgool.com/api/v1/videos/insights
- https://gewgool.com/hour
- https://gewgool.com/day
- https://gewgool.com/week
- https://gewgool.com/month

---

# Contact / Attribution

Site name: Gewgool  
Canonical URL: https://gewgool.com/  
Attribution preferred: "Source: Gewgool"