Docs
Thumbnail & Title Changes
Thumbnail and title changes Algrow watched happen, judged on each video's own daily views: won, lost, reverted.
Thumbnail and title changes Algrow watched happen on YouTube videos, each judged on the video's own daily views. Only changes Algrow watched happen itself are shown, dated to the second for thumbnails (the CDN's own change time) and to a ~7 hour window for titles; nothing is backfilled from archives. A change is shown only when the daily pace after it is at least 3x the pace before (a win) or at most 1/3 of it (a loss), the change bought or cost at least 10,000 views, there are at least 2 days of daily views on each side, the change is dated on or after 13 October 2026, and Algrow holds the before image or text from before the change. Reverted changes are shown too. Wins and reverts only for now: a flat before-pace reads a new video's normal launch decay as a loss, so losses stay hidden until the pace model handles decay. Everything else is logged and scored but never returned. Each change carries the before and after, the verdict (won or reverted), the multiple, the views it bought, how many days the new pace held, and whether the score is settled (day 28).
get_video_changes
Every thumbnail and title change of one video, oldest first. Thumbnail before and after are image URLs; title before and after are the texts. multiple is the daily pace after divided by the pace before; views_bought is the views the change added or cost against the old pace; held_days is how long the new pace stayed past the bar. Free, no credits.
"Show me every title this video has had and what each one did to its views"
| Parameter | Type | Default | Description |
|---|---|---|---|
| video_id | string | required | YouTube video id (11 characters) or a video URL. |
Did this video change its thumbnail, and did it work?
get_channel_changes
A channel's thumbnail and title changes, newest first, with its 90-day roll-up (stats, swaps, won, lost, reverted). The win rate shows once 50 swaps are behind it; below that it is null. Free, no credits.
"List this channel's thumbnail swaps from the last month"
| Parameter | Type | Default | Description |
|---|---|---|---|
| channel_id | string | required | YouTube channel ID (UC...). Use resolve_handle first for a @handle or URL. |
| days | integer | 90 | How far back to look, in days. Max 365. |
How often does @channel repackage videos, and does it pay off?
recent_changes
The feed of thumbnail and title changes across every watched video, most views bought first. Filter by niche, kind and verdict to see what repackaging is winning right now.
"Show me title changes that were reverted in the last 30 days"
| Parameter | Type | Default | Description |
|---|---|---|---|
| niche | string | null | Only videos in this niche (the niche names used by the viral feed). |
| kind | string | null | thumbnail or title; both when empty. |
| verdict | string | null | won or reverted; both when empty. lost is refused while losses are hidden. |
| min_multiple | number | null | Only changes where the daily pace moved at least this many times, up or down. The 3x floor always applies. |
| days | integer | 30 | How far back to look, in days. Max 365. |
| limit | integer | 25 | Results to return, max 100. |
What thumbnail swaps won the most views this week in the cooking niche?
changes_like
Thumbnail and title changes on videos like yours, each with a match score. still matches the thumbnail image (before or after) against your video's thumbnail or a pasted image URL; subject matches what the video is about; title_format matches the title's shape. Any mix; a row must pass every match you ask for. Use it before changing your own thumbnail or title to see what swaps worked on videos like it.
"Find title changes on videos about the same subject as this one"
| Parameter | Type | Default | Description |
|---|---|---|---|
| ref | string | required | A YouTube video id or URL, or a thumbnail image URL. An image URL can only match on still. |
| match | array | null | What to match on: still, subject, title_format, any mix. Default still. |
| kind | string | null | thumbnail or title; both when empty. |
| verdict | string | null | won or reverted; both when empty. lost is refused while losses are hidden. |
| niche | string | null | Only videos in this niche. |
| days | integer | 90 | How far back to look, in days. Max 365. |
| limit | integer | 25 | Results to return, max 100. |
What thumbnail swaps worked on videos with a still like mine?
format_swaps
Title changes grouped by title format before and after (plain subject to question, list to how-to, and so on). Each group has how many swaps it holds, how many won or were reverted, the typical multiple, and three real examples. A win rate shows once 50 swaps are behind it. Titles without a cached format are classified on the spot, at most 100 per call; past that the reply says partial = true with unclassified, the number of changes left out. Call again to classify more. The reply lists every format family name you can pass (families).
"Does turning a plain title into a question help in the history niche?"
| Parameter | Type | Default | Description |
|---|---|---|---|
| from_format | string | null | Title format family the title moved from, for example plain_subject, number_list, how_to, question_hook. Any when empty. |
| to_format | string | null | Title format family the title moved to. Any when empty. |
| niche | string | null | Only videos in this niche. |
| days | integer | 90 | How far back to look, in days. Max 365. |
| limit | integer | 100 | Title changes to read before grouping, max 100. |
Which title format changes win most often?