# Quick Start

Connect Algrow to your AI assistant in one minute, or make your first REST call.

## Start in your AI assistant (recommended)

Most people use Algrow through the **MCP server** — every tool in these docs, available in plain conversation inside Claude, ChatGPT, Cursor, and any other MCP client. No code, nothing to install: paste one config and start asking.

#### Open your client

Claude.ai, ChatGPT, Claude Code, Cursor, VS Code, Codex, Windsurf — all supported.

#### Paste the Algrow config

One minute. Claude.ai connects with your Algrow login — no API key needed there.

#### Just ask

“Find me roblox Shorts channels under 50k subs growing fast” — and it works.

- [Connect the MCP server](/docs/mcp)

Setup guides for every client, an install demo video, and example prompts are on the [Setup page](/docs/mcp).

## REST API Quickstart

Get your first audio file in under 60 seconds.

#### Get your API key

Go to **Settings → API Keys** in your Algrow dashboard and generate a key.

#### Submit a job

Send a `POST` to `/api/generate-simple` with your script and voice ID.

#### Get your audio

Poll `/api/job-status/:id` until complete. The response includes a permanent audio URL.

**Try it now**

```
# 1. Submit a generation
curl -X POST "https://api.algrow.online/api/generate-simple" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "script=Hello, welcome to our channel. This is a test of the Algrow TTS API." \
  -F "voice_id=21m00Tcm4TlvDq8ikWAM"

# 2. Poll for completion (replace JOB_ID with the job_id from step 1)
curl "https://api.algrow.online/api/job-status/JOB_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### API Reference

- [AUTH Authentication](/docs/api-keys#auth)

- [DOC Commercial Use](/docs/commercial-use#commercial-use)

Channel Search

- [GET /api/channels/search](/docs/api/channel-research#channels-search)

- [GET /api/longform-channels/search](/docs/api/channel-research#longform-channels-search)

- [GET /api/search](/docs/api/youtube-search#youtube-search)

- [GET /api/channel-trends](/docs/api/channel-research#channel-trends)

Channel Data

- [GET /api/channels/:id/about](/docs/api/channel-data#channel-about)

- [GET /api/channels/:id/daily-analytics](/docs/api/channel-data#channel-daily-analytics)

- [GET /api/channels/:id/videos](/docs/api/channel-data#channel-videos)

- [GET /api/channels/:id/shorts](/docs/api/channel-data#channel-shorts)

- [GET /api/channels/:id/playlists](/docs/api/channel-data#channel-playlists)

Viral Videos

- [GET /api/viral-videos/search](/docs/api/discovery-search#viral-videos-search)

- [GET /api/viral-videos/channel-ideas](/docs/api/discovery-search#viral-videos-channel-ideas)

Terminated Channels

- [GET /api/terminated-channels/search](/docs/api/analysis-tools#terminated-channels-search)

Thumbnail Search

- [POST /api/thumbnail-search](/docs/api/discovery-search#thumbnail-search)

- [POST /api/terminated-thumbnail-search](/docs/api/discovery-search#terminated-thumbnail-search)

YouTube Scraper

- [POST /api/youtube-scraper](/docs/api/youtube-scraper#youtube-scraper)

- [GET /api/channel-monetization/:channel_id](/docs/api/analysis-tools#channel-monetization)

- [GET /api/channel-cms/:channel_id](/docs/api/analysis-tools#channel-cms)

- [GET /api/cms-networks](/docs/api/analysis-tools#cms-networks)

- [GET /api/youtube-scraper/:job_id](/docs/api/youtube-scraper#youtube-scraper-status)

- [POST /api/youtube-scraper-fast](/docs/api/youtube-scraper#youtube-scraper-fast)

Workspace

- [GET /api/folders](/docs/api/workspace#list-folders)

- [POST /api/folders](/docs/api/workspace#create-folder)

- [PATCH /api/folders/:id](/docs/api/workspace#rename-folder)

- [DEL /api/folders/:id](/docs/api/workspace#delete-folder)

- [GET /api/folders/:id/channels](/docs/api/workspace#folder-channels)

- [POST /api/saved-channels](/docs/api/workspace#save-channels)

- [DEL /api/saved-channels/:id](/docs/api/workspace#unsave-channel)

- [POST /api/saved-channels/move](/docs/api/workspace#move-channel)

Market

- [GET /api/market/orders](/docs/api/market#market-orders)

- [GET /api/market/orders/:id](/docs/api/market#market-order)

- [GET /api/market/orders/:id/code](/docs/api/market#market-order-code)

- [PATCH /api/market/orders/:id](/docs/api/market#market-order-note)

- [GET /api/market/stock](/docs/api/market#market-stock)

Collabs

- [GET /api/collabs/fastest-growing](/docs/api/collabs#collabs-fastest-growing)

- [GET /api/collabs/channels/:channel_id](/docs/api/collabs#collabs-channel)

- [GET /api/collabs/recent](/docs/api/collabs#collabs-recent)

Resolvers

- [POST /api/channels/resolve](/docs/api/workspace#resolve-channel)

Alerts

- [GET /api/alerts](/docs/api/workspace#list-alerts)

- [POST /api/alerts](/docs/api/workspace#create-alert)

- [PATCH /api/alerts/:id](/docs/api/workspace#update-alert)

- [DEL /api/alerts/:id](/docs/api/workspace#delete-alert)

- [GET /api/alerts/triggered](/docs/api/workspace#triggered-alerts)

- [GET /api/alerts/outlier-status](/docs/api/workspace#outlier-status)

Text-to-Speech

- [GET /api/voices](/docs/api/text-to-speech#voices)

- [POST /api/generate-simple](/docs/api/text-to-speech#generate)

- [GET /api/job-status/:job_id](/docs/api/text-to-speech#job-status)

- [GET /api/jobs](/docs/api/text-to-speech#list-jobs)

- [GET /api/voices/stealth](/docs/api/voice-management#list-stealth-voices)

- [POST /api/voices/clone](/docs/api/voice-management#clone-voice)

- [DEL /api/voices/stealth/:voice_id](/docs/api/voice-management#delete-voice)

- [GET /api/voices/minimax](/docs/api/voice-management#list-minimax-voices)

- [POST /api/voices/minimax/clone](/docs/api/voice-management#clone-minimax-voice)

- [DEL /api/voices/minimax/:voice_id](/docs/api/voice-management#delete-minimax-voice)

Media Generation

- [POST /api/caption-remover](/docs/api/media-generation#caption-remover)

- [POST /api/generate-image](/docs/api/media-generation#generate-image)

- [POST /api/generate-video](/docs/api/media-generation#generate-video)

- [POST /api/thumbnails](/docs/api/thumbnails#thumbnails-generate)

- [POST /api/thumbnails/channel-style](/docs/api/thumbnails#thumbnails-channel-style)

- [GET /api/thumbnails/status/:task_id](/docs/api/thumbnails#thumbnails-status)

- [POST /api/thumbnails/outliers](/docs/api/thumbnails#thumbnails-outliers)

- [POST /api/thumbnails/channel-videos](/docs/api/thumbnails#thumbnails-channel-videos)

- [GET /api/thumbnails/saved-channels](/docs/api/thumbnails#thumbnails-saved-channels-list)

- [POST /api/thumbnails/saved-channels](/docs/api/thumbnails#thumbnails-saved-channels-add)

- [DELETE /api/thumbnails/saved-channels/:channel_id](/docs/api/thumbnails#thumbnails-saved-channels-delete)

- [GET /api/thumbnails/instruction-presets](/docs/api/thumbnails#thumbnails-instruction-presets-list)

- [POST /api/thumbnails/instruction-presets](/docs/api/thumbnails#thumbnails-instruction-presets-add)

- [DELETE /api/thumbnails/instruction-presets/:preset_id](/docs/api/thumbnails#thumbnails-instruction-presets-delete)

- [POST /api/thumbnails/extract-video](/docs/api/thumbnails#thumbnails-extract-video)

- [POST /api/thumbnails/analyze](/docs/api/thumbnails#thumbnails-analyze)

- [POST /api/thumbnails/compose](/docs/api/thumbnails#thumbnails-compose)

- [POST /api/thumbnails/compose-channel](/docs/api/thumbnails#thumbnails-compose-channel)

- [GET /api/thumbnails/channel-presets](/docs/api/thumbnails#thumbnails-channel-presets-list)

- [POST /api/thumbnails/channel-presets](/docs/api/thumbnails#thumbnails-channel-presets-add)

- [DELETE /api/thumbnails/channel-presets/:preset_id](/docs/api/thumbnails#thumbnails-channel-presets-delete)

- [GET /api/thumbnails/history](/docs/api/thumbnails#thumbnails-history)

- [POST /api/thumbnails/detect-people](/docs/api/thumbnails#thumbnails-detect-people)

- [POST /api/thumbnails/crop-reference](/docs/api/thumbnails#thumbnails-crop-reference)

- [POST /api/thumbnails/search-faces](/docs/api/thumbnails#thumbnails-search-faces)

- [POST /api/thumbnails/import-face](/docs/api/thumbnails#thumbnails-import-face)

- [POST /api/thumbnails/swap-face](/docs/api/thumbnails#thumbnails-swap-face)

- [POST /api/thumbnails/feedback](/docs/api/thumbnails#thumbnails-feedback)

Video Analysis

- [POST /api/analyze-video](/docs/api/analysis-tools#analyze-video)

- [POST /api/download-video](/docs/api/channel-processing#download-video)

Channel Processing

- [POST /api/process-channel](/docs/api/channel-processing#process-channel)

- [GET /api/process-channel/:job_id](/docs/api/channel-processing#process-channel-status)

Utility

- [GET /api/health](/docs/api/text-to-speech#health)

- [GET /api/credits](/docs/api/text-to-speech#credit-balance)

Reference

- [Rate Limits](/docs/credits#rate-limits)

- [Credits & Billing](/docs/credits#credits)

- [Error Handling](/docs/errors#errors)

- [Code Examples](/docs/api/examples#examples)