---
title: "Get the newest channel or playlist RSS entries"
method: GET
path: "/v1/channels/latest"
tags: ["Discovery"]
---

# Get the newest channel or playlist RSS entries

`GET /v1/channels/latest`

## Request

- Base URL: `https://api.scripthaul.com`
- URL: `https://api.scripthaul.com/v1/channels/latest`
- Auth: HTTP bearer

Zero credits. Supply exactly one channel or playlist. Reads only YouTube public RSS, with a ten-minute cache and at most the newest fifteen entries. Allows 500 requests per free key per UTC day or 5,000 per paid key, including valid feed-cache hits. The allowance is checked before upstream work; exhaustion returns 429 QuotaExceeded with Retry-After until 00:00 UTC. The normal key request rate also applies. A UC ID or a channel URL containing that ID works directly; a handle must already be known from channel resolution. Unknown aliases return 400 channel_resolution_required with resolve_url. Latest uploads never calls a relay or the YouTube Data API and never fetches transcripts. This limited feed is not full channel or playlist enumeration. YouTube returned 404 for a well-formed channel or playlist RSS feed ID. Returns nonretryable NotFound with code feed_not_found; check the ID before retrying. Costs zero credits.

## Query parameters

- `channel` string
- `playlist` string

## Response `200`

Newest RSS entries, up to fifteen; an empty feed has an empty videos array.

- LatestVideos
  - `ok` unknown, required
  - `videos` LatestVideo[], required
    - `video_id` string, required
    - `title` string, required
    - `published_at` string, date-time, required
    - `url` string, uri, required
    - `cached` boolean, required

## Other responses

- `400`: InvalidInput: missing, conflicting, or malformed query parameters. An unknown channel alias on latest uploads returns channel_resolution_required; resolve it first. Costs zero credits.
- `401`: Forbidden: a Bearer API key is missing, malformed, unknown, or revoked. Dashboard cookies cannot authenticate this endpoint. Costs zero credits.
- `403`: AccountFrozen or Forbidden: the account is frozen or the authenticated caller cannot use this route. Costs zero credits.
- `404`: YouTube returned 404 for a well-formed channel or playlist RSS feed ID. Returns nonretryable NotFound with code feed_not_found; check the ID before retrying. Costs zero credits.
- `429`: QuotaExceeded: daily latest-upload allowance (500 free or 5,000 paid requests per key) or key RPM exhausted. Feed-cache hits count. Daily exhaustion returns Retry-After until 00:00 UTC; no upstream work occurs after refusal. Costs zero credits.
- `502`: UpstreamError: the public RSS feed is unavailable, invalid, or exceeds its response-size bound. Costs zero credits.
- `503`: ConfigurationError: required service configuration is unavailable. Costs zero credits.

---

[API](https://skmtc.dev/scripthaul/apis/scripthaul-api.md) · [All operations](https://skmtc.dev/scripthaul/apis/scripthaul-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scripthaul/apis/scripthaul-api/revisions/f476d69f4a6b?raw)