Skip to main content

Get Stream Details

'get_streams'get_stream' will return the details for alla streamsspecific stream in your cluster. You can supply either 'stream_guid' or 'hls_guid' to identify the correct stream.

curl -X POST "https://zeuscluster.com/api/?auth=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX&c=get_streamsget_stream" \ 
    -d "stream_guid=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
curl -X POST "https://zeuscluster.com/api/?auth=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX&c=get_stream" \ 
    -d "hs_guid=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
{
    "status": "success",
    "data": [
        {
            "added": 1728714451,
            "updated": 1729655474,
        "cluster_guid": "ac9c6f8b-976a-e5fc-deed-8be11a75b67f"dfb2101b-3164-1385-2060-c720ac07e774",
        "stream_guid": "e5f52fe2-7468-17b9-f11a-5c18755e000d"2af604b4-3166-c1a9-4de6-a7adf89b5458",
        "status": "offline"online",
        "live_stream_last_updated": 0,1730763602,
        "is_banned": "no",
        "deleted": "no",
        "name": "Example Stream 1"Stream",
        "rtmp_guid": "d5d9c143-dbe6-6e44-b10c-ffd7861178e6"bb72853c-060b-4938-9adf-2a53274ec642",
        "hls_guid": "310d6eed-f7a7-7650-4a80-741caa6e4a05"cac3e1f1-b7a5-4cc8-8b40-890291afb718",
        "publisher_ip": ""1.2.3.4",
        "ingress_server_guid": ""58108a79-d9c0-fbaa-a30a-0463f73e1f40",
        "transcoder_server_guid": "",
            "rtmp_ffmpeg_pid": "0"42bbff07-a91a-88ea-129a-a86a089bb338",
        "record_stream": "no"yes",
        "stream_start_time": 0,1730449045,
        "is_high_risk": "no",
        "ai_monitor": "no"yes",
        "trigger_score": "0",
        "notes": "",
        "runtime"hls_stream": "https://watch.example.com/hls/cac3e1f1-b7a5-4cc8-8b40-890291afb718.m3u8",
        "
        },transcoding_server": {
            "added": 1728714741,
            "updated": 0,
            "cluster_guid"server_guid": "ac9c6f8b-976a-e5fc-deed-8be11a75b67f"42bbff07-a91a-88ea-129a-a86a089bb338",
            "stream_guid"role": "d2ab6831-0b66-271a-f398-ffe3571c1947"2",
            "status": "offline"online",
            "live_stream_last_updated"name": "Trans 01",
            "hostname": "trans-01.dev.us.example.com",
            "hostname_match": "yes",
            "ip_addresses": "[\"10.254.206.32\"]",
            "wan_ip_address": "1.2.3.4",
            "http_stream_port": 80,
            "uptime": 2426789,
            "connection_speed": 1000,
            "cpu_usage": "22.50",
            "ram_usage": "3.72",
            "disk_usage": "2.00",
            "bandwidth_down": "321",
            "bandwidth_up": "10",
            "lat": "",
            "lng": "",
            "country_code": "",
            "country_name": "",
            "region_name": "",
            "city": "",
            "zip_code": "",
            "time_zone": "",
            "os_version": "Ubuntu 24.04.1 LTS",
            "gpu_stats": "",
            "cpu_model": "Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz",
            "cpu_cores": "16",
            "cpu_speed": "2992.968",
            "ram_total": "32862924",
            "kernel": "6.8.0-45-generic",
            "active_connections": 12,
            "notes": null,
            "version": "3.0.0",
            "ffmpeg_active_streams": 0,
            "is_banned": "no",
            "deleted": "no",
            "name"recording_storage_total": "Example639.09 Stream 2"TB",
            "rtmp_guid"recording_storage_free": "9ad8068a-1719-6b9c-c8be-6449ef06c594"638.77 TB",
            "hls_guid"recording_storage_used": "4608d516-92cd-af30-f5dd-966951431f6f"332.76 GB"
        },
        "publisher_ip"historical_streams": [
            {
                "stream_stats_guid": "",
            "ingress_server_guid": "",
            "transcoder_server_guid": "",
            "rtmp_ffmpeg_pid": "0",
            "record_stream": "no"ecbf8338-3418-5fb8-2ac4-9bfe9e2cd013",
                "stream_start_time": 1730432033,
                "stream_stop_time": 1730432152,
                "total_viewers": 0,
                "is_high_risk"peak_viewers": "no",
            "ai_monitor": "no",2,
                "trigger_score": 0,
                "0"video_codec": "h264",
                "notes": null,
            "runtime"video_resolution": ""
        }1080x1920",
                {
            "added": 1728715265,
            "updated": 0,
            "cluster_guid"video_bitrate": "ac9c6f8b-976a-e5fc-deed-8be11a75b67f"2.7",
                "stream_guid"video_framerate": "63cf0029-4e5c-3fbb-209e-8c8fc18b4237"60",
                "status"audio_codec": "offline"aac",
                "live_stream_last_updated": 0,
            "is_banned"audio_sample_rate": "no"48000",
                "deleted"audio_bitrate": "no"0.2",
                "name"recording_name": "Example Stream 3"bac3e1f1-b7a5-4cc8-8b40-890291afb718-1730432036.mp4",
                "rtmp_guid"recording_size": "47a3de96-8fb1-8817-d6ca-187c60429a0c"37.17 MB",
                "hls_guid"recording_hls_guid": "5e0d09b8-9a05-dd5e-aca0-70c5f0bd208b"bac3e1f1-b7a5-4cc8-8b40-890291afb718",
                "publisher_ip"recording_timestamp": 1730432036,
                "recording_server_guid": ""50bdd0f5-7f82-f0d8-cd0f-ab66e101f964",
                "ingress_server_guid"mp4_stream": ""https://watch.example.com/recording/ecbf8338-3418-5fb8-2ac4-9bfe9e2cd013",
                "transcoder_server_guid"mp4_download": "",
            "rtmp_ffmpeg_pid": "0",
            "record_stream": "no",
            "stream_start_time": 0,
            "is_high_risk": "no",
            "ai_monitor": "no",
            "trigger_score": "0",
            "notes": null,
            "runtime": ""https://watch.example.com/recording/ecbf8338-3418-5fb8-2ac4-9bfe9e2cd013&download=yes"
            }
        ]
    }
}