Algrow
Shorts Channels
Channel Processing
Process channels into the Algrow database.
On-demand pipeline for ingesting a single YouTube channel into Algrow's database. Submits a job to a dedicated worker that scrapes the channel and writes the result back. Use when a channel isn't yet in Algrow or you want fresh data right now instead of waiting for the next scheduled batch.
Add (ingest) a YouTube channel into Algrow's database. Call this directly whenever the user says "add this channel", "ingest", "import", "populate", "this channel isn't in algrow yet", or asks to refresh a channel. Also call proactively right after a search/trends tool reports a channel isn't indexed and the user wants it. Returns immediately with a job_id and status: queued; then poll get_channel_processing_status until status is completed or failed. Typical wait is 30s–2min depending on channel size.
| Parameter | Type | Default | Description |
|---|---|---|---|
| channel | string | required | Channel identifier — UC... ID, @handle, channel URL, or any video URL from that channel. |
| type | string | required | Which processor to run: shorts or longform. The caller must choose — there is no auto-detection. |
| idempotency_key | string | null | Optional caller-supplied key. If a job with this key already exists, that existing job is returned instead of a new one being queued. |
Check whether a channel ingestion job (queued via process_channel) has finished, and read its result. Supports server-side long-polling via wait_seconds (default 30) — the server holds the connection open and returns the moment the worker finishes, so one tool call usually replaces a polling loop. Once completed, the channel is in Algrow's database and any other Algrow tool (search, trends, channel data) will see it.
| Parameter | Type | Default | Description |
|---|---|---|---|
| job_id | integer | required | Job ID returned from process_channel. |
| wait_seconds | integer | 10 | Server-side long-poll. The server holds the connection open and returns the moment the job finishes, or after this many seconds elapse. Capped at 30. Default 30 — leave it. One call with wait_seconds=30 usually replaces a polling loop. |