Podcast API

GET /podcast/list

List of available podcasts

Example request:

GET /podcast/list?id[]=103&id[]=99&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
Content-length: 908
Connection: keep-alive
Date: Tue, 25 Jun 2024 15:32:08 GMT
Server: Apache
Access-control-allow-origin: *
X-cache: Miss from cloudfront
Via: 1.1 0c9c133650294ca2485db2f5e74b2d10.cloudfront.net (CloudFront)
X-amz-cf-pop: IAD66-C1
Alt-svc: h3=":443"; ma=86400
X-amz-cf-id: ndrLjCxJ3JsYNP7ZRvIZaUmqbOpOLTDP2psMaszql-vzufjdAAZFPg==

{
    "messages":[
        "max_results was not supplied.  A maximum of 50 results per page will be returned."
    ],
    "page_info":{
        "total_results":1,
        "results_per_page":50
    },
    "results":[
        {
            "id":"99",
            "title":"U.S. Army Bloggers Roundtable",
            "description":"The Army\u2019s Online and Social Media Division hosts Bloggers Roundtables - phone interviews that connect bloggers and online journalists to Senior Army Leaders and subject matter experts. Army Bloggers Roundtables focus on hot topics and exclusive opportunities for the online community such as smartphone technologies for Soldiers, uniform changes, physical training doctrine, and the drawdown in Iraq.",
            "unit_id":"361",
            "branch":"Army",
            "category":"Government & Organizations",
            "first_episode_date":"07-13-11 03:31 PM",
            "most_recent_episode_date":"04-17-15 01:25 PM",
            "tags":"",
            "thumbnail":"https:\/\/d1ldvf68ux039x.cloudfront.net\/thumbs\/podcast\/images\/99\/122x92_q95.jpg"
        }
    ]
}

Query Parameters:

  • api_key: Public API access key issued by DVIDS (key-xxxxxxxxxxxxx)
  • id: Limit which podcasts are returned. Multiple ids can be be specified with the following syntax "&id[]=99&id=103"
  • 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
  • sortdir: One of asc, desc.
  • unit_id: [int] Unit id to retrieve contents for. | unit_id=127 | &unit_id[]=127&unit_id[]=43
  • branch: Branch name to retrieve contents for.
  • category: Category to retrieve contents for. Example: category=Health or category=News %26 Politics (for categories with & symbol) | &category[]=News %26 Politics&category[]=Government %26 Organizations
  • q: Full text search against title, description | q=today |
  • max_results: Maximum number of results to return.
  • page: [int] What page to load. Defaults to 1.
  • tags: Full text search against tags | tags=Dvids, Army |
  • unit: | DVIDS abbreviation of unit credited with media asset.| unit=DVIDSHUB | &unit[]=DVIDSHUB&unit[]=AFNA
  • from_date | Begin value for date range query. | from_date=2011-02-13 |
  • to_date | End value for date range query. | to_date=2011-02-13 |
  • unit_name | Full name of unit credited with media asset.| unit_name=DVIDS hub | &unit_name[]=DVIDS hub&unit_name[]=AFN Afghanistan|

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 podcast
  • title: Title of podcast
  • description: Description of podcast
  • thumbnail: Url to resized image of podcast logo as specified by thumb_XXX params
  • unit_id: Id for the unit that produced this asset
  • branch: Name of branch that produced this asset
  • category: Category of podcast
  • first_episode_date: Date of first podcast episode published
  • most_recent_episode_date: Date of most recent podcast epidsode published
  • tags: Tags of podcast

GET /podcast/get

Get podcast contents

Example request:

GET /podcast/get?id=103&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: Tue, 25 Jun 2024 15:32:08 GMT
Server: Apache
Access-control-allow-origin: *
Content-encoding: gzip
X-cache: Miss from cloudfront
Via: 1.1 7d1fc9eade7f4375a556b826b0b10c60.cloudfront.net (CloudFront)
X-amz-cf-pop: IAD66-C1
Alt-svc: h3=":443"; ma=86400
X-amz-cf-id: au07kZah5t5umNTqH2aYhnphiTe3Es-yQPq-Dib3ZDIHxxPMprWikw==

