/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
Vary: Accept-Encoding
Date: Wed, 31 May 2023 23:40:29 GMT
Server: Apache
Access-control-allow-origin: *
Content-encoding: gzip
X-cache: Miss from cloudfront
Via: 1.1 076da3643179565aba2eda873738d6b6.cloudfront.net (CloudFront)
X-amz-cf-pop: IAD66-C1
X-amz-cf-id: p4igDpa1yNy12n2NFEKbeeY3m2VOzkD2LoDVPjwkDgedZ5AMOdtGHg==
{
"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":"2021-07-27T06:22:53-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
Vary: Accept-Encoding
Date: Wed, 31 May 2023 23:40:29 GMT
Server: Apache
Access-control-allow-origin: *
Content-encoding: gzip
X-cache: Miss from cloudfront
Via: 1.1 063f496e2a2a07219bf3fbec39d54de4.cloudfront.net (CloudFront)
X-amz-cf-pop: IAD66-C1
X-amz-cf-id: lBIzIt2tihkIbESreC7AwUdVAaacQlRknS06Fq64Y5O09sCWahEPRw==
{
"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
Vary: Accept-Encoding
Date: Wed, 31 May 2023 23:40:30 GMT
Server: Apache
Access-control-allow-origin: *
Content-encoding: gzip
X-cache: Miss from cloudfront
Via: 1.1 b940a336a13496ed7f3754168211e15a.cloudfront.net (CloudFront)
X-amz-cf-pop: IAD66-C1
X-amz-cf-id: l3HKp_e3b_sfbXAaBBC73BTjAom8tluSfJT_0b_9un2PIgOk274V_g==
{
"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",
"city":"",
"unit_name":"Defense Media Activity - Marines",
"branch":"Marines",
"timestamp":"2021-07-27T06:36:11.661Z",
"short_description":"Walt Sides poses for a photo while on deployment in...",
"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":"2018-11-27T20:50:06Z",
"date":"2018-11-08T05:00:00Z",
"category":"Package",
"aspect_ratio":"16:9",
"duration":157,
"hd":true,
"title":"Disney and Veterans",
"id":"video:638996",
"type":"video",
"keywords":"disney, dgov",
"credit":"Robert Buchwald",
"country":"United States",
"state":"Florida",
"city":"Orlando",
"unit_name":"Defense.gov",
"branch":"Joint",
"timestamp":"2021-09-08T20:03:04.817Z",
"short_description":"America's military veterans bring many skills to the...",
"thumbnail":"https:\/\/cdn.dvidshub.net\/media\/thumbs\/frames\/video\/1811\/638996\/122x92_q95.jpg",
"url":"https:\/\/www.dvidshub.net\/video\/638996\/disney-and-veterans",
"date_published":"2018-11-27T20:50:06Z"
}
]
}
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