Search Image and Video Library
nasa.search_media
ActionBusiness appsconnection required
Calls the NASA API with the connection's credentials.
Search the NASA Image and Video Library at images.nasa.gov.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- NASA
- Secret shape
- the API key, or {"api_key": "…"}
- Config it needs
- base_url, images_base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
15 fields, none required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
q Free-text search terms, compared against all indexed metadata. | string | No | — | — | apollo 11 |
center The NASA centre that published the media, such as JSC or JPL. | string | No | — | — | JSC |
description Terms to look for in the media's Description field. | string | No | — | — | moon landing |
description_508 Terms to look for in the media's 508 (accessibility) Description field. | string | No | — | — | moon landing |
keywords Terms to look for in the media's Keywords field; separate several with commas. | string | No | — | — | moon,lunar surface |
location Terms to look for in the media's Location field. | string | No | — | — | Sea of Tranquility |
media_type Restrict the search to these media types: image, video or audio; separate several with commas. | string | No | — | — | image |
nasa_id The media asset's NASA ID, when you already know it. | string | No | — | — | as11-40-5874 |
photographer The primary photographer's name. | string | No | — | — | Neil A. Armstrong |
secondary_creator A secondary photographer's or videographer's name. | string | No | — | — | Michael Collins |
title Terms to look for in the media's Title field. | string | No | — | — | Apollo 11 Mission image |
year_start Only return media from this year onwards, as a four-digit year. | string | No | — | — | 1969 |
year_end Only return media up to this year, as a four-digit year. | string | No | — | — | 1972 |
page Which page of results to read; the first page is 1. | number | No | — | ≥ 1 | — |
page_size How many results to return per page; the library's own default is 100. | number | No | — | ≥ 1 | — |
- At least one of q, center, description, description_508, keywords, location, media_type, nasa_id, photographer, secondary_creator, title, year_start, year_end must be set.
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"center": "JSC",
"description": "moon landing",
"description_508": "moon landing",
"keywords": "moon,lunar surface",
"location": "Sea of Tranquility",
"media_type": "image",
"nasa_id": "as11-40-5874",
"photographer": "Neil A. Armstrong",
"q": "apollo 11",
"secondary_creator": "Michael Collins",
"title": "Apollo 11 Mission image",
"year_end": "1972",
"year_start": "1969"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
items The matching media items. | array | — |
items[].data One item's metadata records. | array | — |
items[].href The item's asset collection URL. | string | — |
items[].links Preview links for the item. | array | — |
count How many items are on this page. | number | — |
total_hits How many items matched in total. | number | — |
next_page_url The library's own link to the next page. | string | — |
{
"count": 0,
"items": [
{
"data": [],
"href": "",
"links": []
}
],
"next_page_url": "",
"total_hits": 0
}Notes
- images-api.nasa.gov is a separate host that takes no API key, so this node sends no credential; the connection is still required for its API root.
- At least one search term must be filled in — the library refuses an empty search with HTTP 400.
See Search Image and Video Library run in a workflow.
In a technical demo we add the NASA connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.