{
    "page_info":{
        "total_results":15,
        "results_per_page":2
    },
    "results":[
        {
            "id":9533,
            "asset_id":"video:136010",
            "type":"video",
            "title":"Arctic Ice Bridge Operations",
            "short_description":"Alaska's 2nd Engineer Brigade, 6th Engineer Battalion...",
            "date_published":"2023-12-22T10:01:37-05:00",
            "keywords":"Alaska, USRAK, U.S. Army Alaska, Engineers, 6th Eng. Bn, 2nd Engineer Bde, Brehl Garza",
            "date":"2012-01-25T00:00:00-05:00",
            "category":"Package",
            "aspect_ratio":"16:9",
            "duration":103,
            "hd":true,
            "credit":"Brehl Garza",
            "country":"US",
            "state":"AK",
            "city":"Delta Junction",
            "unit_name":"United States Army Alaska",
            "branch":"Army",
            "timestamp":"2021-10-09T05:58:18-04:00",
            "thumbnail":"https:\/\/d1ldvf68ux039x.cloudfront.net\/thumbs\/frames\/video\/1201\/136010\/122x92_q95.jpg",
            "url":"https:\/\/www.dvidshub.net\/video\/136010\/arctic-ice-bridge-operations"
        },
        {
            "id":9124,
            "asset_id":"video:129163",
            "type":"video",
            "title":"U.S. Army Alaska Command Video",
            "short_description":"U.S. Army Alaska executes continuous training and...",
            "date_published":"2023-12-22T13:13:52-05:00",
            "keywords":"USARAK, Alaska",
            "date":"2011-11-01T00:00:00-04:00",
            "category":"Package",
            "aspect_ratio":"16:9",
            "duration":470,
            "hd":true,
            "credit":"Brehl Garza",
            "country":"US",
            "state":"AK",
            "city":"Joint Base Elmendorf-Richardson",
            "unit_name":"United States Army Alaska",
            "branch":"Army",
            "timestamp":"2021-10-09T14:23:38-04:00",
            "thumbnail":"https:\/\/d1ldvf68ux039x.cloudfront.net\/thumbs\/frames\/video\/1111\/129163\/122x92_q95.jpg",
            "url":"https:\/\/www.dvidshub.net\/video\/129163\/us-army-alaska-command-video"
        }
    ]
}

Query Parameters:

  • api_key: Public API access key issued by DVIDS (key-xxxxxxxxxxxxx)
  • fields: Comma separated list of which fields to return
  • id: [int] Podcast id to retrieve contents for. Required.
  • max_results: [1-50] Maximum number of results to return per page. Default and maximum value are both 50.
  • page: [int] What page to load. Defaults to 1.
  • prettyprint: [int] Spaces out JSON response in more readable format useful for debugging
  • short_description_length: [1-300] Specify length of short_description up to 300 characters. Defaults to 60.
  • 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

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.


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:

  • asset_id: Asset id
  • branch: Name of branch that produced this asset
  • credit: Who created the asset
  • category: Category of the asset
  • city: City where the asset was created
  • country: Country where the asset was created
  • duration: [int] type=video|audio: Length of asset in seconds
  • keywords: Comma separated list of keywords
  • date: Date in ISO8601 format of when the asset was created
  • date_published: Date in ISO8601 format of when the asset was published at DVIDS
  • id: Podcast item id
  • short_description: Shortened version of asset's description. Adjusted via short_description_length param.
  • thumbnail: Url to resized image of asset as specified by thumb_XXX params
  • timestamp: Date in ISO8601 format of when the asset was last updated
  • title: Title of asset
  • type: Asset type
  • unit_name: Full name of unit credited with media asset.
  • url: Url to asset on dvidshub.net

GET /podcast/search

Get podcast contents

Example request:

GET /podcast/search?q=Leadership&branch=joint&unit_id=613&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: Tue, 25 Jun 2024 15:32:08 GMT
Server: Apache
Access-control-allow-origin: *
X-cache: Miss from cloudfront
Via: 1.1 063f496e2a2a07219bf3fbec39d54de4.cloudfront.net (CloudFront)
X-amz-cf-pop: IAD66-C1
Alt-svc: h3=":443"; ma=86400
X-amz-cf-id: HcoM3O5xrYPPlero1v5_7xqXZqHfiDiospt1KlP2wjqxypkRkAIUrQ==

