/asset
Extended information about a media asset, retrieved by a specific asset id.
Example 1 request:
GET /asset?id=image:366678&api_key=key-XXXXXXXXXXXXX HTTP/1.1
Host: api.dvidshub.net
Accept-encoding: gzip, deflate
User-Agent: Zend_Http_Client
Accept: application/json, text/javascript
Referer: https://api.dvidshub.net
Example 1 response:
HTTP/1.1 200 OK
Content-type: application/json; charset=utf-8
Transfer-encoding: chunked
Connection: keep-alive
Date: Fri, 06 Dec 2024 17:51:47 GMT
Cache-control: no-cache, private
Access-control-allow-origin: *
Server: Apache
Set-cookie: session=expiry=1733508107771677;Max-Age=600;path=/var/lib/php/sessions;domain=yourdomain.com;httpOnly;secure;
Content-encoding: gzip
Vary: accept-encoding
X-cache: Miss from cloudfront
Via: 1.1 f05e3afde72874082b3c4e5699bc66ba.cloudfront.net (CloudFront)
X-amz-cf-pop: IAD12-P4
Alt-svc: h3=":443"; ma=86400
X-amz-cf-id: JMYfRtIlTL9qDQX2iIg4LCtSXj46DnLHKstSRLuR__WMNqs-Tm9SMQ==
{
"results":{
"id":"image:366678",
"title":"Tanks",
"description":"A U.S. Marine Corps M1A1 Abrams Tank with 2nd Tank Platoon, Delta Company, 1st Tank Battalion, attached to Battalion Landing Team 3\/8, 26th Marine Expeditionary Unit, Regimental Combat Team 2, provides over watch out across the desert at Combat Outpost Ouellette, Helmand province, Afghanistan, Jan. 30. Delta Company, 1st Tank Battalion, was the first U.S. tank company to deploy to Afghanistan Elements of the 26th Marine Expeditionary Unit deployed to Afghanistan to provide regional security in Helmand province in support of the International Security Assistance Force.",
"keywords":"NATO, 26th MEU, Fire Support, International Security Assistance Force, joint operations, ISAF, artillery, Joint Task Force, BLT 3\/8, Battalion Landing Team 3\/8",
"date_published":"2011-02-13T11:18:00-05:00",
"date":"2011-01-30T00:00:00-05:00",
"unit_name":"26th Marine Expeditionary Unit",
"branch":"Marines",
"timestamp":"2024-06-05T11:26:43-04:00",
"image":"https:\/\/d34w7g4gy10iej.cloudfront.net\/photos\/1102\/366678.jpg",
"thumbnail":"https:\/\/d1ldvf68ux039x.cloudfront.net\/thumbs\/photos\/1102\/366678\/122x92_q95.jpg",
"url":"https:\/\/www.dvidshub.net\/image\/366678\/tanks",
"credit":[
{
"id":1046562,
"name":"Christopher Matt",
"rank":"Master Sgt.",
"url":"https:\/\/www.dvidshub.net\/portfolio\/1046562"
}
],
"location":{
"city":"Combat Outpost Ouellette",
"state":"",
"country":"Afghanistan",
"country_abbreviation":"AF"
},
"dimensions":{
"width":"4080",
"height":"2720"
},
"rating":3,
"virin":"110130-M-4471M-045"
}
}
Example 2 request:
GET /asset?id=video:284392&api_key=key-XXXXXXXXXXXXX HTTP/1.1
Host: api.dvidshub.net
Accept-encoding: gzip, deflate
User-Agent: Zend_Http_Client
Accept: application/json, text/javascript
Referer: https://api.dvidshub.net
Example 2 response:
HTTP/1.1 200 OK
Content-type: application/json; charset=utf-8
Transfer-encoding: chunked
Connection: keep-alive
Date: Fri, 06 Dec 2024 17:51:47 GMT
Cache-control: no-cache, private
Access-control-allow-origin: *
Server: Apache
Set-cookie: session=expiry=1733508107901191;Max-Age=600;path=/var/lib/php/sessions;domain=yourdomain.com;httpOnly;secure;
Content-encoding: gzip
Vary: accept-encoding
X-cache: Miss from cloudfront
Via: 1.1 a85e1510327226089dfd77f1b1c39ad8.cloudfront.net (CloudFront)
X-amz-cf-pop: IAD12-P4
Alt-svc: h3=":443"; ma=86400
X-amz-cf-id: -E46T-7svIfAJmMMueexwn5MSyyGr7P-X8w2le6_Gs7Atb_I2_rk2A==
{
"results":{
"id":"video:284392",
"type":"video",
"title":"Walt Peters - Ramblin' Country Man",
"description":"U.S. Army Staff Sergeant (Retired) Walt Peters supports Soldiers and Veterans with his music and generosity. Walt was part of the All Soldier Band of which George Strait was also a member. Walt is an inspiration to people he meets in many walks of life. Walt is nearly blind now because of diabetes, but that doesn't stop him from helping to take care of homeless Veterans as well as blind Veterans. His band, The Ramblin' Country Band, uses many of its proceeds to support Walt in his endeavors for the troops in the greater Savannah, Georgia area. Includes interview with Mickey Huggins, Lead Singer & Rhythm Guitarist - Ramblin' Country Band. Also available in high definition.",
"keywords":"guitar, Veteran, Fort Stewart, 3rd Infantry Division, Homeless veterans, savannah, Vietnam veteran, soldiers, 3rd ID, 2nd Brigade Combat Team, music, Hunter Army Airfield, 2 BCT, support soldiers, Blind Veterans, Walt Peters, All Soldier Band, Ramblin' Country Band, George Strait",
"date_published":"2013-03-19T00:57:42-04:00",
"date":"2013-01-11T00:00:00-05:00",
"category":"Package",
"unit_id":"23",
"unit_name":"2nd Armored Brigade Combat Team, 3rd Infantry Division Public Affairs",
"branch":"Army",
"timestamp":"2021-10-06T20:29:46-04:00",
"image":"https:\/\/d1ldvf68ux039x.cloudfront.net\/thumbs\/frames\/video\/1303\/284392\/2000w_q95.jpg",
"url":"https:\/\/www.dvidshub.net\/video\/284392\/walt-peters-ramblin-country-man",
"credit":[
{
"id":1157593,
"name":"Stephen Dornbos",
"rank":"Sgt.",
"url":"https:\/\/www.dvidshub.net\/portfolio\/1157593"
}
],
"location":{
"city":"Savannah",
"state":"Georgia",
"country":"United States",
"state_abbreviation":"GA",
"country_abbreviation":"US"
},
"rating":5,
"time_start":4.1374700000000004,
"virin":"130319-A-FW223-001",
"duration":396,
"aspect_ratio":"16:9",
"files":[
{
"src":"https:\/\/d34w7g4gy10iej.cloudfront.net\/video\/1303\/DOD_100765434\/DOD_100765434-486x274-300k.mp4",
"type":"video\/mp4",
"height":274,
"width":486,
"size":18307252,
"bitrate":300
},
{
"src":"https:\/\/d34w7g4gy10iej.cloudfront.net\/video\/1303\/DOD_100765434\/DOD_100765434-720x406-800k.mp4",
"type":"video\/mp4",
"height":406,
"width":720,
"size":43075778,
"bitrate":800
},
{
"src":"https:\/\/d34w7g4gy10iej.cloudfront.net\/video\/1303\/DOD_100765434\/DOD_100765434-720x406-1500k.mp4",
"type":"video\/mp4",
"height":406,
"width":720,
"size":77484637,
"bitrate":1500
},
{
"src":"https:\/\/d34w7g4gy10iej.cloudfront.net\/video\/1303\/DOD_100765434\/DOD_100765434-1280x720-3000k.mp4",
"type":"video\/mp4",
"height":720,
"width":1280,
"size":152515502,
"bitrate":3000
},
{
"src":"https:\/\/d34w7g4gy10iej.cloudfront.net\/video\/1303\/DOD_100765434\/DOD_100765434.mp4",
"type":"video\/mp4",
"height":720,
"width":1280,
"size":469871403,
"bitrate":9173
}
],
"hls_url":"https:\/\/api.dvidshub.net\/hls\/video\/284392.m3u8?api_key=key-XXXXXXXXXXXXX",
"closed_caption_urls":{
"srt":"https:\/\/api.dvidshub.net\/closed-captions\/get?asset_id=video:284392&format=srt&api_key=key-XXXXXXXXXXXXX",
"webvtt":"https:\/\/api.dvidshub.net\/closed-captions\/get?asset_id=video:284392&format=webvtt&api_key=key-XXXXXXXXXXXXX"
},
"thumbnail":{
"url":"https:\/\/d1ldvf68ux039x.cloudfront.net\/thumbs\/frames\/video\/1303\/284392\/122x92_q95.jpg",
"width":122,
"height":92
}
}
}
/asset/related
Basic information about media assets, related to the asset specified, filtered and sorted according to parameters.
Example request:
GET /asset/related?id=video:284392&max_results=2&api_key=key-XXXXXXXXXXXXX HTTP/1.1
Host: api.dvidshub.net
Accept-encoding: gzip, deflate
User-Agent: Zend_Http_Client
Accept: application/json, text/javascript
Referer: https://api.dvidshub.net
Example response:
HTTP/1.1 200 OK
Content-type: application/json; charset=utf-8
Transfer-encoding: chunked
Connection: keep-alive
Date: Fri, 06 Dec 2024 17:51:48 GMT
Cache-control: no-cache, private
Access-control-allow-origin: *
Server: Apache
Set-cookie: session=expiry=1733508108102598;Max-Age=600;path=/var/lib/php/sessions;domain=yourdomain.com;httpOnly;secure;
Content-encoding: gzip
Vary: accept-encoding
X-cache: Miss from cloudfront
Via: 1.1 a85e1510327226089dfd77f1b1c39ad8.cloudfront.net (CloudFront)
X-amz-cf-pop: IAD12-P4
Alt-svc: h3=":443"; ma=86400
X-amz-cf-id: S8l1TqXeoRjY6w8IAueMKW2nXYenqZ2ajWTte-KMtoRb-G7CaEnpLg==
{
"page_info":{
"total_results":1000,
"results_per_page":2
},
"results":[
{
"publishdate":"2014-07-17T16:23:51Z",
"date":"2014-07-15T04:00:00Z",
"width":2226,
"height":1252,
"aspect_ratio":"landscape",
"title":"Walt Sides: Retired Marine larger than life, louder than thunder",
"id":"image:1451472",
"type":"image",
"keywords":"Veteran, P.O.W., M.I.A., Rolling Thunder, Washington, Marine Corps Scout Snipers, Walt Sides",
"rating":3,
"country":"Vietnam",
"unit_name":"Defense Media Activity - Marines",
"branch":"Joint",
"timestamp":"2024-01-13T23:25:08.997Z",
"short_description":"Walt Sides poses for a photo while on deployment in...",
"thumbnail":"https:\/\/d1ldvf68ux039x.cloudfront.net\/thumbs\/photos\/1407\/1451472\/122x92_q95.jpg",
"url":"https:\/\/www.dvidshub.net\/image\/1451472\/walt-sides-retired-marine-larger-than-life-louder-than-thunder",
"date_published":"2014-07-17T16:23:51Z"
},
{
"publishdate":"2020-03-31T05:04:47Z",
"date":"2020-03-29T04:00:00Z",
"category":"Video Productions",
"aspect_ratio":"16:9",
"duration":133,
"hd":true,
"title":"3rd Marine Division Vietnam Heroes.",
"id":"video:744837",
"type":"video",
"keywords":"general, 3rd Marine Division, heroes, Veteran's Day, History Channel, reading a book, Sgt.Maj., history, Vietnam, WWII, Silver Star, 1st Marine Raiders Battalion, Navy Cross recipient, 3rdMarDiv, ACMC, Lewis Walt, Tulagi, veterans #veterans, Walt hall",
"credit":"Sgt Kallahan Morris",
"country":"Japan",
"state":"Okinawa",
"unit_name":"3d Marine Division",
"branch":"Marines",
"timestamp":"2024-06-26T23:29:47.461Z",
"short_description":"U.S. Marine Corps Sgt.Maj. Dennis M. Bradley, 3rd Marine...",
"thumbnail":"https:\/\/d1ldvf68ux039x.cloudfront.net\/thumbs\/frames\/video\/2003\/744837\/122x92_q95.jpg",
"url":"https:\/\/www.dvidshub.net\/video\/744837\/3rd-marine-division-vietnam-heroes",
"date_published":"2020-03-31T05:04:47Z"
}
]
}
publishdate
: Date in ISO8601 format of when the asset was published at DVIDS. This field is deprecated and will be removed in a later version of the api. Use date_published instead
Notes: Thumbnails are created on first load. Subsequent request will use cache. Use on larger result sets will take longer to run the first time.
publishdate
: Date in ISO8601 format of when the asset was published at DVIDS. This field is deprecated and will be removed in a later version of the api. Use date_published instead