/searchBasic information about media assets, filtered and sorted according to parameters.
Example request:
GET /search?q=tank&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.netExample response:
HTTP/1.1 200 OK
Content-type: application/json; charset=utf-8
Transfer-encoding: chunked
Connection: keep-alive
Date: Sat, 22 Feb 2025 19:28:31 GMT
Server: Apache
Access-control-allow-origin: *
X-cache: Miss from cloudfront
Via: 1.1 bf92485080aafccc84ee48a4ab037a64.cloudfront.net (CloudFront)
X-amz-cf-pop: IAD12-P4
Alt-svc: h3=":443"; ma=86400
X-amz-cf-id: arAjbN4EMRh_vys-UoK7X2AzN5H1LF9P2FnaeTt8M6px48rnKErEYw==
{
"page_info":{
"total_results":1000,
"results_per_page":2
},
"results":[
{
"publishdate":"2025-02-21T14:18:07Z",
"date":"2025-02-21T05:00:00Z",
"category":"Package",
"aspect_ratio":"16:9",
"duration":423,
"hd":true,
"title":"Training the next generation of Ukrainian defenders",
"id":"video:953117",
"type":"video",
"keywords":"Natochannel",
"country":"United Kingdom",
"unit_name":"Natochannel",
"branch":"Joint",
"timestamp":"2025-02-21T14:22:05.227Z",
"thumbnail":"https:\/\/d1ldvf68ux039x.cloudfront.net\/thumbs\/frames\/video\/2502\/953117\/DOD_110823871.0000001\/122x92_q95.jpg",
"thumb_width":122,
"thumb_height":92,
"short_description":"Ukraine continues its brave struggle for freedom and independence, aided by crucial military support from NATO Allies.\r\nSynopsis\r\n\r\nUkraine continues its brave fight for freedom and independence, aided by crucial military support from NATO Allies.\r\nIn Lithuania, the army is busy training the next generation of Ukrainian Non-Commissioned Officers \u2013 mid-level enlisted leaders responsible for leading troops into combat \u2013 who will go on to form the backbone of the forces fighting to secure their homeland. In Poland, several NATO Allies are teaching Ukrainian tankers how to use the powerful Leopard 2 main battle tank, which many NATO Allies have donated to the Ukrainian Army, giving them mobility and firepower. And in the United Kingdom, British Army bomb disposal experts are training Ukrainian technicians how to detect and neutralise land mines left behind by Russian forces, as well as unexploded ordnance buried in the soil.\r\nSince the beginning of Russia\u2019s brutal and illegal war of aggression against Ukraine three years ago, in February 2022, NATO Allies and partners have stood firm in their support of Ukraine\u2019s armed forces, as the country continues its heroic efforts to uphold its right to self-defence enshrined in the United Nations Charter.\r\nTranscript\r\n\r\n\u2014SOUNDBITE IN ENGLISH \u2014\r\nEXPLOSIVE ORDNANCE DISPOSAL TRAINER, BRITISH ARMY\r\n\u201cThey're taking on the lessons, fully into it, trying to learn everything they can to take away, to go back, to then fight back on the front lines.\u201d\r\n\u2014VOICEOVER\u2014\r\n\r\n\u201cThree years ago, Russia launched its devastating full-scale invasion of Ukraine. Since then, NATO Allies have been steadfast in supporting the Ukrainian Armed Forces with the weapons and training they need to defend their homeland. Together, they\u2019re helping forge the next generation of Ukrainian soldiers called upon to defend their country.\u201d\r\nTEXT ON SCREEN\r\nTRAINING THE NEXT GENERATION OF UKRAINIAN DEFENDERS\r\n\u2014VOICEOVER\u2014\r\n\u201cArmies need leaders, and not just at the top. While generals make plans and issue orders, leadership in the trenches comes from Non-Commissioned Officers. They are the link between enlisted soldiers and officers, charged with carrying out orders and leading troops into the heat of battle. At the same time, they\u2019re responsible for taking care of their soldiers, giving them guidance and mentorship while enforcing discipline in the ranks.\r\n\r\nThey are evidence of a remarkable transformation in the Ukrainian Army. In years past, Ukrainian enlisted soldiers had to wait for explicit orders from officers before they could act, making for a slower, less efficient force. After Russia\u2019s illegal annexation of Crimea, however, the Ukrainian Army decided to reinvent itself. It intensified its work with NATO Allies, who helped turn Ukraine\u2019s Non-Commissioned Officers from mid-level enlisted troopers into battlefield leaders. This has made for a more flexible force, and in Ukraine\u2019s fight against Russian aggression, it has made all the difference.\r\n\r\nHere in the deep Baltic forests, the Lithuanian Army is training new Ukrainian Non-Commissioned Officers to be effective sergeants, capable of both caring for their soldiers and leading them into battle.\u201d\r\n\r\n\u2014SOUNDBITE IN UKRAINIAN \u2014\r\nNCO TRAINEE, UKRAINIAN ARMY\r\n\u201cThe sergeant participates directly in the life of the unit. He trains them, lives with them, he knows everything about his unit and helps it exist, so to speak. Many lives depend on him.\u201d\r\n\u2014SOUNDBITE IN UKRAINIAN \u2014\r\nNCO INSTRUCTOR, UKRAINIAN ARMY\r\n\u201cYou become a man when you are responsible for someone else. You perceive reality in a completely different way. It\u2019s like you kind of wake up, so to speak.\u201d\r\n\u2014VOICEOVER\u2014\r\n\u201cInfantry sergeants are frontline soldiers, but they\u2019re also tasked with planning operations and deciding which tactics should be used.\u201d\r\n\r\n\u2014SOUNDBITE IN UKRAINIAN \u2014\r\nNCO INSTRUCTOR, UKRAINIAN ARMY\r\n\u201cWhat was good in this particular course from the NATO instructors was the approach to planning the operation and controlling the planning of the operation, bringing us these standard operating procedures in terms of tactical aspects, mechanised tactics, tactics using armoured vehicles, armoured infantry vehicles like the M113.\u201d\r\n\u2014VOICEOVER\u2014\r\n\u201cNCOs who are confident and empowered with decision-making will make the Ukrainian Army more flexible in battle.\u201d\r\n\r\n\u2014SOUNDBITE IN UKRAINIAN \u2014\r\nNCO INSTRUCTOR, UKRAINIAN ARMY\r\n\u201cWar, currently, is characterised by a high intensity of action and a rapid change of circumstances. That is, decisions need to be made by people who are in the thick of things, and who see and participate in precisely these areas where circumstances are changing rapidly. Not in the headquarters, but here.\u201d\r\n\r\n\u2014VOICEOVER\u2014\r\n\u201cAfter Russia invaded Ukraine in February 2022, NATO Allies pledged to support the Ukrainian Army with advanced weaponry. Among the assets promised was one of the Alliance\u2019s strongest tanks: the Leopard 2. Manufactured in Germany and currently in service with 15 NATO Allies, the Leopard is fast and strong, with thick armour to protect its crew during intense combat.\u201d\r\n\r\n\u2014SOUNDBITE IN ENGLISH \u2014\r\nMGEN Piotr Fajkowski, Polish Army\r\n\u201cThe tanks bring the new quality. We saw a lot of movies delivered to us from the Ukrainian side. After being hit twice, three, four times, this tank survived. For Ukrainians, this is the power to win the war.\u201d\r\n\u2014VOICEOVER\u2014\r\n\u201cAllies have donated Leopard 2 tanks of various models to Ukraine since 2023. They\u2019ve also been training the crews needed to operate them. At the Combined Arms Training Centre in Poland, a mission funded by the European Union and staffed by NATO Allies, Ukrainian soldiers are fully trained to fight and operate the Leopard 2.\u201d\r\n\u2014SOUNDBITE IN ENGLISH \u2014\r\nMGEN Piotr Fajkowski, Polish Army\r\n\u201cThe training programme is focused on training the gunner, the driver, the commander of the tank. Then, to make from them the tank crew as the whole.\r\n\r\n\u2014VOICEOVER\u2014\r\n\u201cThe Combined Arms Training Centre doesn\u2019t just train the crews. They also train the maintainers who will be responsible for keeping the tanks up and running on the frontline.\u201d\r\n\u2014SOUNDBITE IN POLISH \u2014\r\nMaintenance Trainer, Polish Army\r\n\u201cAs far as commitment, they are 100 percent. They are motivated and absorb knowledge very well. The situation forces them to study quickly and intensively.\u201d\r\n\u2014VOICEOVER\u2014\r\n\u201cAfter three years of war, Ukraine is littered with landmines and unexploded ordnance. These deadly explosives are a threat to Ukrainian troops and civilians alike. Cleansing the landscape will take years of painstaking work, in war or peace. That\u2019s why the British Army is helping train new Explosive Ordnance Disposal technicians at an undisclosed location in the United Kingdom.\u201d\r\n\r\n\u2014SOUNDBITE IN UKRAINIAN \u2014\r\nEXPLOSIVE ORDNANCE DISPOSAL TRAINEE, UKRAINIAN ARMY\r\n\u201cWe constantly encounter mines because we are on the territory that we had liberated after the departure of Russian soldiers. They have left lots of mines behind. It is a huge problem. At the same time, Russians continue to lay mines all over. Because of that, civilians suffer every day.\u201d\r\n\u2014VOICEOVER\u2014\r\n\u201cDetecting mines means getting low and going slow. Trainees learn how to search the dirt to find mines before they explode. The stress is constant, as any mistake could mean injury or death. But these skills are vital for Ukrainian troops as they continue to defend their homeland.\u201d\r\n\u2014SOUNDBITE IN ENGLISH \u2014\r\nEXPLOSIVE ORDNANCE DISPOSAL TRAINER, BRITISH ARMY\r\n\u201cA lot of them do come straight from the front line. I do respect that they're coming here, they're taking on the lessons, fully into it, trying to learn everything they can to take away, to go back, to then fight back on the frontlines.\u201d\r\n\r\n\u2014VOICEOVER\u2014\r\n\u201cUltimately, Ukraine\u2019s greatest weapon is the courage and willpower of the men and women who have fought on the frontlines since 2022. NATO Allies stood behind them then, and stand behind them now.\u201d\r\n\r\n\r\n\u2014SOUNDBITE IN RUSSIAN \u2014\r\nNCO TRAINEE, UKRAINIAN ARMY\r\n\u201cPersonally, my motivation to continue fighting for my country, for Ukraine, it\u2019s the understanding that I will never have a home anywhere else but in Ukraine, because this is my home, my country.\u201d\r\n\r\nUsage rights\r\nThis video contains Thomson Reuters copyrighted library material licensed by NATO, which cannot be used as part of a new production without consent of the copyright holder. Please contact Thomson Reuters to clear this material.",
"hls_url":"https:\/\/api.dvidshub.net\/hls\/video\/953117.m3u8?api_key=key-XXXXXXXXXXXXX",
"url":"https:\/\/www.dvidshub.net\/video\/953117\/training-next-generation-ukrainian-defenders",
"date_published":"2025-02-21T14:18:07Z"
},
{
"publishdate":"2025-02-21T14:18:07Z",
"date":"2025-02-21T05:00:00Z",
"category":"Package",
"aspect_ratio":"16:9",
"duration":423,
"hd":true,
"title":"Training the next generation of Ukrainian defenders",
"id":"video:953116",
"type":"video",
"keywords":"Natochannel",
"credit":"Elodie Romain",
"country":"United Kingdom",
"unit_name":"Natochannel",
"branch":"Joint",
"timestamp":"2025-02-21T14:22:05.252Z",
"thumbnail":"https:\/\/d1ldvf68ux039x.cloudfront.net\/thumbs\/frames\/video\/2502\/953116\/DOD_110823816.0000001\/122x92_q95.jpg",
"thumb_width":122,
"thumb_height":92,
"short_description":"Ukraine continues its brave struggle for freedom and independence, aided by crucial military support from NATO Allies.\r\nSynopsis\r\n\r\nUkraine continues its brave fight for freedom and independence, aided by crucial military support from NATO Allies.\r\nIn Lithuania, the army is busy training the next generation of Ukrainian Non-Commissioned Officers \u2013 mid-level enlisted leaders responsible for leading troops into combat \u2013 who will go on to form the backbone of the forces fighting to secure their homeland. In Poland, several NATO Allies are teaching Ukrainian tankers how to use the powerful Leopard 2 main battle tank, which many NATO Allies have donated to the Ukrainian Army, giving them mobility and firepower. And in the United Kingdom, British Army bomb disposal experts are training Ukrainian technicians how to detect and neutralise land mines left behind by Russian forces, as well as unexploded ordnance buried in the soil.\r\nSince the beginning of Russia\u2019s brutal and illegal war of aggression against Ukraine three years ago, in February 2022, NATO Allies and partners have stood firm in their support of Ukraine\u2019s armed forces, as the country continues its heroic efforts to uphold its right to self-defence enshrined in the United Nations Charter.\r\nTranscript\r\n\r\n\u2014SOUNDBITE IN ENGLISH \u2014\r\nEXPLOSIVE ORDNANCE DISPOSAL TRAINER, BRITISH ARMY\r\n\u201cThey're taking on the lessons, fully into it, trying to learn everything they can to take away, to go back, to then fight back on the front lines.\u201d\r\n\u2014VOICEOVER\u2014\r\n\r\n\u201cThree years ago, Russia launched its devastating full-scale invasion of Ukraine. Since then, NATO Allies have been steadfast in supporting the Ukrainian Armed Forces with the weapons and training they need to defend their homeland. Together, they\u2019re helping forge the next generation of Ukrainian soldiers called upon to defend their country.\u201d\r\nTEXT ON SCREEN\r\nTRAINING THE NEXT GENERATION OF UKRAINIAN DEFENDERS\r\n\u2014VOICEOVER\u2014\r\n\u201cArmies need leaders, and not just at the top. While generals make plans and issue orders, leadership in the trenches comes from Non-Commissioned Officers. They are the link between enlisted soldiers and officers, charged with carrying out orders and leading troops into the heat of battle. At the same time, they\u2019re responsible for taking care of their soldiers, giving them guidance and mentorship while enforcing discipline in the ranks.\r\n\r\nThey are evidence of a remarkable transformation in the Ukrainian Army. In years past, Ukrainian enlisted soldiers had to wait for explicit orders from officers before they could act, making for a slower, less efficient force. After Russia\u2019s illegal annexation of Crimea, however, the Ukrainian Army decided to reinvent itself. It intensified its work with NATO Allies, who helped turn Ukraine\u2019s Non-Commissioned Officers from mid-level enlisted troopers into battlefield leaders. This has made for a more flexible force, and in Ukraine\u2019s fight against Russian aggression, it has made all the difference.\r\n\r\nHere in the deep Baltic forests, the Lithuanian Army is training new Ukrainian Non-Commissioned Officers to be effective sergeants, capable of both caring for their soldiers and leading them into battle.\u201d\r\n\r\n\u2014SOUNDBITE IN UKRAINIAN \u2014\r\nNCO TRAINEE, UKRAINIAN ARMY\r\n\u201cThe sergeant participates directly in the life of the unit. He trains them, lives with them, he knows everything about his unit and helps it exist, so to speak. Many lives depend on him.\u201d\r\n\u2014SOUNDBITE IN UKRAINIAN \u2014\r\nNCO INSTRUCTOR, UKRAINIAN ARMY\r\n\u201cYou become a man when you are responsible for someone else. You perceive reality in a completely different way. It\u2019s like you kind of wake up, so to speak.\u201d\r\n\u2014VOICEOVER\u2014\r\n\u201cInfantry sergeants are frontline soldiers, but they\u2019re also tasked with planning operations and deciding which tactics should be used.\u201d\r\n\r\n\u2014SOUNDBITE IN UKRAINIAN \u2014\r\nNCO INSTRUCTOR, UKRAINIAN ARMY\r\n\u201cWhat was good in this particular course from the NATO instructors was the approach to planning the operation and controlling the planning of the operation, bringing us these standard operating procedures in terms of tactical aspects, mechanised tactics, tactics using armoured vehicles, armoured infantry vehicles like the M113.\u201d\r\n\u2014VOICEOVER\u2014\r\n\u201cNCOs who are confident and empowered with decision-making will make the Ukrainian Army more flexible in battle.\u201d\r\n\r\n\u2014SOUNDBITE IN UKRAINIAN \u2014\r\nNCO INSTRUCTOR, UKRAINIAN ARMY\r\n\u201cWar, currently, is characterised by a high intensity of action and a rapid change of circumstances. That is, decisions need to be made by people who are in the thick of things, and who see and participate in precisely these areas where circumstances are changing rapidly. Not in the headquarters, but here.\u201d\r\n\r\n\u2014VOICEOVER\u2014\r\n\u201cAfter Russia invaded Ukraine in February 2022, NATO Allies pledged to support the Ukrainian Army with advanced weaponry. Among the assets promised was one of the Alliance\u2019s strongest tanks: the Leopard 2. Manufactured in Germany and currently in service with 15 NATO Allies, the Leopard is fast and strong, with thick armour to protect its crew during intense combat.\u201d\r\n\r\n\u2014SOUNDBITE IN ENGLISH \u2014\r\nMGEN Piotr Fajkowski, Polish Army\r\n\u201cThe tanks bring the new quality. We saw a lot of movies delivered to us from the Ukrainian side. After being hit twice, three, four times, this tank survived. For Ukrainians, this is the power to win the war.\u201d\r\n\u2014VOICEOVER\u2014\r\n\u201cAllies have donated Leopard 2 tanks of various models to Ukraine since 2023. They\u2019ve also been training the crews needed to operate them. At the Combined Arms Training Centre in Poland, a mission funded by the European Union and staffed by NATO Allies, Ukrainian soldiers are fully trained to fight and operate the Leopard 2.\u201d\r\n\u2014SOUNDBITE IN ENGLISH \u2014\r\nMGEN Piotr Fajkowski, Polish Army\r\n\u201cThe training programme is focused on training the gunner, the driver, the commander of the tank. Then, to make from them the tank crew as the whole.\r\n\r\n\u2014VOICEOVER\u2014\r\n\u201cThe Combined Arms Training Centre doesn\u2019t just train the crews. They also train the maintainers who will be responsible for keeping the tanks up and running on the frontline.\u201d\r\n\u2014SOUNDBITE IN POLISH \u2014\r\nMaintenance Trainer, Polish Army\r\n\u201cAs far as commitment, they are 100 percent. They are motivated and absorb knowledge very well. The situation forces them to study quickly and intensively.\u201d\r\n\u2014VOICEOVER\u2014\r\n\u201cAfter three years of war, Ukraine is littered with landmines and unexploded ordnance. These deadly explosives are a threat to Ukrainian troops and civilians alike. Cleansing the landscape will take years of painstaking work, in war or peace. That\u2019s why the British Army is helping train new Explosive Ordnance Disposal technicians at an undisclosed location in the United Kingdom.\u201d\r\n\r\n\u2014SOUNDBITE IN UKRAINIAN \u2014\r\nEXPLOSIVE ORDNANCE DISPOSAL TRAINEE, UKRAINIAN ARMY\r\n\u201cWe constantly encounter mines because we are on the territory that we had liberated after the departure of Russian soldiers. They have left lots of mines behind. It is a huge problem. At the same time, Russians continue to lay mines all over. Because of that, civilians suffer every day.\u201d\r\n\u2014VOICEOVER\u2014\r\n\u201cDetecting mines means getting low and going slow. Trainees learn how to search the dirt to find mines before they explode. The stress is constant, as any mistake could mean injury or death. But these skills are vital for Ukrainian troops as they continue to defend their homeland.\u201d\r\n\u2014SOUNDBITE IN ENGLISH \u2014\r\nEXPLOSIVE ORDNANCE DISPOSAL TRAINER, BRITISH ARMY\r\n\u201cA lot of them do come straight from the front line. I do respect that they're coming here, they're taking on the lessons, fully into it, trying to learn everything they can to take away, to go back, to then fight back on the frontlines.\u201d\r\n\r\n\u2014VOICEOVER\u2014\r\n\u201cUltimately, Ukraine\u2019s greatest weapon is the courage and willpower of the men and women who have fought on the frontlines since 2022. NATO Allies stood behind them then, and stand behind them now.\u201d\r\n\r\n\r\n\u2014SOUNDBITE IN RUSSIAN \u2014\r\nNCO TRAINEE, UKRAINIAN ARMY\r\n\u201cPersonally, my motivation to continue fighting for my country, for Ukraine, it\u2019s the understanding that I will never have a home anywhere else but in Ukraine, because this is my home, my country.\u201d\r\n\r\nUsage rights\r\nThis video contains Thomson Reuters copyrighted library material licensed by NATO, which cannot be used as part of a new production without consent of the copyright holder. Please contact Thomson Reuters to clear this material.",
"hls_url":"https:\/\/api.dvidshub.net\/hls\/video\/953116.m3u8?api_key=key-XXXXXXXXXXXXX",
"url":"https:\/\/www.dvidshub.net\/video\/953116\/training-next-generation-ukrainian-defenders",
"date_published":"2025-02-21T14:18:07Z"
}
]
}| Field | Example | |
|---|---|---|
| api_key | Public API access key issued by DVIDS | api_key=key-xxxxxxxxxxxxx |
| aspect_ratio | 4:3, 16:9, landscape, portrait, square | aspect_ratio=landscape |
| branch | Army, Navy, Air Force, Marines, Coast Guard, Joint, Civilian | branch=Army |
| category categories_exclude |
Combat Operations Miscellaneous Afghanistan Guantanamo Horn of Africa Iraq Kuwait US Press Release for news B-Roll Briefings Commercials Greetings In The Fight Interviews Newscasts Package PSA Series for video Interviews Newscasts for audio. |
category=cat1 (specify multiple categories with list notation) category[]=cat1&category[]=cat2 categories_exclude[]=cat1 |
| city | City where media was captured. | city=Atanta |
| cocom | USAFRICOM USCENTCOM USEUCOM USINDOPACOM USNORTHCOM USSOUTHCOM USSPACECOM |
cocom=USAFRICOM |
| country | Country where media was captured | country=US |
| credit | Full name including rank of personnel credited with the media asset. | credit=Sgt John Doe |
| date | Date media was acquired by shooter/producer. Date in ISO8601 format. |
date=2011-02-13T16:18:00Z |
| duration | Length in seconds of media asset. Only applies to video, audio, and greetings. |
type=video&duration=75 |
| fields | Comma separated list of which fields to return. | fields=title,description,date |
| format | Format of response. json [default], rss. (rss response structure/fields differ from json) |
format=rss |
| from_date | Begin value for date range query. Date in ISO8601 format. |
from_date=2011-02-13T16:18:00Z |
| from_duration | Begin value for duration range query. | from_duration=165 |
| from_publishdate | Begin value for publish date range query. Date in ISO8601 format. |
from_publishdate=2011-02-13T16:18:00Z |
| from_rating | [0-5] Begin value for rating range query. | from_range=3 |
| has_image | [0,1] If set to 0, only return media NOT associated with an image. If set to 1, only return media associated with a valid image. | has_image=1 |
| has_captions | [1] Limit to videos containing subtitles. | has_captions=1 |
| hash | 32 character hash identifying playlist to retrieve. | hash=97f747b9da700cb5d6758f5477b79abb |
| hd | [0,1] If set to 0, only return video media that is NOT considered "HD" (at least 1280x720, 6000kbps or higher). If set to 1, only return video media that meets "HD" criteria. |
hd=1 |
| highlight_fields | [0,1] Default is 0. Wraps found instances of q parameter with HTML tags for highlighting | |
| id | Specific document id to retrieve for search. | id=image:123456 |
| keywords | Multiple keywords can be passed in using the syntax &keywords[]=keyword1&keywords[]=keyword2. Will return result if either keyword is found | |
| max_results | [1-50] Maximum number of results to return per page. default and maximum value are both 50. If page * max_results > 1000 then the last valid page will be returned given the current max_results | |
| page | What page to load. Defaults to 1. | page=1 |
| prettyprint | [1] Spaces out JSON response in more readable format useful for debugging | prettyprint=1 |
| publishdate | Date/time item was published at DVIDS. Date in ISO8601 format. |
publishdate=2011-02-13T16:18:00Z |
| q | Full text search against title, description, keywords | |
| rating | [int] Only return media with the specific rating number specified. Note that the majority of media does not have a rating. | |
| sort | Field to sort by. date, publishdate, timestamp, score, rating | sort=date |
| sortdir | asc, desc | sortdir=asc |
| spellcheck | One of 0, 1. default is 0. Returns a messages element with spelling correction suggestions | |
| short_description_length | [1-300] Specify length of short_description up to 300 characters. Defaults to 60. | |
| state | State where media was captured. | |
| tags | Whitespace collapsed version of keywords. Multiple tag queries will return result if either tag is found. |
tags[]=army-color-guard (specify multiple tags with list notation) &tags[]=tag1&tags[]=tag2 |
| tags_exclude | Exclude resources with tags specified. | &tags_exclude[]=cat1&tags_exclude[]=cat2 |
| 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 | |
| timestamp | Date/time of last update to asset. Date in ISO8601 format. |
timestamp=2011-02-13T16:18:00Z |
| title | Match value against the title field of media. | |
| to_date | End value for date range query. Date in ISO8601 format. |
to_date=2011-02-13T16:18:00Z |
| to_duration | End value of duration range query. Integer in seconds. |
to_duration=300 |
| to_publishdate | End value for publishdate range query. Date in ISO8601 format. |
to_publishdate=2011-02-13T16:18:00Z |
| to_rating | [1-5] End value of rating range query. | to_rating=4 |
| type | news, video, image, audio, publication_issue, webcast, graphics. | type=image (specify multiple types with list notation) &type[]=image&type[]=video |
| unit_name | Full name of unit credited with media asset. | |
| unit | DVIDS abbreviation of unit credited with media asset. | |
| unit_rollup | [0-1] default 0. Include results from subordinate units. |
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
