Search API

GET /search

Basic 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.net

Example response:

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 2084
Connection: keep-alive
Date: Sun, 07 Jun 2026 17:36:52 GMT
Content-encoding: gzip
Server: Apache
Access-control-allow-origin: *
Vary: Accept-Encoding
X-cache: Miss from cloudfront
Via: 1.1 0eead6b6d592f7fb31a5629652c63870.cloudfront.net (CloudFront)
X-amz-cf-pop: IAD61-P12
Alt-svc: h3=":443"; ma=86400
X-amz-cf-id: gOoqvY3GYfcOWzkem7QHl4lpgk4M-YcApCQxg294pJJ39k6nVd1m9w==

{
    "page_info":{
        "total_results":1000,
        "results_per_page":2
    },
    "results":[
        {
            "publishdate":"2026-06-03T22:22:58Z",
            "date":"2026-06-03T21:22:00Z",
            "category":"Miscellaneous",
            "title":"Defense industrial base takes center stage during Cadenazzi\u2019s DTA visit",
            "id":"news:566800",
            "type":"news",
            "credit":"Ann Zaniewski",
            "country":"United States",
            "unit_name":"U.S. Army Tank-automotive and Armaments Command",
            "branch":"Army",
            "timestamp":"2026-06-03T22:24:03.449Z",
            "short_description":"By ANN ZANIEWSKI\nTACOM Public Affairs\n\nDETROIT ARSENAL, Mich. \u2013 What will future resilience look like?\n\nThat question was in the spotlight during Michael Cadenazzi\u2019s May 11 visit to the Detroit Arsenal, where the assistant secretary of war for Industrial Base Policy reviewed key initiatives, talked supply chain management, toured laboratories and encouraged innovation.\n\nCadenazzi said under U.S. President Donald Trump\u2019s administration, the defense industrial base is at the center of national strategy in a way that it hasn\u2019t been in years \u2013 creating the perfect environment for bold, outside-the-box thinking. He urged leaders to put forward their \u201cbiggest, most aggressive\u201d ideas.\n\n\u201cWhy are we doing the things we are doing? How can we look at them differently?\u201d he asked.\n\nCadenazzi made the remarks during a meeting with Brig. Gen. Beth A. Behn, commanding general of U.S. Army Tank-automotive and Armaments Command, and other leaders from across the Detroit Arsenal. Their wide-ranging conversation centered largely on the Department of War\u2019s push to revitalize the defense industrial base and how TACOM and its partners align with that effort.\n\nSupply chain vulnerabilities and opportunities were a key focus of the discussions. Cadenazzi encouraged the leaders to take a strategic and tactical approach to tackling challenges, ask more of their industry partners and embrace acquisition risk.\n\n\u201cI think we have this challenge of thinking through what resilience looks like in the future,\u201d he said.\n\nThe undersecretary explained how Industrial Base Policy\u2019s three offices \u2013 Industrial Base Resilience, Industrial Base Growth and Global Investment & Economic Security \u2013 work with domestic and international partners to forge a robust, resilient industrial base.\n\nThe meeting also covered acquisition reform, modernization, foreign military sales, rare earth minerals and other topics.\n\nBehn highlighted DTA as the Army\u2019s premier ground systems center of excellence, describing it as a collaborative, unified ecosystem in which lifecycle management, research and development and acquisition intersect to drive innovation. That power is amplified, she said, by its strategic location in southeast Michigan, hub of the automotive industry.\n\nBehn also provided an overview of how TACOM generates and sustains readiness in support of the warfighter. She emphasized key initiatives, including Organic Industrial Base optimization.\n\nCadenazzi\u2019s visit included a tour and overview of the U.S. Army Combat Capabilities Development Command Ground Vehicle Systems Center\u2019s labs and capabilities, which support the entire lifecycle of Army ground vehicles. Discussions there covered GVSC\u2019s core competencies in survivability, power and mobility, advanced manufacturing and robotics.",
            "thumbnail":"https:\/\/d1ldvf68ux039x.cloudfront.net\/thumbs\/photos\/2606\/9723979\/122x92_q95.jpg",
            "thumb_width":122,
            "thumb_height":92,
            "url":"https:\/\/www.dvidshub.net\/news\/566800\/defense-industrial-base-takes-center-stage-during-cadenazzis-dta-visit",
            "date_published":"2026-06-03T22:22:58Z"
        },
        {
            "publishdate":"2026-06-05T02:00:49Z",
            "date":"2026-06-03T04:00:00Z",
            "aspect_ratio":"landscape",
            "width":5736,
            "height":3824,
            "title":"2026 E3B Test Week",
            "id":"image:9724608",
            "type":"image",
            "keywords":"2ID, USARPAC, Eighth Army, USFK, E3B, U.S. Army",
            "credit":"CPL Yoon Hyeok Choi",
            "country":"South Korea",
            "unit_name":"2nd Infantry Division\/ROK-U.S. Combined Division",
            "branch":"Army",
            "timestamp":"2026-06-05T02:01:01.809Z",
            "short_description":"U.S. Army Cpl. Sabastian Philip Espitia, an infantryman...",
            "thumbnail":"https:\/\/d1ldvf68ux039x.cloudfront.net\/thumbs\/photos\/2606\/9724608\/122x92_q95.jpg",
            "thumb_width":122,
            "thumb_height":92,
            "url":"https:\/\/www.dvidshub.net\/image\/9724608\/2026-e3b-test-week",
            "date_published":"2026-06-05T02:00:49Z"
        }
    ]
}

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.

• 503: search is temporarily unavailable

• Response Fields:

  • aspect_ratio: type=video|image: Aspect ratio of the asset
  • 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
  • height: [int] type=image: Height of original image
  • id: Asset id
  • 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
  • rating: [float] Rating of the asset. Will not be returned if the asset has not been rated.
  • short_description: Shortened version of asset's description. Adjusted via short_description_length param.
  • thumb_height: [int] Height of thumbnail
  • thumb_width: [int] Width of thumbnail
  • 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
  • width: [int] type=image: Width of original image