> For the complete documentation index, see [llms.txt](https://doc.duaer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/getting-started/smithsonian.md).

# Smithsonian collections in Duaer

In Duaer: Smithsonian Open Access: objects, specimens, and archives from Smithsonian museums, with images and 3D models. One successful search uses 1 credit.
## What you get

Duaer Smithsonian collections searches Smithsonian Open Access records across its museums, libraries, and archives. Keep only objects with images when you need pictures. Duaer holds the upstream API key; you only send your Duaer key.

Pick Duaer Data → Smithsonian collections in the node creator, or open the [data market](/getting-started/data-market.md). Related: [The Met collection](/getting-started/met-museum.md), [V&A collections](/getting-started/vam-museum.md).

## When to use it

- Find Apollo 11 objects at the Air and Space Museum.
- Collect CC0 images of historic quilts.

## When not to use it

- The Met collection. Use [The Met collection](/getting-started/met-museum.md).
- Design objects at the V&A. Use [V&A collections](/getting-started/vam-museum.md).

## Search on the canvas

1. Open the node creator and pick Duaer Data → Smithsonian collections.
2. Fill Words (such as Apollo 11). Optional: With Images Only (yes).
3. Limit defaults to 10, max 20. Execute.

A search uses 1 credit only when it returns rows. No rows, wrong input, or an upstream failure uses 0.

## Call the API

- GET https://api.duaer.com/v1/data/smithsonian?words=Apollo%2011
- Authorization: Bearer <Duaer key>

The call skill below matches Copy skill in the Duaer data market, with parameters, examples, and result fields.

## Call skill

Same text as Copy skill.

```
---
name: duaer-smithsonian
description: >-
  Duaer Smithsonian collections. Smithsonian Open Access: objects, specimens, and archives from Smithsonian museums, with images and 3D models.
  One successful search uses 1 Duaer credit.
---

# Duaer Smithsonian collections

Duaer Smithsonian collections searches Smithsonian Open Access records across its museums, libraries, and archives. Keep only objects with images when you need pictures. Duaer holds the upstream API key; you only send your Duaer key.

## When to use

- Find Apollo 11 objects at the Air and Space Museum.
- Collect CC0 images of historic quilts.

## When not to use

- The Met collection. Use https://skills.duaer.com/met-museum.md.
- Design objects at the V&A. Use https://skills.duaer.com/vam-museum.md.

## Call

`GET https://api.duaer.com/v1/data/smithsonian?words=Apollo%2011`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

Get a Duaer key: https://skills.duaer.com/keys.md

## Parameters

Provide `words`.

- `words` — Object, person, or subject such as Apollo 11.
- `withMedia` — Optional. `yes` to keep objects with images.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/smithsonian?words=Apollo%2011` — Apollo 11 objects and publications.
- `GET https://api.duaer.com/v1/data/smithsonian?words=quilt&withMedia=yes` — quilts with images.

## Result

The response is `{ "items": [...] }`. Each item has `source`, `title`, `url`, and `summary`, plus:

- `recordId`, `unit` — Smithsonian record and museum or archive.
- `objectType`, `maker`, `date`, `place` — what, who, when, and where.
- `image`, `mediaType`, `usage` — image link, media kind, and reuse terms such as CC0.
- `recordLink` — the record link Smithsonian publishes.

Fields without a value are left out.

## Credits

A search that returns at least one row uses 1 credit.
An empty search, a search that finds nothing, or a failed search uses 0.
Wrong input returns 400 with a message and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

## Related

- https://skills.duaer.com/met-museum.md — Duaer The Met collection
- https://skills.duaer.com/vam-museum.md — Duaer V&A collections

```
## Questions

### How many credits does a Smithsonian collections search use in Duaer?

One credit when Duaer returns rows. A search with no rows or an error uses 0.

### Can I reuse images from Duaer Smithsonian collections?

Images whose usage is CC0 are free to reuse. For others, follow the terms Smithsonian states.

## Related

- [The Met collection in Duaer](https://doc.duaer.com/getting-started/met-museum.md)
- [V&A collections in Duaer](https://doc.duaer.com/getting-started/vam-museum.md)