# CommentShark

> AI-powered YouTube comment automation: auto-reply, AI moderation, smart rules, and a suite of free public tools for analyzing any YouTube video's comments.

## Free public tools (web pages, no login required)

- [YouTube Engagement Heatmap](https://www.commentshark.com/youtube-engagement-heatmap): A free per-video YouTube engagement heatmap: paste a video URL to see when its audience commented across a year grid, a day-of-week × hour-of-day grid, the first 48 hours after publish, and the full lifetime timeline. ([markdown variant](https://www.commentshark.com/youtube-engagement-heatmap.md))
- [YouTube Comment Wordcloud](https://www.commentshark.com/youtube-comment-wordcloud): A free wordcloud generator for any public YouTube video's comments — returns the most frequent terms weighted by occurrence. ([markdown variant](https://www.commentshark.com/youtube-comment-wordcloud.md))
- [YouTube Comment Searcher](https://www.commentshark.com/youtube-comment-searcher): A free in-browser search over any public YouTube video's comments by keyword, author, or date — no login required. ([markdown variant](https://www.commentshark.com/youtube-comment-searcher.md))
- [YouTube Random Comment Picker](https://www.commentshark.com/youtube-random-comment-picker): A free random comment picker for YouTube giveaways: paste a video URL and the tool fairly samples a winner from its top-level comments. ([markdown variant](https://www.commentshark.com/youtube-random-comment-picker.md))
- [YouTube First Comment Finder](https://www.commentshark.com/youtube-first-comment-finder): A free tool that identifies the earliest commenters on any public YouTube video, ordered by published-at timestamp. ([markdown variant](https://www.commentshark.com/youtube-first-comment-finder.md))
- [YouTube Blocked Words List Builder](https://www.commentshark.com/youtube-blocked-words-list): A free interactive auditor for YouTube channel blocked-words / hidden-words lists with best-practice suggestions. ([markdown variant](https://www.commentshark.com/youtube-blocked-words-list.md))
- [YouTube Comment Sentiment Insights](https://www.commentshark.com/youtube-comment-sentiment-insights): A free sentiment overview for any public YouTube video's comments. ([markdown variant](https://www.commentshark.com/youtube-comment-sentiment-insights.md))
- [YouTube Comment Assistant](https://www.commentshark.com/youtube-comment-assistant): A free auto-reply rule builder for YouTube creators — preview how AI rules would have matched and responded to your channel's recent comments. ([markdown variant](https://www.commentshark.com/youtube-comment-assistant.md))
- [YouTube Comment Moderation Overview](https://www.commentshark.com/youtube-comment-moderation): A free overview of YouTube comment moderation: spam detection, blocked-words enforcement, approval workflows. ([markdown variant](https://www.commentshark.com/youtube-comment-moderation.md))

## Public API (unauthenticated, IP rate-limited)

All public RPCs are POST `https://www.commentshark.com/api/` with a JSON body that includes an `id` field naming the RPC. Full OpenAPI 3.1 spec: https://www.commentshark.com/openapi.json. Agent contract (intent + I/O schemas + examples): https://www.commentshark.com/.well-known/agents.json.

- **get-public-comments-request** — Return top-level comments (and optionally inline replies) for any public YouTube video, with server-side sort/filter/limit. Use when an agent needs to read or sample comments without authenticating. Rate limit: 10 requests / 30 seconds (burst), 60 / hour, 200 / day, per IP.
- **get-video-comment-heatmap-request** — Return per-hour and per-day-of-week comment counts for a YouTube video, timezone-aware. Use when an agent needs to know *when* people commented (engagement timing, best time to post, launch curve). Rate limit: 10 requests / 30 seconds (burst), 60 / hour, 200 / day, per IP.
- **get-video-comment-heatmap-bucket-detail-request** — Given a heatmap bucket (a specific day, or a day-of-week × hour cell), return the top videos, top commenters, top liked comments, and engagement stats inside that bucket across the supplied videos. Use as a follow-up after `get-video-comment-heatmap-request`. Rate limit: 10 requests / 30 seconds (burst), 60 / hour, 200 / day, plus 50 / day specifically for this endpoint (YouTube quota protection), per IP.
- **get-video-comment-wordcloud-request** — Return the top-N most frequent terms across a YouTube video's comments, weighted by occurrence. Use to summarize what viewers are talking about. Rate limit: 10 requests / 30 seconds (burst), 60 / hour, 200 / day, per IP.

## Documentation

- [Pricing](https://www.commentshark.com/pricing) — tier comparison and limits
- [Features](https://www.commentshark.com/features) — full product feature index
- [Blog](https://www.commentshark.com/blog) — guides on YouTube comment automation, moderation, and analytics
- [FAQ](https://www.commentshark.com/faq) — common questions
- [Getting started](https://www.commentshark.com/getting-started) — signup walkthrough

## Worked examples

Fetch a random sample of 100 comments from a video:

```http
POST https://www.commentshark.com/api/
Content-Type: application/json

{
  "id": "get-public-comments-request",
  "videoId": "dQw4w9WgXcQ",
  "sort": "random",
  "limit": 100
}
```

Find the best time of day this audience comments (Los Angeles time):

```http
POST https://www.commentshark.com/api/
Content-Type: application/json

{
  "id": "get-video-comment-heatmap-request",
  "videoId": "dQw4w9WgXcQ",
  "timezone": "America/Los_Angeles"
}
```