{
    "page_info":{
        "total_results":4,
        "results_per_page":2
    },
    "results":[
        {
            "id":"56281",
            "podcast_date_published":"12-31-69 07:00 PM",
            "channel_id":"47",
            "title":"Ukraine: The Unseen Attacks \u2013 Ukraine\u2019s Armed Forces, Master Version",
            "description":"Restrictions:\r\n\r\nThis media asset is free for editorial broadcast, print, online and radio use. It is restricted for use for other purposes. This video includes ITN Source copyrighted library material purchased by NATO which cannot be used as part of a new production without consent of the copyright holder.  Please contact http:\/\/www.itnsource.com\/en\/contactus to clear this material.\r\n\r\nStory Synopsis:\r\n\r\nFour fatal flaws? Ukraine's key challenges today are more than the war fought in its east. \r\nNATO\u2019s experience may help to fix a long-damaged institution that is vital to defending Ukraine \u2013 its armed forces. In this feature NATO experts, Ukrainian politicians and journalists talk about why Ukraine\u2019s Armed Forces found themselves on the back foot when attacked and how they can turn the fight around. \r\n\r\nAbout the four-part series Ukraine: The Unseen Attacks\r\n\r\nFighting in the east has come to characterize Ukraine. But Ukraine\u2019s struggle for survival and self-determination, free of corrupt governments and Russian influence is fought on many other fronts. From cyber defense to internal defense, fixing its forces to telling the truth \u2013 Ukraine faces challenges that may determine its very survival. \r\n\r\nFull script:\r\n\r\n=VOICEOVER =\r\nFighting in the east has come to characterize Ukraine. But Ukraine\u2019s struggle for survival and self-determination, free of corrupt governments and Russian influence is fought on many other fronts. \r\nIn this program, we\u2019ll look at four distinct challenges Ukraine faces in addition to fighting on its borders. From cyber defense to internal defense, fixing its forces to telling the truth \u2013 Ukraine faces challenges that may determine its very survival. \r\n\r\n=GRAPHIC=\r\nUKRAINE \u2013 THE UNSEEN ATTACKS\r\n=GRAPHIC=\r\nUKRAINE\u2019S ARMED FORCES\r\n\r\n=VOICEOVER=\r\nUkraine\u2019s Armed Forces continue to defend their country against incursions by pro-Russian-separatists. But it\u2019s a struggle that hasn\u2019t come easy for a force that relies heavily on conscripts and volunteers. \r\nIn early Summer 2014, it looked as if Ukrainian forces might prevail against pro-Russian separatists. But during a brief ceasefire, the rebels regrouped with the help of advanced weapons systems. \r\nMilitary journalist, Yuriy Butusov of news agency Censor.net says he initially couldn\u2019t believe his eyes when he saw Russian hardware in his country. \r\n\r\n=SOUNDBITE IN RUSSIAN=\r\nYuriy Butusov, Military Journalist, founder of Censor.net\r\n \u201cI didn\u2019t believe it. I thought it was propaganda or somebody was seeing things.\r\nBut two days later the first post was shelled in the region of Dobropillia by the first GRAD.\u201d\r\n\r\n=VOICEOVER=\r\nDeadly weapons like GRAD missiles and BUK systems devastated Ukrainian forces, including a tragic rout at Illovaisk where hundreds of soldiers were killed or captured after being encircled by enemy forces. \r\nThe Ukrainian armed forces at Illovaisk were outgunned and outmanoeuvred. Something that many blame not on poor soldiers, but poor military planning.  \r\n\r\n=SOUNDBITE IN RUSSIAN=\r\nDmytro Tymchuk, MP, founder of Information Resistance Blog\r\n\u201cOur intelligence data was good and it was provided to the Ukrainian military leadership, but the bureaucratic machinery failed and did not allow us to react properly. So the result was this tragedy.\u201d\r\n\r\n=VOICEOVER=\r\nBut to understand why Ukraine\u2019s armed forces found themselves on the back foot, we need to go back to the fall of the Soviet Union in the early nineties. \r\n\r\n=SOUNDBITE IN ENGLISH=\r\nCaptain Dimiter Illeieff, NATO Military Liaison Officer to Ukraine\r\n\u2018The total strength of the military was almost 1 million when Ukraine got its independence in 1991. And for those 23, 25 years, they were reduced to less than 200,000. This has enormous impact.\u201d\r\n\r\n=VOICEOVER=\r\nAdd to these drastic reductions 25 years of mismanagement and, many believe, deliberate neglect. \r\n\r\n=VOICEOVER=\r\nCaptain Dimiter Illeieff, NATO Military Liaison Officer to Ukraine\r\n\u201cIt\u2019s a question of deliberate underfunding for more than 20 years.\u201d\r\n\r\n=SOUNDBITE IN RUSSIAN=\r\nYuriy Butusov, Military Journalist, founder of Censor.net \r\n\u201cBefore the war, during the regime of Yanukovych, the Ministry of Defense was headed by Russian agents. Two successive Ministers of Defense were Russian citizens and they completely destroyed our units of high readiness. They undermined our capabilities and actually destroyed a big portion of our equipment.\u201d\r\n\r\n=VOICEOVER=\r\nThe good news is that Ukraine\u2019s war has given thousands of soldiers experience in a year that would take many armies ten to acquire. \r\nBut to build on that experience will take careful training and mentoring, even as fighting sporadically continues despite the Minsk agreements.\r\nNATO has pledged money to improve Ukraine\u2019s armed forces through mentoring command and control structures, something the former regime resisted. \r\n\r\n=SOUNDBITE IN RUSSIAN=\r\nDmitry Tymchuk, MP, Founder of Information Resistance Blog\r\n\u201cUnder Yanukovych, there was a backslide to a Soviet system of governance. The more the system of distribution of resources is complicated, the more opportunities there are for corruption. That\u2019s why our military leadership resisted a switch to a more simple and understandable NATO structure.\u201d\r\n\r\n=VOICEOVER=\r\nIf the current Soviet-style system is allowed to continue without reform, it could have devastating results.\r\n\r\n=SOUNDBITE IN ENGLISH=\r\nAdmiral Ihor Kabanenko, Former First Deputy Chief of Defence, Armed Forces of Ukraine\r\n\u201cThe system doesn\u2019t work because this system kills initiative, kills responsibility. If this system will continue I think it would be a question of more casualties and the loss of territory.\u201d\r\n\r\n=VOICEOVER=\r\nAnd while, thanks to volunteers and conscripted troops, numbers are increasing, emphasis will need to be on quality as well as quantity.\r\n\r\n=SOUNDBITE IN ENGLISH=\r\nYuriy Butusov Military Journalist, founder of Censor.net\r\n\u201cWe need to understand the professional level of a volunteer. If you want to be a patriot, if you want to fight for Ukraine, you have to be alive. You have to be effective on the front line. We don\u2019t need dead patriots.\u201d\r\n\r\n=VOICEOVER=\r\nUkraine\u2019s armed forces have long days and nights of fighting ahead of them as well as years of caring for their wounded and developing their defences. With no signs that fighting will cease completely it will be a steep learning curve. \r\n\r\nThis version includes voiceover and graphics.",
            "keywords":"",
            "type":"video",
            "type_id":"414935",
            "asset":{
                "date":"03-31-15 12:00 AM",
                "duration":"317",
                "category":"Package",
                "title":"Ukraine: The Unseen Attacks \u2013 Ukraine\u2019s Armed Forces, Master Version",
                "credit":"Ruth Owen",
                "id":"video:414935",
                "type":"video",
                "description":"Restrictions:\r\n\r\nThis media asset is free for editorial broadcast, print, online and radio use. It is restricted for use for other purposes. This video includes ITN Source copyrighted library material purchased by NATO which cannot be used as part of a new production without consent of the copyright holder.  Please contact http:\/\/www.itnsource.com\/en\/contactus to clear this material.\r\n\r\nStory Synopsis:\r\n\r\nFour fatal flaws? Ukraine's key challenges today are more than the war fought in its east. \r\nNATO\u2019s experience may help to fix a long-damaged institution that is vital to defending Ukraine \u2013 its armed forces. In this feature NATO experts, Ukrainian politicians and journalists talk about why Ukraine\u2019s Armed Forces found themselves on the back foot when attacked and how they can turn the fight around. \r\n\r\nAbout the four-part series Ukraine: The Unseen Attacks\r\n\r\nFighting in the east has come to characterize Ukraine. But Ukraine\u2019s struggle for survival and self-determination, free of corrupt governments and Russian influence is fought on many other fronts. From cyber defense to internal defense, fixing its forces to telling the truth \u2013 Ukraine faces challenges that may determine its very survival. \r\n\r\nFull script:\r\n\r\n=VOICEOVER =\r\nFighting in the east has come to characterize Ukraine. But Ukraine\u2019s struggle for survival and self-determination, free of corrupt governments and Russian influence is fought on many other fronts. \r\nIn this program, we\u2019ll look at four distinct challenges Ukraine faces in addition to fighting on its borders. From cyber defense to internal defense, fixing its forces to telling the truth \u2013 Ukraine faces challenges that may determine its very survival. \r\n\r\n=GRAPHIC=\r\nUKRAINE \u2013 THE UNSEEN ATTACKS\r\n=GRAPHIC=\r\nUKRAINE\u2019S ARMED FORCES\r\n\r\n=VOICEOVER=\r\nUkraine\u2019s Armed Forces continue to defend their country against incursions by pro-Russian-separatists. But it\u2019s a struggle that hasn\u2019t come easy for a force that relies heavily on conscripts and volunteers. \r\nIn early Summer 2014, it looked as if Ukrainian forces might prevail against pro-Russian separatists. But during a brief ceasefire, the rebels regrouped with the help of advanced weapons systems. \r\nMilitary journalist, Yuriy Butusov of news agency Censor.net says he initially couldn\u2019t believe his eyes when he saw Russian hardware in his country. \r\n\r\n=SOUNDBITE IN RUSSIAN=\r\nYuriy Butusov, Military Journalist, founder of Censor.net\r\n \u201cI didn\u2019t believe it. I thought it was propaganda or somebody was seeing things.\r\nBut two days later the first post was shelled in the region of Dobropillia by the first GRAD.\u201d\r\n\r\n=VOICEOVER=\r\nDeadly weapons like GRAD missiles and BUK systems devastated Ukrainian forces, including a tragic rout at Illovaisk where hundreds of soldiers were killed or captured after being encircled by enemy forces. \r\nThe Ukrainian armed forces at Illovaisk were outgunned and outmanoeuvred. Something that many blame not on poor soldiers, but poor military planning.  \r\n\r\n=SOUNDBITE IN RUSSIAN=\r\nDmytro Tymchuk, MP, founder of Information Resistance Blog\r\n\u201cOur intelligence data was good and it was provided to the Ukrainian military leadership, but the bureaucratic machinery failed and did not allow us to react properly. So the result was this tragedy.\u201d\r\n\r\n=VOICEOVER=\r\nBut to understand why Ukraine\u2019s armed forces found themselves on the back foot, we need to go back to the fall of the Soviet Union in the early nineties. \r\n\r\n=SOUNDBITE IN ENGLISH=\r\nCaptain Dimiter Illeieff, NATO Military Liaison Officer to Ukraine\r\n\u2018The total strength of the military was almost 1 million when Ukraine got its independence in 1991. And for those 23, 25 years, they were reduced to less than 200,000. This has enormous impact.\u201d\r\n\r\n=VOICEOVER=\r\nAdd to these drastic reductions 25 years of mismanagement and, many believe, deliberate neglect. \r\n\r\n=VOICEOVER=\r\nCaptain Dimiter Illeieff, NATO Military Liaison Officer to Ukraine\r\n\u201cIt\u2019s a question of deliberate underfunding for more than 20 years.\u201d\r\n\r\n=SOUNDBITE IN RUSSIAN=\r\nYuriy Butusov, Military Journalist, founder of Censor.net \r\n\u201cBefore the war, during the regime of Yanukovych, the Ministry of Defense was headed by Russian agents. Two successive Ministers of Defense were Russian citizens and they completely destroyed our units of high readiness. They undermined our capabilities and actually destroyed a big portion of our equipment.\u201d\r\n\r\n=VOICEOVER=\r\nThe good news is that Ukraine\u2019s war has given thousands of soldiers experience in a year that would take many armies ten to acquire. \r\nBut to build on that experience will take careful training and mentoring, even as fighting sporadically continues despite the Minsk agreements.\r\nNATO has pledged money to improve Ukraine\u2019s armed forces through mentoring command and control structures, something the former regime resisted. \r\n\r\n=SOUNDBITE IN RUSSIAN=\r\nDmitry Tymchuk, MP, Founder of Information Resistance Blog\r\n\u201cUnder Yanukovych, there was a backslide to a Soviet system of governance. The more the system of distribution of resources is complicated, the more opportunities there are for corruption. That\u2019s why our military leadership resisted a switch to a more simple and understandable NATO structure.\u201d\r\n\r\n=VOICEOVER=\r\nIf the current Soviet-style system is allowed to continue without reform, it could have devastating results.\r\n\r\n=SOUNDBITE IN ENGLISH=\r\nAdmiral Ihor Kabanenko, Former First Deputy Chief of Defence, Armed Forces of Ukraine\r\n\u201cThe system doesn\u2019t work because this system kills initiative, kills responsibility. If this system will continue I think it would be a question of more casualties and the loss of territory.\u201d\r\n\r\n=VOICEOVER=\r\nAnd while, thanks to volunteers and conscripted troops, numbers are increasing, emphasis will need to be on quality as well as quantity.\r\n\r\n=SOUNDBITE IN ENGLISH=\r\nYuriy Butusov Military Journalist, founder of Censor.net\r\n\u201cWe need to understand the professional level of a volunteer. If you want to be a patriot, if you want to fight for Ukraine, you have to be alive. You have to be effective on the front line. We don\u2019t need dead patriots.\u201d\r\n\r\n=VOICEOVER=\r\nUkraine\u2019s armed forces have long days and nights of fighting ahead of them as well as years of caring for their wounded and developing their defences. With no signs that fighting will cease completely it will be a steep learning curve. \r\n\r\nThis version includes voiceover and graphics.",
                "country":"UA",
                "city":"Kyiv",
                "unit":"Natochannel",
                "branch":"Joint",
                "url":"https:\/\/www.dvidshub.net\/video\/414935\/ukraine-unseen-attacks-ukraines-armed-forces-master-version",
                "date_published":"07-14-15 01:22 PM",
                "image":"https:\/\/d1ldvf68ux039x.cloudfront.net\/thumbs\/frames\/video\/1507\/414935.jpg",
                "thumbnail":{
                    "url":"https:\/\/d1ldvf68ux039x.cloudfront.net\/thumbs\/frames\/video\/1507\/414935\/122x92_q95.jpg",
                    "width":null,
                    "height":null
                }
            }
        },
        {
            "id":"74877",
            "podcast_date_published":"12-31-69 07:00 PM",
            "channel_id":"47",
            "title":"How Does NATO Counter Hybrid Threats?, Master Version",
            "description":"How do NATO Allies train to counter a form of warfare that is difficult to identify and hard to defend against?\r\n\r\nHybrid means of warfare \u2013 propaganda, deception, sabotage and other non-military tactics \u2013 have long been used in lieu of (or sometimes in conjunction with) overt, conventional military action. In recent years, the use of hybrid tactics has increased in speed, scale and intensity. How does NATO counter this difficult, covert threat? In 2018, Latvia held Exercise Namejs, its largest military maneuver since the restoration of independence in 1991. They practiced responding against what Chief of Defense Lieutenant General Leon\u012bds Kalni\u0146\u0161 called a scenario \u201cvery, very close to our perception about threats in our region\u201d \u2013 that is, a wide-scale disinformation campaign as a prelude to armed conflict. Exercises like Namejs are useful not only for Latvia, but for the Alliance at large, as Allies share hard-won information and best practices. Footage includes shots of NATO Allies during Namejs 18 and soundbites from NATO Deputy Secretary General Rose Gottemoeller, Ben Heap, a hybrid warfare expert at the NATO Strategic Communications Center of Excellence, and Lt. Gen. Leon\u012bds Kalni\u0146\u0161.\r\n\r\nTranscript\r\nVISUAL DESCRIPTION TEXT ON SCREEN IT CAN BE HARD TO DEFEND AGAINST AN ENEMY YOU CAN\u2019T SEE Archive footage of tanks and planes from the Second World War LOWER-THIRDS TEXT Rose Gottemoeller, NATO Deputy Secretary General Footage of a simulated riot during Exercise Namejs 18 Slow-mo shot: Latvian Special Forces moving down corridor TEXT ON SCREEN WHAT ARE HYBRID THREATS? Various shots: hybrid exercise LOWER-THIRDS TEXT Ben Heap, NATO StratCom Centre of Excellence Various shots: exercise Hacker on computer. NATO\u2019S RESPONSE TO HYBRID ATTACKS IS: 1) PREPARE 2) DETER 3) DEFEND A MILITARY EXERCISE IN LATVIA PUT THIS TO THE TEST Various shots: NATO troops during exercise; simulated riot Various shots: computer screen Various shots: riot exercise DURING THE EXERCISE A SIMULATED ADVERSARY USED DISINFORMATION TO STIR UP CIVIL UNREST Wide shot: simulated insurgent firing belt-fed machine gun ONLY TOGETHER CAN WE COUNTER HYBRID THREATS Archival footage: NATO Secretary General Jens Stoltenberg meeting Estonian President Kersti Kaljulaid Various shots: the Freedom Monument in Riga, Latvia Latvian Special Forces team roping onto and moving through building. NATO troops working together during Exercise Namejs 18 This video includes Reuters copyrighted library material purchased by NATO which cannot be used as part of a new production without consent of the copyright holder. Please contact Reuters to clear this material. AUDIO DESCRIPTION --SOUNDBITE\u2014(ENGLISH) Rose Gottemoeller, NATO Deputy Secretary General \u201cIn the old days, it wasn\u2019t so very difficult. You\u2019d see a line of soldiers coming across a borderline and you\u2019d know something was up, conflict was underway or there would be a massive explosion and attack. What NATO is grappling with today is so much of it is in the hybrid realm where we don\u2019t know where the borderline is between peace and war, between conflict and war.\u201d \u2013SOUNDBITE\u2014 (ENGLISH) Ben Heap, NATO StratCom Centre of Excellence \u201cHybrid threats are really anything our adversaries can use against us, that would damage our national security. And this is activity that could be overt, so it\u2019s out in the open, or it\u2019s covert, so it\u2019s hidden. And it can be a mix of military and non-military means. So that means disinformation, sabotage, cyber attacks, but includes the use of troops, tanks, etc.\u201d \u2013SOUNDBITE\u2014 (ENGLISH) Lt Gen Leon\u012bds Kalni\u0146\u0161, Chief of Defense, Latvia \u201cThe scenario was very, very close to our perception about threats in our region. We have to train our soldiers, our leadership, military leadership, to think wider, to be very creative to test our comprehensive defense system looking for support from society, civil society.\u201d \u2013SOUNDBITE\u2014 (English) Ben Heap, NATO StratCom Center of Excellence \u201cDisinformation tends to exploit an existing vulnerability. Grievances in different groups, fractures in society. And it tends to be trying to make people who are angry about something more angry, and so angry that they want to go and do something about it. Resilience is all about understanding, as a nation, what is important to you, and what you want to protect. Nations can\u2019t address the security problems of today on their own. Being able to respond quickly to hybrid threats is really all about working together and sharing information, through NATO and through the EU.\u201d",
            "keywords":"",
            "type":"video",
            "type_id":"672630",
            "asset":{
                "date":"04-17-19 12:00 AM",
                "duration":"126",
                "category":"Package",
                "title":"How Does NATO Counter Hybrid Threats?, Master Version",
                "credit":"Courtesy",
                "id":"video:672630",
                "type":"video",
                "description":"How do NATO Allies train to counter a form of warfare that is difficult to identify and hard to defend against?\r\n\r\nHybrid means of warfare \u2013 propaganda, deception, sabotage and other non-military tactics \u2013 have long been used in lieu of (or sometimes in conjunction with) overt, conventional military action. In recent years, the use of hybrid tactics has increased in speed, scale and intensity. How does NATO counter this difficult, covert threat? In 2018, Latvia held Exercise Namejs, its largest military maneuver since the restoration of independence in 1991. They practiced responding against what Chief of Defense Lieutenant General Leon\u012bds Kalni\u0146\u0161 called a scenario \u201cvery, very close to our perception about threats in our region\u201d \u2013 that is, a wide-scale disinformation campaign as a prelude to armed conflict. Exercises like Namejs are useful not only for Latvia, but for the Alliance at large, as Allies share hard-won information and best practices. Footage includes shots of NATO Allies during Namejs 18 and soundbites from NATO Deputy Secretary General Rose Gottemoeller, Ben Heap, a hybrid warfare expert at the NATO Strategic Communications Center of Excellence, and Lt. Gen. Leon\u012bds Kalni\u0146\u0161.\r\n\r\nTranscript\r\nVISUAL DESCRIPTION TEXT ON SCREEN IT CAN BE HARD TO DEFEND AGAINST AN ENEMY YOU CAN\u2019T SEE Archive footage of tanks and planes from the Second World War LOWER-THIRDS TEXT Rose Gottemoeller, NATO Deputy Secretary General Footage of a simulated riot during Exercise Namejs 18 Slow-mo shot: Latvian Special Forces moving down corridor TEXT ON SCREEN WHAT ARE HYBRID THREATS? Various shots: hybrid exercise LOWER-THIRDS TEXT Ben Heap, NATO StratCom Centre of Excellence Various shots: exercise Hacker on computer. NATO\u2019S RESPONSE TO HYBRID ATTACKS IS: 1) PREPARE 2) DETER 3) DEFEND A MILITARY EXERCISE IN LATVIA PUT THIS TO THE TEST Various shots: NATO troops during exercise; simulated riot Various shots: computer screen Various shots: riot exercise DURING THE EXERCISE A SIMULATED ADVERSARY USED DISINFORMATION TO STIR UP CIVIL UNREST Wide shot: simulated insurgent firing belt-fed machine gun ONLY TOGETHER CAN WE COUNTER HYBRID THREATS Archival footage: NATO Secretary General Jens Stoltenberg meeting Estonian President Kersti Kaljulaid Various shots: the Freedom Monument in Riga, Latvia Latvian Special Forces team roping onto and moving through building. NATO troops working together during Exercise Namejs 18 This video includes Reuters copyrighted library material purchased by NATO which cannot be used as part of a new production without consent of the copyright holder. Please contact Reuters to clear this material. AUDIO DESCRIPTION --SOUNDBITE\u2014(ENGLISH) Rose Gottemoeller, NATO Deputy Secretary General \u201cIn the old days, it wasn\u2019t so very difficult. You\u2019d see a line of soldiers coming across a borderline and you\u2019d know something was up, conflict was underway or there would be a massive explosion and attack. What NATO is grappling with today is so much of it is in the hybrid realm where we don\u2019t know where the borderline is between peace and war, between conflict and war.\u201d \u2013SOUNDBITE\u2014 (ENGLISH) Ben Heap, NATO StratCom Centre of Excellence \u201cHybrid threats are really anything our adversaries can use against us, that would damage our national security. And this is activity that could be overt, so it\u2019s out in the open, or it\u2019s covert, so it\u2019s hidden. And it can be a mix of military and non-military means. So that means disinformation, sabotage, cyber attacks, but includes the use of troops, tanks, etc.\u201d \u2013SOUNDBITE\u2014 (ENGLISH) Lt Gen Leon\u012bds Kalni\u0146\u0161, Chief of Defense, Latvia \u201cThe scenario was very, very close to our perception about threats in our region. We have to train our soldiers, our leadership, military leadership, to think wider, to be very creative to test our comprehensive defense system looking for support from society, civil society.\u201d \u2013SOUNDBITE\u2014 (English) Ben Heap, NATO StratCom Center of Excellence \u201cDisinformation tends to exploit an existing vulnerability. Grievances in different groups, fractures in society. And it tends to be trying to make people who are angry about something more angry, and so angry that they want to go and do something about it. Resilience is all about understanding, as a nation, what is important to you, and what you want to protect. Nations can\u2019t address the security problems of today on their own. Being able to respond quickly to hybrid threats is really all about working together and sharing information, through NATO and through the EU.\u201d",
                "country":"LV",
                "city":"Jekabpils",
                "unit":"Natochannel",
                "branch":"Joint",
                "url":"https:\/\/www.dvidshub.net\/video\/672630\/does-nato-counter-hybrid-threats-master-version",
                "date_published":"04-17-19 01:05 PM",
                "image":"https:\/\/d1ldvf68ux039x.cloudfront.net\/thumbs\/frames\/video\/1904\/672630.jpg",
                "thumbnail":{
                    "url":"https:\/\/d1ldvf68ux039x.cloudfront.net\/thumbs\/frames\/video\/1904\/672630\/122x92_q95.jpg",
                    "width":null,
                    "height":null
                }
            }
        }
    ]
}

