Clios APIclios.com ↗
Access Clio Awards winner data across verticals, seasons, and award levels. Filter specialty awards, Of the Year honorees, and gallery entries via 7 endpoints.
What is the Clios API?
The Clios.com API exposes 7 endpoints covering winner data from the Clio Awards ecosystem, including specialty honorees, 'Of the Year' organizational awards, and a paginated winners gallery. The get_winners_gallery_filtered endpoint alone returns fields like winner_name, project_name, award_level, vertical, location, and year, filterable by season, vertical, and award tier. It also provides discovery utilities via list_verticals and list_seasons to enumerate valid filter values before querying.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/5c52dff9-b17c-4c5c-968b-a62b92ffc4a8/get_specialty_oty_winners' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace clios-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Clios.com Awards SDK — browse honorees, gallery entries, and verticals."""
from parse_apis.clios_com_awards_api import Clios, AwardLevel, WinnerNotFound
client = Clios()
# List all specialty honorees across verticals and seasons.
for honoree in client.honorees.list(limit=5):
print(honoree.winner_name, honoree.vertical, honoree.award_type)
# Filter specialty honorees by vertical and season.
music_honoree = client.honorees.search(vertical="Clio Music", season="2026", limit=1).first()
if music_honoree:
# Drill into the honoree's full profile via sub-resource.
profile = music_honoree.profile.get()
print(profile.name, profile.award_type, profile.year, profile.job_title)
# Organizational "Of The Year" awards (Agency OTY, Network OTY, etc.)
for oty in client.honorees.list_oty(limit=3):
print(oty.winner_name, oty.award_type)
# Search the Winners Gallery with an award-level enum filter.
for entry in client.galleryentries.search(vertical="Clio Awards", season="2024", award=AwardLevel.GRAND, limit=3):
print(entry.project_name, entry.award_level, entry.location)
# Typed error handling on a detail fetch.
try:
gone = client.honoree(detail_url="https://clios.com/specialty-oty-awards/clio-music/2026/nonexistent/").profile.get()
except WinnerNotFound as exc:
print(f"Profile removed: {exc.url}")
# Discover available verticals and seasons.
for v in client.verticals.list(limit=5):
print(v.id, v.name)
print("exercised: honorees.list / honorees.search / honoree.profile.get / honorees.list_oty / galleryentries.search / verticals.list")
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.
No input parameters required.
{
"type": "object",
"fields": {
"winners": "array of honoree objects each with winner_name, vertical, award_type, detail_url, and image_url"
},
"sample": {
"data": {
"winners": [
{
"vertical": "Clio Health",
"image_url": "https://media.clios.com/wp-content/uploads/2026/06/08134029/CH26_2x1_extended.jpg",
"award_type": "Impact Award",
"detail_url": "https://clios.com/specialty-oty-awards/clio-health/2026/calvin-anderson/",
"winner_name": "Calvin Anderson"
}
]
},
"status": "success"
}
}About the Clios API
What the API Covers
The Clios.com API surfaces winner records across multiple award programs — Clio Awards, Clio Music, Clio Sports, Clio Entertainment, Clio Fashion & Beauty, Brand Storytelling, and Clio Creator. Data is organized around two distinct award tracks: specialty and 'Of the Year' honorees (individuals and organizations) via get_specialty_oty_winners and get_oty_of_the_year_winners, and the broader winners gallery accessible through get_winners_gallery_filtered.
Filtering and Discovery
Before running filtered queries, call list_verticals to get current vertical IDs and names (formatted as 'Clio Awards 2024') and list_seasons to retrieve available award years ordered newest first. Pass those values into get_specialty_oty_winners_filtered using the vertical and season parameters, or into get_winners_gallery_filtered which additionally accepts page, award (tier values include Shortlist, Bronze, Silver, Gold, Grand, Winner), and keywords. Note that keyword search on the source site requires authentication and may not return results through this endpoint.
Detail Records
get_specialty_winner_detail accepts a full detail page URL (e.g. a path under /specialty-oty-awards/clio-music/2026/) and returns structured fields: name, year, vertical, job_title, award_type, description, and html_content. Fields like job_title and description are nullable when the source page omits them. The winners gallery returns paginated results with a has_more boolean to drive pagination loops using the page parameter.
The Clios API is a managed, monitored endpoint for clios.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when clios.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official clios.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track which agencies won Agency of the Year across multiple Clio seasons using
get_oty_of_the_year_winners - Build a creative benchmark database by pulling Gold and Grand winners from
get_winners_gallery_filteredfiltered by vertical and year - Enrich a brand research tool with Clio-winning campaign names and project details using the
project_nameandaward_levelfields - Generate a ranked shortlist of award-winning creative work in a specific vertical (e.g. Clio Music) for a given season
- Power a competitive intelligence dashboard showing which locations and agencies appear most frequently in winner records
- Populate an awards history profile for a company by matching
winner_nameacross specialty and gallery endpoints - Enumerate all available verticals and seasons programmatically before building a filtered query pipeline
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Clios.com have an official public developer API?+
How does `get_winners_gallery_filtered` differ from the specialty endpoints?+
get_winners_gallery_filtered covers the broad winners gallery with fields like project_name, award_level, and location, and supports pagination via page with a has_more flag. The specialty endpoints (get_specialty_oty_winners, get_oty_of_the_year_winners) are scoped to the specialty-oty section and return individual honorees and organizational award recipients without pagination. Both share the winner_name, vertical, award_type, detail_url, and image_url fields.Does keyword search work in `get_winners_gallery_filtered`?+
keywords parameter may not return results because keyword search on the source site requires a logged-in session. Filtering by vertical, season, and award level works without authentication and is the reliable way to narrow results.Does the API return finalist or entry-level submission data beyond what's in the winners gallery?+
Are detail fields like `job_title` and `description` always populated in `get_specialty_winner_detail`?+
job_title and description are nullable — they return null when the corresponding winner's detail page does not include that information. html_content is also nullable. Only name, year, vertical, and award_type are consistently present.