Browse award winners
get_award_winnersLists the winners, shortlists and longlists of the literary prizes ReadingRate tracks, grouped by year, newest first. The prizes include the Booker Prize, the International Booker Prize, the Pulitzer Prize for Fiction, the National Book Award, the Nobel Prize in Literature, the Women's Prize for Fiction, and the Hugo and Nebula awards. It also holds canonical lists, such as the Modern Library 100, and the set texts of national school curricula and exam boards. Each book links to its ReadingRate analysis.
Use when the user asks who won or was shortlisted for a literary prize, for prize-winning books from a range of years, or which books a list or a school syllabus names. It holds results only, not news about a prize or the organization behind it.
source_type picks the kind of source: "award" for prizes, "list" for canonical lists and publisher series, "curriculum" for school curricula and exam boards. Without it, prizes and lists come back and curricula do not. Each book's award_type and award_kind say which kind of source it came from. A curriculum sets a book for study; it is not a prize the book won.
Examples:
{"award": "Booker Prize", "category": "winner", "limit": 10}
{"award": "Pulitzer", "year_min": 2020, "year_max": 2024}
{"year_min": 2023, "year_max": 2023, "category": "winner"}
{"award": "AQA", "source_type": "curriculum"}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| award | No | Prize, list or syllabus name, or part of it, e.g. "Booker Prize", "Pulitzer", "Nobel", "Hugo", "AQA". When one source's name matches exactly, only that source is returned. | |
| limit | No | Maximum number of books (default 20, max 50) | |
| category | No | Only winners, only the shortlist, or only the longlist | |
| year_max | No | Latest prize year to include | |
| year_min | No | Earliest prize year to include | |
| source_type | No | Only prizes ("award"), only canonical lists and publisher series ("list"), or only school curricula and exam boards ("curriculum"). Leave it out for prizes and lists together, without curricula. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| awards | Yes | Award results grouped by year, most recent first | |
| truncated | Yes | True when more matching recognitions exist than were returned; narrow the year range or raise the limit to see more | |
| total_count | Yes | Total number of recognitions returned | |
| filters_applied | Yes | Echo of the filters used (award, year_min, year_max, category, source_type); only set filters appear |