Docs

# Subjects worth making next, proven across several channels
curl "https://api.algrow.online/api/viral-videos/channel-ideas?channel=@CookTheMexicanWay" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Title formats worth stealing, biggest single wins first
curl "https://api.algrow.online/api/viral-videos/channel-ideas?channel=UCEpgRWDUGVu7UaYc7fB1Idw&kind=formats&sort=best" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "channel_id": "UCEpgRWDUGVu7UaYc7fB1Idw",
  "kind": "subjects",
  "sort": "proven",
  "peer_channels": 75,
  "peer_videos": 1026,
  "results": [
    {
      "name": "carne asada tacos",
      "variants": ["carne asada taco recipe", "authentic carne asada tacos"],
      "videos": 5,
      "channels": 5,
      "hits": 2,
      "hit_channels": 2,
      "best_multiple": 15.3,
      "median_multiple": 0.6,
      "best_views": 439951,
      "example_title": "Taqueria Style Carne Asada Tacos - Blackstone Griddle",
      "example_url": "https://www.youtube.com/watch?v=...",
      "example_channel": "TexMex at Home",
      "example_thumbnail": "https://i.ytimg.com/vi/.../maxresdefault.jpg"
    }
  ]
}

# Search by image URL — find videos with similar thumbnails
curl -X POST "https://api.algrow.online/api/thumbnail-search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_url": "https://i.ytimg.com/vi/abc123/maxresdefault.jpg", "limit": 10}'

# Search by text — describe the thumbnail style you're looking for
curl -X POST "https://api.algrow.online/api/thumbnail-search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "red arrow pointing at shocked face", "limit": 20}'

# Text search with filters — only high-view results
curl -X POST "https://api.algrow.online/api/thumbnail-search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "before and after transformation", "min_views": 100000, "min_similarity": 0.5}'

{
  "success": true,
  "count": 10,
  "videos": [
    {
      "video_id": "abc123",
      "title": "How I Made $10k in 30 Days",
      "channel_name": "Finance Tips",
      "channel_id": "UCxxxxxxxxxxxxxxxxxxxxxx",
      "view_count": 1500000,
      "thumbnail_url": "https://i.ytimg.com/vi/abc123/maxresdefault.jpg",
      "upload_date": "2026-03-20",
      "url": "https://www.youtube.com/watch?v=abc123",
      "duration": 612,
      "subscriber_count": 85000,
      "similarity_score": 78
    }
  ]
}

# Search by image URL — find terminated videos with similar thumbnails
curl -X POST "https://api.algrow.online/api/terminated-thumbnail-search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_url": "https://i.ytimg.com/vi/abc123/maxresdefault.jpg", "limit": 10}'

# Search by text — describe the thumbnail style
curl -X POST "https://api.algrow.online/api/terminated-thumbnail-search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "red arrow pointing at shocked face", "limit": 20}'

# Search by YouTube video URL
curl -X POST "https://api.algrow.online/api/terminated-thumbnail-search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"video_url": "https://www.youtube.com/watch?v=abc123", "min_views": 50000}'

{
  "success": true,
  "count": 10,
  "videos": [
    {
      "video_id": "abc123",
      "title": "How I Made $10k in 30 Days",
      "channel_name": "Finance Tips",
      "channel_id": "UCxxxxxxxxxxxxxxxxxxxxxx",
      "view_count": 1500000,
      "thumbnail_url": "https://audio.algrow.online/thumbnails/abc123.jpg",
      "url": "https://www.youtube.com/watch?v=abc123",
      "subscriber_count": 85000,
      "similarity_score": 78
    }
  ]
}