# NASA API: Search media

> Searches NASA public photos, videos or audio by words and creation year, returning matches in relevance order with thumbnails and full-size file links.

Unofficial. Not affiliated with or endorsed by NASA.

- Page: https://fous.com/methods/nasa.gov/search-images
- Method: `nasa.gov/search_images`, version 1
- Website: nasa.gov
- Returns: title, description, date created, NASA center, credit, keywords, thumbnail link, full-size link, page link, media id
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `query` | string | yes | `"Saturn rings"` | Words to search for, for example Saturn rings. |
| `end_year` | integer | no |  | Latest creation year, for example 1970. |
| `media_type` | string | no |  | Type of media to find, for example image. One of "image", "video", "audio". Default "image". |
| `start_year` | integer | no |  | Earliest creation year, for example 1969. |
| `max_results` | integer | no |  | Maximum matches to return, for example 20. Default 20. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "query": "Saturn rings"
}
```

Its output:

```json
{
  "results": [
    {
      "title": "Saturn Rings",
      "keywords": [
        "S Rings",
        "Voyager"
      ],
      "page_link": "https://images.nasa.gov/details/PIA02241",
      "description": "Saturn Rings",
      "nasa_center": "Jet Propulsion Laboratory",
      "date_created": "2000-02-07",
      "nasa_media_id": "PIA02241",
      "full_size_link": "https://images-assets.nasa.gov/image/PIA02241/PIA02241~orig.jpg",
      "thumbnail_link": "https://images-assets.nasa.gov/image/PIA02241/PIA02241~thumb.jpg",
      "photographer_or_credit": "NASA/JPL"
    },
    {
      "title": "Saturn A-ring",
      "keywords": [
        "S Rings",
        "Voyager"
      ],
      "page_link": "https://images.nasa.gov/details/PIA01952",
      "description": "Saturn A-ring",
      "nasa_center": "Jet Propulsion Laboratory",
      "date_created": "1999-04-11",
      "nasa_media_id": "PIA01952",
      "full_size_link": "https://images-assets.nasa.gov/image/PIA01952/PIA01952~orig.jpg",
      "thumbnail_link": "https://images-assets.nasa.gov/image/PIA01952/PIA01952~thumb.jpg",
      "photographer_or_credit": "NASA/JPL"
    },
    {
      "title": "Saturn A-Ring",
      "keywords": [
        "S Rings",
        "Voyager"
      ],
      "page_link": "https://images.nasa.gov/details/PIA01988",
      "description": "Saturn A-Ring",
      "nasa_center": "Jet Propulsion Laboratory",
      "date_created": "1999-07-23",
      "nasa_media_id": "PIA01988",
      "full_size_link": "https://images-assets.nasa.gov/image/PIA01988/PIA01988~orig.jpg",
      "thumbnail_link": "https://images-assets.nasa.gov/image/PIA01988/PIA01988~thumb.jpg",
      "photographer_or_credit": "NASA/JPL"
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"nasa.gov/search_images","input":{"query":"Saturn rings"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Find NASA photos of Saturn's rings taken between 2004 and 2017
- Show me NASA videos about the Apollo 11 moon landing from 1969
- Look for audio recordings from Mission Control during Apollo 13 in 1970
- Search NASA images of the Hubble telescope from the 1990s, up to 20 results
- Need NASA video clips of Mars rovers created between 2010 and 2021

## Input schema

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Words to search for, for example Saturn rings."
    },
    "end_year": {
      "type": "integer",
      "maximum": 2100,
      "minimum": 1800,
      "description": "Latest creation year, for example 1970."
    },
    "media_type": {
      "enum": [
        "image",
        "video",
        "audio"
      ],
      "type": "string",
      "default": "image",
      "description": "Type of media to find, for example image."
    },
    "start_year": {
      "type": "integer",
      "maximum": 2100,
      "minimum": 1800,
      "description": "Earliest creation year, for example 1969."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum matches to return, for example 20."
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "results"
  ],
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "description",
          "date_created",
          "nasa_center",
          "photographer_or_credit",
          "keywords",
          "thumbnail_link",
          "full_size_link",
          "page_link",
          "nasa_media_id"
        ],
        "properties": {
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "keywords": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "page_link": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "nasa_center": {
            "type": [
              "string",
              "null"
            ]
          },
          "date_created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "nasa_media_id": {
            "type": "string"
          },
          "full_size_link": {
            "type": [
              "string",
              "null"
            ]
          },
          "thumbnail_link": {
            "type": [
              "string",
              "null"
            ]
          },
          "photographer_or_credit": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false
}
```

## See more

- [NASA API: Get astronomy picture of the day](https://fous.com/methods/nasa.gov/get-astronomy-picture-of-the-day.md): Returns NASA's Astronomy Picture of the Day for a date: title, explanation, featured media link, optional high-resolution link, and credit.
- [NASA API: List natural events](https://fous.com/methods/nasa.gov/list-natural-events.md): List EONET natural events with latest observations in the past number of days, most recent first. A country or region filter matches reported event locations against mapped boundaries; locations and ongoing status are approximate, and not all events have a reported size or strength.
- [NASA API: Get ISS sightings](https://fous.com/methods/nasa.gov/get-iss-sightings.md): Finds upcoming International Space Station sightings for a city in NASA's city list, with local start times, visibility and sky directions. Cities without scheduled passes return an empty list.
- [NASA API: List near-Earth asteroids](https://fous.com/methods/nasa.gov/list-near-earth-asteroids.md): Lists near-Earth asteroids that pass Earth between two UTC dates within a chosen distance, with approach times, size ranges, speed and hazard status.
- [National Archives API: Search records](https://fous.com/methods/catalog.archives.gov/search-records.md): Searches public National Archives Catalog records by keywords, year range, material type and online availability, in catalog relevance order.
- [NPR API: Search news](https://fous.com/methods/npr.org/search-news.md): Searches NPR-published articles by keyword, newest first or by best match, with optional publication dates, and returns each article's date, authors, section and summary.
- [The New York Times API: Search articles](https://fous.com/methods/nytimes.com/search-news.md): Searches New York Times article headlines and summaries by keyword, optionally within a date range, and returns matching articles with dates, authors, sections and links, newest or most relevant first.
- [Reuters API: Search news](https://fous.com/methods/reuters.com/search-news.md): Searches Reuters articles by keyword through Google News, with optional publication date range, order and page. Summaries and bylines are filled in when Reuters serves the article page.
- [All NASA methods](https://fous.com/methods/nasa.gov.md)
