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: 906
Connection: keep-alive
Date: Thu, 30 Oct 2025 14:48:02 GMT
Content-encoding: gzip
Server: Apache
Access-control-allow-origin: *
Vary: Accept-Encoding
X-cache: Miss from cloudfront
Via: 1.1 a57d2f9cdddfdb2c5779462e97c9c00c.cloudfront.net (CloudFront)
X-amz-cf-pop: IAD12-P4
Alt-svc: h3=":443"; ma=86400
X-amz-cf-id: yIHBOsgC5pO0HmE9JGMa55SIoSJ4qQZItgwfBG-K11Y5cOyCmhfmhA==

{
    "page_info":{
        "total_results":1000,
        "results_per_page":2
    },
    "results":[
        {
            "publishdate":"2025-06-15T10:32:09Z",
            "date":"2025-12-06T05:00:00Z",
            "aspect_ratio":"landscape",
            "width":2875,
            "height":1950,
            "title":"48th Fighter Wing aircraft take off for Atlantic Trident 25",
            "id":"image:9112444",
            "type":"image",
            "keywords":"USAFE, F-15E Strike Eagle, EUCOM, 48FW, 492nd FS, Atlantic Trident 25",
            "credit":"A1C Sierra Casteel",
            "country":"United Kingdom",
            "state":"Suffolk",
            "city":"RAF Lakenheath",
            "unit_name":"U.S. Air Forces in Europe and Air Forces Africa",
            "branch":"Air Force",
            "timestamp":"2025-06-22T20:49:27.956Z",
            "short_description":"U.S. Air Force Staff Sgt. Dennis Hatcher, 492nd Fighter...",
            "thumbnail":"https:\/\/d1ldvf68ux039x.cloudfront.net\/thumbs\/photos\/2506\/9112444\/122x92_q95.jpg",
            "thumb_width":122,
            "thumb_height":92,
            "url":"https:\/\/www.dvidshub.net\/image\/9112444\/48th-fighter-wing-aircraft-take-off-atlantic-trident-25",
            "date_published":"2025-06-15T10:32:09Z"
        },
        {
            "publishdate":"2025-10-28T03:17:14Z",
            "date":"2025-10-23T04:00:00Z",
            "aspect_ratio":"landscape",
            "width":8133,
            "height":5425,
            "title":"NMCB 4 and JGSDF refuel generators during Active Shield 26",
            "id":"image:9369876",
            "type":"image",
            "keywords":"Exercise Active Shield, IndoPacific, Bilateral Readiness, Seabees, MCAS Iwakuni, AS26",
            "credit":"Cpl Dahkareo Pritchett",
            "country":"Japan",
            "state":"Yamaguchi",
            "city":"Iwakuni",
            "unit_name":"Marine Corps Air Station Iwakuni",
            "branch":"Marines",
            "timestamp":"2025-10-28T03:18:02.458Z",
            "short_description":"U.S. sailors with Naval Mobile Construction Battalion 4,...",
            "thumbnail":"https:\/\/d1ldvf68ux039x.cloudfront.net\/thumbs\/photos\/2510\/9369876\/122x92_q95.jpg",
            "thumb_width":122,
            "thumb_height":92,
            "url":"https:\/\/www.dvidshub.net\/image\/9369876\/nmcb-4-and-jgsdf-refuel-generators-during-active-shield-26",
            "date_published":"2025-10-28T03:17:14Z"
        }
    ]
}

Query Parameters:

41e0bb494a390c2c802ce59b46620acd28af8561

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