Live API

GET /live/list

List of live events

Example request:

GET /live/list?max_results=2&api_key=key-XXXXXXXXXXXXX HTTP/1.1
Host: api.dvidshub.net
Accept-encoding: gzip, deflate
Accept: application/json, text/javascript
Referer: https://api.dvidshub.net

Example response:

HTTP/1.1 200 OK
Content-type: application/json; charset=utf-8
Server: Apache
Access-control-allow-origin: *
Content-encoding: gzip
Content-length: 546
Date: Sun, 23 Jan 2022 12:44:50 GMT
Connection: keep-alive
Vary: Accept-Encoding

{
    "results":[
        {
            "type":"live_webcasts",
            "id":"27974",
            "title":"Meet Your Army Olympians ",
            "description":"Meet Your Army Olympians.",
            "hashtag":"",
            "begin":"2022-01-25T23:50:00+00:00",
            "end":"2022-01-26T01:30:00+00:00",
            "url":"https:\/\/www.dvidshub.net\/webcast\/27974",
            "hls_url":"https:\/\/live-cdn.dvidshub.net\/webcast\/27974\/master.m3u8",
            "unit_id":"361"
        },
        {
            "type":"live_webcasts",
            "id":"27942",
            "title":"DINFOS Live Episode 09: Evaluation Step of RPIE",
            "description":"Host Chad McMeen will join Marine Corps DINFOS instructor Capt. Dave Morris to continue our look into the RPIE (research, planning, implementation, and evaluation) process of communication planning. Specifically, the episode will focus on the evaluation step of RPIE and how the public affairs\/communication strategy professional can determine if their communication efforts are\/were successful.",
            "hashtag":"",
            "begin":"2022-01-26T18:35:00+00:00",
            "end":"2022-01-26T20:30:00+00:00",
            "url":"https:\/\/www.dvidshub.net\/webcast\/27942",
            "hls_url":"https:\/\/live-cdn.dvidshub.net\/webcast\/27942\/master.m3u8",
            "unit_id":"318"
        }
    ],
    "current_time":"2022-01-23T12:44:50+00:00"
}

Query Parameters:

• api_key: Public API access key issued by DVIDS (key-xxxxxxxxxxxxx)
• from_date: Specify a date/time in ISO8601 format to return events newer than from_date
• has_video_id: [1] If set only return events that have a video_id associated with it
• hashtag: If set only return events with that hashtag specified
• max_results: [1-50] Maximum number of results to return per page. Default and maximum value are both 50.
• prettyprint: [1] Spaces out JSON response in more readable format useful for debugging
• sort: One of begin, end
• sortdir: One of asc, desc
• thumb_width: [1-2000] Width of thumbnail in pixels. If thumb_height is provided, this defaults to the aspect ratio native width of the asset relative to the height requested. Otherwise the resolution is 122x92. Max of 2000.
• thumb_height: [1-2000] Height of thumbnail in pixels. If thumb_width is provided, this defaults to the aspect ratio native height of the asset relative to the width requested. Otherwise the resolution is 122x92. Max of 2000.
• thumb_quality: [1-100] Quality of generated thumbnail. Default is 95
• to_date: Specify a date/time in ISO8601 format to return events older than to_date
• include_snippets: [0,1] default 0, include external live event HTML snippets such as embed codes

Status Codes:

• 200: no error
• 400: invalid parameter(s) specified. See errors element in response for details.
• 403: api_key not provided, invalid, or accessed from origin (protocol+domain) other than the one associated with the key provided.

Response Fields:

• id: Id of the live event
• type: Type of live event (live_webcast, snippets)
• begin: Date/time event starts in ISO8601 format
• current_time: Current server date/time in ISO8601 format. Useful for calculating time offset between server and client to provide time sync
• description: Event description
• end: Date/time event ends in ISO8601 format
• thumbnail: [array] Resized image of event poster as specified by thumb_XXX params
• url: Url to asset on dvidshub.net
• video_id: Returned if the live event has been linked to a video asset

GET /live/get

Get additional details about live event including links to feed(s)

Example request:

GET /live/get?id=3852&api_key=key-XXXXXXXXXXXXX HTTP/1.1
Host: api.dvidshub.net
Accept-encoding: gzip, deflate
Accept: application/json, text/javascript
Referer: https://api.dvidshub.net

Example response:

HTTP/1.1 200 OK
Content-type: application/json; charset=utf-8
Server: Apache
Access-control-allow-origin: *
Content-encoding: gzip
Content-length: 441
Date: Sun, 23 Jan 2022 12:44:50 GMT
Connection: keep-alive
Vary: Accept-Encoding

{
    "current_time":"2022-01-23T12:44:50+00:00",
    "results":{
        "id":"3852",
        "title":"US Department of State Press Briefing",
        "description":"Marie Harf, US Department of State Deputy Spokesperson, will deliver the daily press briefing. Feed begins at 1:30 PM EDT.  *** Time subject to change.",
        "begin":"2014-04-03T17:25:00+00:00",
        "end":"2014-04-03T19:48:00+00:00",
        "hls_url":"https:\/\/api.dvidshub.net\/hls\/live\/3852.m3u8?api_key=key-XXXXXXXXXXXXX&dvrTime=1396545900",
        "thumbnail":{
            "url":"https:\/\/cdn.dvidshub.net\/media\/thumbs\/frames\/video\/1404\/326950\/122x92_q95.jpg",
            "width":122,
            "height":92
        },
        "url":"https:\/\/www.dvidshub.net\/webcast\/3852",
        "video_id":"326950",
        "unit_id":"127"
    }
}

Query Parameters:

• api_key: Public API access key issued by DVIDS (key-xxxxxxxxxxxxx)
• fields: Comma separated list of which fields to return
• id: [int] Id of of the live event
• prettyprint: [1] Spaces out JSON response in more readable format useful for debugging
• thumb_width: [1-2000] Width of thumbnail in pixels. If thumb_height is provided, this defaults to the aspect ratio native width of the asset relative to the height requested. Otherwise the resolution is 122x92. Max of 2000.
• thumb_height: [1-2000] Height of thumbnail in pixels. If thumb_width is provided, this defaults to the aspect ratio native height of the asset relative to the width requested. Otherwise the resolution is 122x92. Max of 2000.
• thumb_quality: [1-100] Quality of generated thumbnail. Default is 95
• video_id: Returned if the current event has been linked to a video asset

Status Codes:

• 200: no error
• 400: invalid parameter(s) specified. See errors element in response for details.
• 403: api_key not provided, invalid, or accessed from origin (protocol+domain) other than the one associated with the key provided.

Response Fields:

• id: Id of the live event
• begin: Date/time event starts in ISO8601 format
• current_time: Current server date/time in ISO8601 format. Useful for calculating time offset between server and client to provide time sync
• description: Event description
• end: Date/time event ends in ISO8601 format
• hls_url: Url to master m3u8 playlist for event
• thumbnail: [array] Resized image of event poster as specified by thumb_XXX params
• url: Url to asset on dvidshub.net
• video_id: Returned if the live event has been linked to a video asset