clios.com 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.
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'
Retrieve all specialty award winners from the specialty-oty section. Returns individual honorees and specialty award recipients across all verticals and seasons.
No input parameters required.
{
"type": "object",
"fields": {
"winners": "array of winner objects containing winner_name, vertical, award_type, detail_url, and image_url"
},
"sample": {
"data": {
"winners": [
{
"vertical": "Clio Awards",
"image_url": null,
"award_type": "Honorary Award",
"detail_url": "https://clios.com/specialty-oty-awards/the-clio-awards/2026/mark-ronson/",
"winner_name": "Mark Ronson"
}
]
},
"status": "success"
}
}About the clios.com 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.
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.
- 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 | 250 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.