# Algrow API

> YouTube channel intelligence and AI media generation platform. Provides channel search, viral video discovery, thumbnail similarity search, text-to-speech, AI image/video generation, YouTube channel scraping, and terminated channel data via a REST API.

## Docs

- [Authentication](https://algrow.online/api/docs#auth): API key setup and authentication methods
- [Text-to-Speech](https://algrow.online/api/docs#generate): Generate AI voiceovers with 1000+ voices
- [Voice Management](https://algrow.online/api/docs#voice-management): Clone and manage custom voices
- [Studio](https://algrow.online/api/docs#media-generation): Caption removal, watermark removal, image and video generation
- [YouTube Scraper](https://algrow.online/api/docs#youtube-scraper): Scrape video data from any YouTube channel or video
- [Terminated Channels](https://algrow.online/api/docs#terminated-channels-search): Search terminated/deleted YouTube channels with growth metrics
- [Thumbnail Search](https://algrow.online/api/docs#thumbnail-search): Visual similarity search across longform channel videos
- [Terminated Thumbnail Search](https://algrow.online/api/docs#terminated-thumbnail-search): Visual similarity search across terminated/deleted channel videos
- [Full API Reference](https://algrow.online/llms-full.txt): Complete API documentation in plain text

## Endpoints

### Search
- GET /api/channels/search: Search Shorts channels by keyword, @handle, channel URL, or video URL
- GET /api/longform-channels/search: Search Longform channels with monetization and duration filters
- GET /api/viral-videos/search: Find viral or similar videos by text query or video_url across Shorts and Longform
- GET /api/terminated-channels/search: Search terminated/deleted YouTube channels
- GET /api/channel-trends: Browse top-growing Shorts or longform channels by 24h / 48h / 7d view or sub deltas

### Thumbnail Search
- POST /api/thumbnail-search: Find longform videos by visual thumbnail similarity (image URL, video URL, or text query)
- POST /api/terminated-thumbnail-search: Find terminated channel videos by visual thumbnail similarity

### YouTube Scraper
- POST /api/youtube-scraper: Scrape video data, transcripts, and comments from a YouTube channel or video
- GET /api/youtube-scraper/{job_id}: Poll scraper job status and retrieve results

### Generation
- POST /api/generate-simple: Generate text-to-speech audio (ElevenLabs or Stealth provider)
- POST /api/generate-image: Generate AI images from text prompts
- POST /api/generate-video: Generate AI videos from text prompts (Sora, Kling, Veo, Grok)
- POST /api/caption-remover: Remove captions and watermarks from a video
- POST /api/sora-watermark-remover: Remove the Sora watermark from a video

### Voices
- GET /api/voices: Browse ElevenLabs TTS voices
- GET /api/voices/stealth: Browse Stealth TTS voices
- POST /api/voices/clone: Clone a voice from an audio sample
- DELETE /api/voices/stealth/{voice_id}: Delete a cloned Stealth voice

### Jobs
- GET /api/job-status/{job_id}: Check generation job status and retrieve output URLs
- GET /api/jobs: List recent generation jobs
- GET /api/health: Check API health and view current job counts

### Utility
- POST /api/upload-text: Upload text content and get a hosted URL
- POST /api/channels/resolve: Resolve a @handle, channel URL, or video URL to a channel ID

## Optional

- [Rate Limits](https://algrow.online/api/docs#rate-limits): Request limits per plan
- [Credits & Billing](https://algrow.online/api/docs#credits): Credit costs for AI generations
- [Error Handling](https://algrow.online/api/docs#errors): Error codes and troubleshooting
- [Code Examples](https://algrow.online/api/docs#examples): Python, JavaScript, and Bash examples