# Clios — 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.

> Discover award-winning creative work by searching Clios.com's extensive database of specialty awards, 'Of the Year' honorees, and winners across multiple seasons and verticals. Filter results by category, year, and specialty to find inspiration from celebrated campaigns and creative excellence.

**Category:** Entertainment | **Website:** [clios.com/](https://clios.com/) | **Docs:** [parse.bot/marketplace/4db92b52-df02-4030-9e93-1e273ee9d80d/clios-com-api](https://parse.bot/marketplace/4db92b52-df02-4030-9e93-1e273ee9d80d/clios-com-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-clios-com-api-4db92b52/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_oty_of_the_year_winners

Retrieve the 'Of The Year' organizational award winners from the specialty-oty page. These are ranking awards (Agency of the Year, Network of the Year, Independent Agency of the Year) as distinct from individual specialty honorees. Single-page response.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-clios-com-api-4db92b52/get_oty_of_the_year_winners \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_specialty_oty_winners

Retrieve all specialty award winners from the specialty-oty section. Returns individual honorees and specialty award recipients across all verticals and seasons. A single-page response; no pagination parameters needed.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-clios-com-api-4db92b52/get_specialty_oty_winners \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_specialty_oty_winners_filtered

Retrieve specialty award winners filtered by vertical and/or season. Returns the same structure as get_specialty_oty_winners but narrowed to matching entries. Both parameters are optional; omitting both returns all winners.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `season` | string | No | Season year to filter by (e.g. 2025, 2026). |
| `vertical` | string | No | Vertical name to filter by. Known values: Clio Awards, Clio Music, Clio Sports, Clio Entertainment, Clio Health. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-clios-com-api-4db92b52/get_specialty_oty_winners_filtered \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"season":"<string>","vertical":"<string>"}'
```

### get_specialty_winner_detail

Retrieve detailed profile for a specific specialty winner given their detail page URL. Returns structured data including name, vertical, award type, year, job title, and biography when available. The URL is obtained from the detail_url field in get_specialty_oty_winners or get_oty_of_the_year_winners results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL or path to the winner detail page (e.g. https://clios.com/specialty-oty-awards/clio-music/2026/ryan-tedder/). Obtained from detail_url field in get_specialty_oty_winners results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-clios-com-api-4db92b52/get_specialty_winner_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_winners_gallery_filtered

Search and filter the Winners Gallery Explore page. Returns paginated winning entries with project details, award levels, and metadata. At least a vertical and season should be provided for meaningful results. Each page returns up to ~20 entries.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `award` | string | No | Award/result level filter. |
| `keywords` | string | No | Search keyword to filter results. May require site authentication to function. |
| `page` | integer | No | Page number for pagination. |
| `season` | string | No | Season year (e.g. 2024, 2025). |
| `vertical` | string | No | Vertical name. Known values: Clio Creator, Brand Storytelling, Clio Fashion & Beauty, Clio Awards, Clio Entertainment, Clio Sports, Clio Cannabis, Clio Music, Clio Health. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-clios-com-api-4db92b52/get_winners_gallery_filtered \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"award":"<string>","keywords":"<string>","page":"<integer>","season":"<string>","vertical":"<string>"}'
```

### list_seasons

Return the available seasons/years for award data, extracted from the explore page filter options. Years are ordered newest first. Useful for discovering valid season values to pass to other endpoints.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-clios-com-api-4db92b52/list_seasons \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_verticals

Return all available award verticals/programs from the winners API. Each vertical includes a numeric ID and a name combining the program name with the year (e.g. 'Clio Awards 2024'). Useful for discovering valid program IDs.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-clios-com-api-4db92b52/list_verticals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```