Skip to main content
POST
Validate Stream
Checks whether a stream URL is valid and currently live, and returns stream metadata plus a parsed playback URL when available. Use this before starting expensive monitoring jobs when you want early feedback on bad URLs.

Typical flow

  1. Validate with POST /streams/validate.
  2. Use parsed_url from the response for frontend playback/preview if needed.
  3. Start Check Once, Live Monitor, or Live Digest.

Notes

  • Main monitoring endpoints can still validate internally.
  • Explicit validation is useful for better UX and pre-flight checks.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request for stream validation.

stream_url
string
required

Stream URL to validate

Required string length: 1 - 500

Response

Successful Response

Rich response for stream validation.

is_live
boolean
required
platform
string | null
stream_id
string | null
title
string | null
channel
string | null
thumbnail_url
string | null
viewer_count
integer | null
parsed_url
string | null
error_hint
string | null