{"openapi":"3.1.0","info":{"title":"Game of Thrones API","version":"1.0.0","description":"The world of A Song of Ice and Fire — the books behind Game of Thrones — as an API. Look up any character (e.g. Jon Snow → culture Northmen, titles, aliases like \"Lord Snow\", and his house allegiances), the great and minor houses (e.g. House Targaryen → region The Crownlands, words \"Fire and Blood\", seats and 100+ sworn members), and the novels (e.g. A Game of Thrones → 694 pages, 434 characters, ISBN, publisher and release date). Search and filter characters by name, culture and gender, houses by name, region and words, and books by name, with paging — and follow the cross-references (parents, spouse, allegiances, books) by id. Backed by the open anapioficeandfire.com dataset. Ideal for fan sites, trivia and quiz games, Discord bots and any Westeros app.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/gameofthrones-api","description":"oanor gateway"}],"tags":[{"name":"Game of Thrones"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/book":{"get":{"operationId":"get_v1_book","tags":["Game of Thrones"],"summary":"A book by id or by name","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"Book id, e.g. 1 (A Game of Thrones)","schema":{"type":"string"},"example":"1"},{"name":"name","in":"query","required":false,"description":"Name search","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"book":{"id":1,"isbn":"978-0553103540","name":"A Game of Thrones","authors":["George R. R. Martin"],"country":"United States","released":"1996-08-01T00:00:00","publisher":"Bantam Books","media_type":"Hardcover","character_count":434,"number_of_pages":694,"pov_character_count":9}},"meta":{"timestamp":"2026-06-01T00:04:32.670Z","request_id":"cffb783c-146f-4d34-b3cf-63505721eccd"},"status":"ok","message":"Book retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/character":{"get":{"operationId":"get_v1_character","tags":["Game of Thrones"],"summary":"A character by id or filtered search","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"Character id, e.g. 583 (Jon Snow)","schema":{"type":"string"},"example":"583"},{"name":"name","in":"query","required":false,"description":"Name search, e.g. Jon Snow","schema":{"type":"string"}},{"name":"culture","in":"query","required":false,"description":"Culture, e.g. Northmen","schema":{"type":"string"}},{"name":"gender","in":"query","required":false,"description":"Male | Female","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number (default 1)","schema":{"type":"string"},"example":"1"},{"name":"pageSize","in":"query","required":false,"description":"Page size (1-50, default 10)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"character":{"id":583,"born":"In 283 AC","name":"Jon Snow","gender":"Male","titles":["Lord Commander of the Night's Watch"],"aliases":["Lord Snow","Ned Stark's Bastard","The Snow of Winterfell","The Crow-Come-Over","The 998th Lord Commander of the Night's Watch","The Bastard of Winterfell","The Black Bastard of the Wall","Lord Crow"],"culture":"Northmen","book_ids":[5],"played_by":["Kit Harington"],"tv_series":["Season 1","Season 2","Season 3","Season 4","Season 5","Season 6"],"allegiance_house_ids":[362]}},"meta":{"timestamp":"2026-06-01T00:04:32.772Z","request_id":"97a29067-59f2-4b11-938b-987cc53a05a4"},"status":"ok","message":"Character retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/house":{"get":{"operationId":"get_v1_house","tags":["Game of Thrones"],"summary":"A house by id or filtered search","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"House id, e.g. 378 (House Targaryen)","schema":{"type":"string"},"example":"378"},{"name":"name","in":"query","required":false,"description":"Name search","schema":{"type":"string"}},{"name":"region","in":"query","required":false,"description":"Region, e.g. The North","schema":{"type":"string"}},{"name":"words","in":"query","required":false,"description":"House words search","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"string"},"example":"1"},{"name":"pageSize","in":"query","required":false,"description":"Page size (1-50, default 10)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"house":{"id":378,"name":"House Targaryen of King's Landing","seats":["Red Keep (formerly)","Summerhall (formerly)"],"words":"Fire and Blood","region":"The Crownlands","titles":["King of the Andals, the Rhoynar and the First Men","Lord of the Seven Kingdoms","Prince of Summerhall"],"founded":"House Targaryen: >114 BCHouse Targaryen of King's Landing:1 AC","coat_of_arms":"Sable, a dragon thrice-headed gules","current_lord_id":1303,"cadet_branch_ids":[23],"ancestral_weapons":["Blackfyre","Dark Sister"],"sworn_member_count":101}},"meta":{"timestamp":"2026-06-01T00:04:32.839Z","request_id":"e3ee942a-aa30-48b6-b2d8-7a97b595ea60"},"status":"ok","message":"House retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Filters & usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The world of A Song of Ice and Fire (Game of Thrones). /v1/character = a character by id or search (name, culture, gender; e.g. id=583 → Jon Snow); /v1/house = a house by id or filter (name, region, words; e.g. id=378 → House Targaryen); /v1/book = a book by id or by name. Add page & pageSize to paginate. Relations (father, allegiances, books, …) are returned as ids.","source":"An API of Ice and Fire (anapioficeandfire.com)","filters":{"book":["name"],"house":["name","region","words"],"character":["name","culture","gender"]},"endpoints":["/v1/character","/v1/house","/v1/book","/v1/meta"]},"meta":{"timestamp":"2026-06-01T00:04:32.908Z","request_id":"96576157-2aa8-4b34-b820-c63ee3462f17"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":9500,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":320,"monthly_call_quota":135000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1020,"monthly_call_quota":660000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3160,"monthly_call_quota":2750000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/gameofthrones-api"}