# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/clios/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/clios/get-oty-of-the-year-winners \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/clios/get-specialty-oty-winners \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/clios/get-specialty-oty-winners-filtered \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/clios/get-specialty-winner-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/clios/get-winners-gallery-filtered \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/clios/list-seasons \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/clios/list-verticals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.