Query Parameters:

  • id: Limit which podcasts are returned. Multiple ids can be be specified with the following syntax "&id[]=99&id=103"
  • podcast_id: Limit which podcasts episodes are returned. Multiple podcast ids can be be specified with the following syntax "&podcast_id[]=99&podcast_id=103"
  • unit_id: [int] Unit id to retrieve contents for.
  • branch: Army, Navy, Air Force, Marines, Coast Guard, Joint, Civilian | branch=Army |
  • q: Full text search against title, description | q=today |
  • keywords: Full text search against keywords | keywords=Dvids |
  • from_date | Begin value for date range query. | from_date=2011-02-13 |
  • to_date | End value for date range query. | to_date=2011-02-13 |
  • sortdir: One of asc, desc.

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: Podcast episode id
  • channel_id: Podcast episode channel id
  • podcast_date_published: Podcast episode channel id
  • title: Title of podcast episode
  • description: Description of the podcast episode
  • keywords: Comma separated list of keywords
  • type: Podcast asset type
  • type_id: Podcast asset id

  • date: Date when the asset was created
  • duration: [int] type=video|audio: Length of asset in seconds
  • category: Category of the asset
  • title: Title of asset
  • credit: Who created the asset
  • id: Asset id
  • type: Asset type
  • description: Description of the asset
  • country: Country where the asset was created
  • city: City where the asset was created
  • unit_name: Full name of unit credited with media asset.
  • branch: Name of branch that produced this asset
  • url: Url to asset on dvidshub.net
  • date_published: Date when the asset was published at DVIDS
  • image: Url to full resolution version of asset
  • thumbnail: Url to resized image of asset

GET /podcast/category

Get podcast categories

Example request:

GET /podcast/category?&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
Content-length: 386
Connection: keep-alive
Date: Tue, 25 Jun 2024 15:32:08 GMT
Server: Apache
Access-control-allow-origin: *
X-cache: Miss from cloudfront
Via: 1.1 fc1cc7c682d30bba517abb52ab524f90.cloudfront.net (CloudFront)
X-amz-cf-pop: IAD66-C1
Alt-svc: h3=":443"; ma=86400
X-amz-cf-id: hXv6Itwz1X8CqhhveuK0Rk91gRqhO33aoRdJDfcA0QTIYU1_RXUQgw==

{
    "messages":[
        "max_results was not supplied.  A maximum of 50 results per page will be returned."
    ],
    "page_info":{
        "total_results":8,
        "results_per_page":50
    },
    "results":[
        {
            "category":"Government & Organizations"
        },
        {
            "category":"News & Politics"
        },
        {
            "category":"TV & Film"
        },
        {
            "category":"Technology"
        },
        {
            "category":"Health"
        },
        {
            "category":"Education"
        },
        {
            "category":"Games & Hobbies"
        },
        {
            "category":"Arts"
        }
    ]
}

Query Parameters:


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:

  • category: Category of the podcast channel