Discovery

Resolve a public channel to its stable IDs

Free channel resolution with cached results. Accepts a handle, a UC ID, or a YouTube /channel/, /user/, or /c/ URL. Legacy /c/ names are resolved as handles. Allows 100 requests per free key per UTC day or 1,000 per paid key. Valid admitted requests count even on warm results, including negative-cache hits. A definitive missing channel returns 404 InvalidInput and is cached for 24 hours across keys by normalized input; repeats use no additional Data API units during that interval. Transient upstream, configuration, and quota failures are not cached as missing channels. 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, and cold resolution obeys the existing Data API capacity guard. Use the returned channel_id for latest uploads and uploads_playlist_id for full enumeration.

get/v1/channels/resolve

Request

  • Base URL: https://api.scripthaul.com
  • URL: https://api.scripthaul.com/v1/channels/resolve
  • Auth: HTTP bearer

Query parameters

inputstring required

Public channel handle, URL, or UC ID.

Response

Resolved public channel.

okunknown required
channel_idstring required
handlestring nullable required

Public channel handle when known.

titlestring required
resolved_fromstring required

The input supplied by the caller.

uploads_playlist_idstring required

The channel uploads playlist ID.

Changes

No recorded changes to this operation across all 1 revision of this API.