# Huntington — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search over 1 million items from The Huntington Library, Art Museum, and Botanical Gardens, including rare books, manuscripts, paintings, drawings, sculptures, and plants. Filter and explore collections across library, museum, and botanical divisions using faceted search capabilities.

**Category:** Education | **Website:** [www.huntington.org/collections/search](https://www.huntington.org/collections/search) | **Docs:** [parse.bot/marketplace/282ee7f6-bdf3-466a-8d16-d3dd4722e10a/huntington-org-api](https://parse.bot/marketplace/282ee7f6-bdf3-466a-8d16-d3dd4722e10a/huntington-org-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-huntington-org-api-282ee7f6/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_facets

Get available facet values and counts for filtering collections. Returns counts for divisions, item types, genera, families, authors, and constituents, optionally scoped to a search query or division. Useful for discovering filter options before searching.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `division` | string | No | Filter facets by division: 'library', 'museum', or 'botanical' |
| `query` | string | No | Optional search query to scope facet counts |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-huntington-org-api-282ee7f6/get_facets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"division":"<string>","query":"<string>"}'
```

### search_collections

Search The Huntington's collections by keyword with optional filters for division, item type, and image availability. Returns paginated results with item details including name, description, division, type, identifier, and image URL. Each page returns up to `limit` items; advance `page` (0-indexed) to paginate. An empty query returns all items in the matching scope.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `division` | string | No | Filter by division: 'library', 'museum', or 'botanical' |
| `has_image` | string | No | Set to 'true' to only return items with images |
| `limit` | integer | No | Results per page, clamped to 1-100 |
| `page` | integer | No | Page number (0-indexed) |
| `query` | string | No | Search keywords (e.g., 'William Blake', 'rose', 'painting') |
| `type` | string | No | Filter by item type (e.g., 'Paintings', 'Rare Books', 'Manuscripts', 'Plants', 'Drawings', 'Sculpture', 'Prints', 'Visual Materials', 'Decorative arts', 'Photographs') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-huntington-org-api-282ee7f6/search_collections \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"division":"<string>","has_image":"<string>","limit":"<integer>","page":"<integer>","query":"<string>","type":"<string>"}'
```