G-g-core
Restreams

Get all restreams

Changed on

Returns a list of all restreams created in your account

get/streaming/restreams

Request

  • Base URL
    https://api.gcore.com
  • URL
    https://api.gcore.com/streaming/restreams
  • Auth
    HTTP apikey

Query parameters

pageinteger

Use it to list the paginated content

Response

Successful

namestring

Restream name

liveboolean

Indicates that the stream is being published. Has two possible values:

  • true — stream is being published
  • false — stream isn't published
activeboolean

Enables/Disables restream. Has two possible values:

  • true — restream is enabled and can be started
  • false — restream is disabled.

Default is true

uristring

A URL to push the stream to. Supported protocols: rtmp, rtmps, srt. For SRT target URLs, only mode=caller is supported.

stream_idinteger

ID of the stream to restream

client_user_idinteger

Custom field where you can specify user ID in your system

no_audioboolean

Removes the source audio track from the restream. Has two possible values:

  • false – the source audio track is forwarded to the target as is (default)
  • true – the audio track is removed or replaced, depending on no_audio_mode

Useful to avoid copyright claims on platforms like YouTube when the source stream contains licensed music or other copyrighted audio.

Only strict boolean values (true/false) are accepted; any other value returns a 422 error.

no_audio_mode'drop' | 'silence'

Defines how the audio track is handled when no_audio is true. Ignored when no_audio is false.

Types:

  • "drop" – removes the audio track entirely.
  • "silence" – replaces the audio track with a silent track instead of removing it.

Note: YouTube rejects incoming streams with no audio track at all. Use no_audio_mode=silence when restreaming to YouTube.

source'original' | 'transcoded'

Selects which version of the stream is used as the source for the restream.

Types:

  • "original" – uses the original ingested stream without any modifications (default).
  • "transcoded" – uses the transcoded output, including overlays. Use it when you want to restream the stream with enabled overlays.

Note: For transcoded, the highest quality available in the stream's quality ladder is used. For example, if the ladder is 480p/720p/1080p, 1080p is used; if the ladder goes up to 4K, 4K is used.

idinteger

Restream ID

client_idinteger

Client ID

playlist_idinteger nullable

ID of the playlist used as source for the restream, if applicable

quality_idinteger nullable

ID of the specific transcoded quality used as source for the restream, if applicable

Example response

[
  {
    "id": 287834,
    "name": "Live Stream to Youtube 2024-06-21",
    "live": false,
    "active": true,
    "client_id": 102748,
    "uri": "rtmp://a.rtmp.youtube.com/live2/6w4g-9cw7-62dh-c6se-b4hq",
    "stream_id": 1439046,
    "playlist_id": null,
    "client_user_id": 1000,
    "quality_id": null,
    "source": "transcoded"
  }
]

Changes

  • e39aa177017fRevision changes
    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added subschema #2 to the response property allOf list for the response status