An API of Ice and Fire

Look up the world of A Song of Ice and Fire - and of HBO's Game of Thrones - using An API of Ice and Fire, the free, keyless, community database of the books. Search the books by title or release date, the characters by name, culture, gender, birth, death or whether they are still alive, and the houses by region, words, seats, titles, ancestral weapons or whether they have died out. Fetch any single record by id, or take the shortcuts the raw endpoints do not offer: the narrators of a book, a character's parents, spouse and allegiances, or a house's lord, heir, founder and sworn members, each resolved in one step. No account or API key required. Disclaimer: this is an independent integration with the community-run An API of Ice and Fire (anapioficeandfire.com), created by Joakim Skoog. It is not affiliated with, endorsed by, or sponsored by George R. R. Martin, Bantam Books, Penguin Random House, or HBO; A Song of Ice and Fire, Game of Thrones and all related names, characters and trademarks are the property of their respective owners.

Actions

Action	What it does
Get a book	Get one book by id, with its ISBN, publisher, page count, release date, and the ids of its characters and POV narrators.
Get a book's POV characters	Get the characters who narrate a book, as whole records rather than the URLs the book carries: who they are, what they are called, whether they are alive, and who played them on screen.
Get a character	Get one character by id: their titles and aliases, culture, birth and death, the houses they are sworn to, the books they appear in and narrate, and who played them on screen.
Get a character's relations	Get a character together with their father, mother, spouse and the houses they are sworn to, all resolved into whole records in one step.
Get a house	Get one house by id: its words, coat of arms, region, seats, titles, ancestral weapons, when it was founded or died out, and the ids of its lord, heir, overlord, cadet branches and sworn members.
Get a house's members	Get who a house is: its current lord, heir, founder and overlord, plus its sworn members, all resolved into whole records in one step.
Search books	List the books of A Song of Ice and Fire, optionally filtered by title or by when they were released.
Search characters	Search the characters of the world of Ice and Fire by name, gender, culture, where or when they were born or died, and whether they are still alive.
Search houses	Search the houses of Westeros and beyond by name, region or words, and by whether they have words, titles, seats or ancestral weapons at all - or whether they have died out.

Get a book

Get one book by id, with its ISBN, publisher, page count, release date, and the ids of its characters and POV narrators.

Inputs

Bookbook_idtextRequired: Pick a book, or reference one from an earlier step by its id or by one of the API's book URLs (an entry from a character's 'books', say).

Outputs

bookobject: The book.

Example output

{
  "book": {
    "author_names": [
      "George R. R. Martin"
    ],
    "authors": [
      "George R. R. Martin"
    ],
    "character_count": 2,
    "character_ids": [
      2,
      12
    ],
    "characters": [
      "https://www.anapioficeandfire.com/api/characters/2",
      "https://www.anapioficeandfire.com/api/characters/12"
    ],
    "country": "United States",
    "id": 1,
    "isbn": "978-0553103540",
    "mediaType": "Hardcover",
    "name": "A Game of Thrones",
    "numberOfPages": 694,
    "povCharacters": [
      "https://www.anapioficeandfire.com/api/characters/148",
      "https://www.anapioficeandfire.com/api/characters/583"
    ],
    "pov_character_count": 2,
    "pov_character_ids": [
      148,
      583
    ],
    "publisher": "Bantam Books",
    "release_date": "1996-08-01",
    "release_year": 1996,
    "released": "1996-08-01T00:00:00",
    "url": "https://www.anapioficeandfire.com/api/books/1"
  }
}

Get a book's POV characters

Get the characters who narrate a book, as whole records rather than the URLs the book carries: who they are, what they are called, whether they are alive, and who played them on screen. The book lists its narrators as links, so this does the per-narrator lookups in one step, up to the limit you set.

Inputs

Bookbook_idtextRequired: Pick a book, or reference one from an earlier step by its id or by one of the API's book URLs.
Limitlimitnumber: Optional. How many linked records to fetch, 1 to 50 (default 10). Each one is a separate request to the API, and the result says how many were left behind.From 1 to 50. Default: 10.

Outputs

book_idnumber: The id of the book that was read.
book_nametext: The book's title.
countnumber: How many narrators were fetched.
has_moretrue/false: True when the limit stopped short of the book's full list of narrators.
limitnumber: The limit this step ran with.
pov_characterslist: The narrators that were fetched, in the book's own order.
total_countnumber: How many narrators the book has in total.

Example output

{
  "book_id": 1,
  "book_name": "A Game of Thrones",
  "count": 1,
  "has_more": true,
  "limit": 1,
  "pov_characters": [
    {
      "alias_names": [
        "Lord Snow",
        "Ned Stark's Bastard",
        "The Snow of Winterfell"
      ],
      "aliases": [
        "Lord Snow",
        "Ned Stark's Bastard",
        "The Snow of Winterfell"
      ],
      "allegiance_count": 1,
      "allegiance_ids": [
        362
      ],
      "allegiances": [
        "https://www.anapioficeandfire.com/api/houses/362"
      ],
      "book_count": 1,
      "book_ids": [
        5
      ],
      "books": [
        "https://www.anapioficeandfire.com/api/books/5"
      ],
      "born": "In 283 AC",
      "culture": "Northmen",
      "died": "",
      "display_name": "Jon Snow",
      "father": "",
      "father_id": null,
      "gender": "Male",
      "id": 583,
      "is_alive": true,
      "is_pov_character": true,
      "mother": "",
      "mother_id": null,
      "name": "Jon Snow",
      "playedBy": [
        "Kit Harington"
      ],
      "played_by_names": [
        "Kit Harington"
      ],
      "povBooks": [
        "https://www.anapioficeandfire.com/api/books/1",
        "https://www.anapioficeandfire.com/api/books/2"
      ],
      "pov_book_ids": [
        1,
        2
      ],
      "spouse": "",
      "spouse_id": null,
      "title_names": [
        "Lord Commander of the Night's Watch"
      ],
      "titles": [
        "Lord Commander of the Night's Watch"
      ],
      "tvSeries": [
        "Season 1",
        "Season 2",
        "Season 3",
        "Season 4",
        "Season 5"
      ],
      "tv_series_names": [
        "Season 1",
        "Season 2",
        "Season 3",
        "Season 4",
        "Season 5"
      ],
      "url": "https://www.anapioficeandfire.com/api/characters/583"
    }
  ],
  "total_count": 9
}

Get a character

Get one character by id: their titles and aliases, culture, birth and death, the houses they are sworn to, the books they appear in and narrate, and who played them on screen.

Inputs

Charactercharacter_idtextRequired: The character's id, or one of the API's character URLs from an earlier step (a book's POV characters, a house's sworn members, a character's father). Search characters is how to turn a name into an id.

Outputs

characterobject: The character.

Example output

{
  "character": {
    "alias_names": [
      "Lord Snow",
      "Ned Stark's Bastard",
      "The Snow of Winterfell"
    ],
    "aliases": [
      "Lord Snow",
      "Ned Stark's Bastard",
      "The Snow of Winterfell"
    ],
    "allegiance_count": 1,
    "allegiance_ids": [
      362
    ],
    "allegiances": [
      "https://www.anapioficeandfire.com/api/houses/362"
    ],
    "book_count": 1,
    "book_ids": [
      5
    ],
    "books": [
      "https://www.anapioficeandfire.com/api/books/5"
    ],
    "born": "In 283 AC",
    "culture": "Northmen",
    "died": "",
    "display_name": "Jon Snow",
    "father": "",
    "father_id": null,
    "gender": "Male",
    "id": 583,
    "is_alive": true,
    "is_pov_character": true,
    "mother": "",
    "mother_id": null,
    "name": "Jon Snow",
    "playedBy": [
      "Kit Harington"
    ],
    "played_by_names": [
      "Kit Harington"
    ],
    "povBooks": [
      "https://www.anapioficeandfire.com/api/books/1",
      "https://www.anapioficeandfire.com/api/books/2"
    ],
    "pov_book_ids": [
      1,
      2
    ],
    "spouse": "",
    "spouse_id": null,
    "title_names": [
      "Lord Commander of the Night's Watch"
    ],
    "titles": [
      "Lord Commander of the Night's Watch"
    ],
    "tvSeries": [
      "Season 1",
      "Season 2",
      "Season 3",
      "Season 4",
      "Season 5"
    ],
    "tv_series_names": [
      "Season 1",
      "Season 2",
      "Season 3",
      "Season 4",
      "Season 5"
    ],
    "url": "https://www.anapioficeandfire.com/api/characters/583"
  }
}

Get a character's relations

Get a character together with their father, mother, spouse and the houses they are sworn to, all resolved into whole records in one step. The API links each of those by URL, so reading a family through the endpoints alone is a step per relative. A relative the API does not record comes back as null rather than as an error - most characters have no recorded parents.

Inputs

Charactercharacter_idtextRequired: The character's id, or one of the API's character URLs from an earlier step.

Outputs

allegiance_countnumber: How many houses were fetched.
allegianceslist: The houses they are sworn to.
characterobject: The character themselves.
fatherobject: Their father, or null when the API records none.
has_parentstrue/false: True when a father or a mother was found.
motherobject: Their mother, or null when the API records none.
relatives_foundnumber: How many of the father, mother and spouse the API had on record, 0 to 3.
spouseobject: Their spouse, or null when the API records none.
total_allegiancesnumber: How many houses the character is sworn to in total.

Example output

{
  "allegiance_count": 1,
  "allegiances": [
    {
      "ancestralWeapons": [
        "Ice"
      ],
      "ancestral_weapon_names": [
        "Ice"
      ],
      "cadetBranches": [
        "https://www.anapioficeandfire.com/api/houses/17",
        "https://www.anapioficeandfire.com/api/houses/303"
      ],
      "cadet_branch_count": 2,
      "cadet_branch_ids": [
        17,
        303
      ],
      "coatOfArms": "A grey direwolf on a white field. (Argent, a direwolf courant cendree)",
      "currentLord": "",
      "current_lord_id": null,
      "diedOut": "",
      "founded": "Age of Heroes",
      "founder": "",
      "founder_id": null,
      "has_died_out": false,
      "heir": "",
      "heir_id": null,
      "id": 362,
      "name": "House Stark of Winterfell",
      "overlord": "",
      "overlord_id": null,
      "region": "The North",
      "seat_names": [
        "Winterfell"
      ],
      "seats": [
        "Winterfell"
      ],
      "swornMembers": [
        "https://www.anapioficeandfire.com/api/characters/583",
        "https://www.anapioficeandfire.com/api/characters/1052"
      ],
      "sworn_member_count": 2,
      "sworn_member_ids": [
        583,
        1052
      ],
      "title_names": [
        "King in the North",
        "Lord of Winterfell",
        "Warden of the North"
      ],
      "titles": [
        "King in the North",
        "Lord of Winterfell",
        "Warden of the North"
      ],
      "url": "https://www.anapioficeandfire.com/api/houses/362",
      "words": "Winter is Coming"
    }
  ],
  "character": {
    "alias_names": [
      "Lord Snow",
      "Ned Stark's Bastard",
      "The Snow of Winterfell"
    ],
    "aliases": [
      "Lord Snow",
      "Ned Stark's Bastard",
      "The Snow of Winterfell"
    ],
    "allegiance_count": 1,
    "allegiance_ids": [
      362
    ],
    "allegiances": [
      "https://www.anapioficeandfire.com/api/houses/362"
    ],
    "book_count": 1,
    "book_ids": [
      5
    ],
    "books": [
      "https://www.anapioficeandfire.com/api/books/5"
    ],
    "born": "In 283 AC",
    "culture": "Northmen",
    "died": "",
    "display_name": "Jon Snow",
    "father": "",
    "father_id": null,
    "gender": "Male",
    "id": 583,
    "is_alive": true,
    "is_pov_character": true,
    "mother": "",
    "mother_id": null,
    "name": "Jon Snow",
    "playedBy": [
      "Kit Harington"
    ],
    "played_by_names": [
      "Kit Harington"
    ],
    "povBooks": [
      "https://www.anapioficeandfire.com/api/books/1",
      "https://www.anapioficeandfire.com/api/books/2"
    ],
    "pov_book_ids": [
      1,
      2
    ],
    "spouse": "",
    "spouse_id": null,
    "title_names": [
      "Lord Commander of the Night's Watch"
    ],
    "titles": [
      "Lord Commander of the Night's Watch"
    ],
    "tvSeries": [
      "Season 1",
      "Season 2",
      "Season 3",
      "Season 4",
      "Season 5"
    ],
    "tv_series_names": [
      "Season 1",
      "Season 2",
      "Season 3",
      "Season 4",
      "Season 5"
    ],
    "url": "https://www.anapioficeandfire.com/api/characters/583"
  },
  "father": null,
  "has_parents": false,
  "mother": null,
  "relatives_found": 0,
  "spouse": null,
  "total_allegiances": 1
}

Get a house

Get one house by id: its words, coat of arms, region, seats, titles, ancestral weapons, when it was founded or died out, and the ids of its lord, heir, overlord, cadet branches and sworn members.

Inputs

Househouse_idtextRequired: Pick a house, or reference one from an earlier step by its id or by one of the API's house URLs (an entry from a character's 'allegiances', say).

Outputs

houseobject: The house.

Example output

{
  "house": {
    "ancestralWeapons": [
      "Ice"
    ],
    "ancestral_weapon_names": [
      "Ice"
    ],
    "cadetBranches": [
      "https://www.anapioficeandfire.com/api/houses/17",
      "https://www.anapioficeandfire.com/api/houses/303"
    ],
    "cadet_branch_count": 2,
    "cadet_branch_ids": [
      17,
      303
    ],
    "coatOfArms": "A grey direwolf on a white field. (Argent, a direwolf courant cendree)",
    "currentLord": "",
    "current_lord_id": null,
    "diedOut": "",
    "founded": "Age of Heroes",
    "founder": "",
    "founder_id": null,
    "has_died_out": false,
    "heir": "",
    "heir_id": null,
    "id": 362,
    "name": "House Stark of Winterfell",
    "overlord": "",
    "overlord_id": null,
    "region": "The North",
    "seat_names": [
      "Winterfell"
    ],
    "seats": [
      "Winterfell"
    ],
    "swornMembers": [
      "https://www.anapioficeandfire.com/api/characters/583",
      "https://www.anapioficeandfire.com/api/characters/1052"
    ],
    "sworn_member_count": 2,
    "sworn_member_ids": [
      583,
      1052
    ],
    "title_names": [
      "King in the North",
      "Lord of Winterfell",
      "Warden of the North"
    ],
    "titles": [
      "King in the North",
      "Lord of Winterfell",
      "Warden of the North"
    ],
    "url": "https://www.anapioficeandfire.com/api/houses/362",
    "words": "Winter is Coming"
  }
}

Get a house's members

Get who a house is: its current lord, heir, founder and overlord, plus its sworn members, all resolved into whole records in one step. The house links every one of them by URL, and the great houses have hundreds of sworn members, so the sworn-member lookups stop at the limit you set and the result says how many were left behind.

Inputs

Househouse_idtextRequired: Pick a house, or reference one from an earlier step by its id or by one of the API's house URLs.
Limitlimitnumber: Optional. How many linked records to fetch, 1 to 50 (default 10). Each one is a separate request to the API, and the result says how many were left behind.From 1 to 50. Default: 10.

Outputs

current_lordobject: Its current lord, or null when the API records none.
founderobject: The character who founded it, or null when unrecorded.
has_moretrue/false: True when the limit stopped short of the house's full list of sworn members.
heirobject: Its heir, or null when the API records none.
house_idnumber: The id of the house that was read.
house_nametext: The house's name.
limitnumber: The limit this step ran with.
overlordobject: The house it answers to, or null when it answers to none.
sworn_member_countnumber: How many sworn members were fetched.
sworn_memberslist: The sworn members that were fetched, in the house's own order.
total_sworn_membersnumber: How many sworn members the house has in total.

Example output

{
  "current_lord": null,
  "founder": null,
  "has_more": true,
  "heir": null,
  "house_id": 362,
  "house_name": "House Stark of Winterfell",
  "limit": 1,
  "overlord": null,
  "sworn_member_count": 1,
  "sworn_members": [
    {
      "alias_names": [
        "Lord Snow",
        "Ned Stark's Bastard",
        "The Snow of Winterfell"
      ],
      "aliases": [
        "Lord Snow",
        "Ned Stark's Bastard",
        "The Snow of Winterfell"
      ],
      "allegiance_count": 1,
      "allegiance_ids": [
        362
      ],
      "allegiances": [
        "https://www.anapioficeandfire.com/api/houses/362"
      ],
      "book_count": 1,
      "book_ids": [
        5
      ],
      "books": [
        "https://www.anapioficeandfire.com/api/books/5"
      ],
      "born": "In 283 AC",
      "culture": "Northmen",
      "died": "",
      "display_name": "Jon Snow",
      "father": "",
      "father_id": null,
      "gender": "Male",
      "id": 583,
      "is_alive": true,
      "is_pov_character": true,
      "mother": "",
      "mother_id": null,
      "name": "Jon Snow",
      "playedBy": [
        "Kit Harington"
      ],
      "played_by_names": [
        "Kit Harington"
      ],
      "povBooks": [
        "https://www.anapioficeandfire.com/api/books/1",
        "https://www.anapioficeandfire.com/api/books/2"
      ],
      "pov_book_ids": [
        1,
        2
      ],
      "spouse": "",
      "spouse_id": null,
      "title_names": [
        "Lord Commander of the Night's Watch"
      ],
      "titles": [
        "Lord Commander of the Night's Watch"
      ],
      "tvSeries": [
        "Season 1",
        "Season 2",
        "Season 3",
        "Season 4",
        "Season 5"
      ],
      "tv_series_names": [
        "Season 1",
        "Season 2",
        "Season 3",
        "Season 4",
        "Season 5"
      ],
      "url": "https://www.anapioficeandfire.com/api/characters/583"
    }
  ],
  "total_sworn_members": 2
}

Search books

List the books of A Song of Ice and Fire, optionally filtered by title or by when they were released. Each book comes back with its ISBN, publisher, page count, release date, and the ids of every character in it and every character who narrates a chapter of it. With no filter set this is the whole bibliography, novellas included. No API key required.

Inputs

Titlenametext: Optional. Filter by the book's title, e.g. 'A Game of Thrones'. The API matches the whole value rather than part of one, so it has to be spelled the way the API spells it.
Released on or afterfrom_release_datedate: Optional. Only include books released on or after this date.
Released on or beforeto_release_datedate: Optional. Only include books released on or before this date.
Pagepagenumber: Optional. Which page of results to return; the first page by default. Each result carries the next page number when there is one, so a workflow can walk the whole set.From 1 to 100000. Default: 1.
Results per pagepage_sizenumber: Optional. How many records to return per page, 1 to 50 (default 10). The API serves no more than that in one page.From 1 to 50. Default: 10.

Outputs

bookslist: The matching books, in the API's own order.
countnumber: How many records came back on this page.
has_moretrue/false: True when the API offered a next page.
next_pagenumber: The page number to ask for next, or null on the last page.
pagenumber: Which page this is.
page_sizenumber: How many records a full page holds.
previous_pagenumber: The page number before this one, or null on the first page.
total_pagesnumber: How many pages the search has in total, from the API's own paging links. Zero when nothing matched, and null when there is more to come but the API did not say how much. The API publishes no total record count anywhere, so there is none to report.

Example output

{
  "books": [
    {
      "author_names": [
        "George R. R. Martin"
      ],
      "authors": [
        "George R. R. Martin"
      ],
      "character_count": 2,
      "character_ids": [
        2,
        12
      ],
      "characters": [
        "https://www.anapioficeandfire.com/api/characters/2",
        "https://www.anapioficeandfire.com/api/characters/12"
      ],
      "country": "United States",
      "id": 1,
      "isbn": "978-0553103540",
      "mediaType": "Hardcover",
      "name": "A Game of Thrones",
      "numberOfPages": 694,
      "povCharacters": [
        "https://www.anapioficeandfire.com/api/characters/148",
        "https://www.anapioficeandfire.com/api/characters/583"
      ],
      "pov_character_count": 2,
      "pov_character_ids": [
        148,
        583
      ],
      "publisher": "Bantam Books",
      "release_date": "1996-08-01",
      "release_year": 1996,
      "released": "1996-08-01T00:00:00",
      "url": "https://www.anapioficeandfire.com/api/books/1"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_page": null,
  "page": 1,
  "page_size": 10,
  "previous_page": null,
  "total_pages": 1
}

Search characters

Search the characters of the world of Ice and Fire by name, gender, culture, where or when they were born or died, and whether they are still alive. Each one comes back with their titles, aliases, the houses they are sworn to, the books they appear in, the seasons of Game of Thrones they appear in and the actors who played them. This is also how a workflow turns a name into the id the other character actions take.

Inputs

Namenametext: Optional. Filter by the character's name, e.g. 'Jon Snow'. The API matches the whole value rather than part of one, so it has to be spelled the way the API spells it. Many characters are held under an alias instead of a name, so a search that finds nothing is worth retrying against the alias.
Gendergendertext: Optional. Filter by gender.One of: Male, Female, Unknown.
Cultureculturetext: Optional. Filter by the culture a character belongs to, e.g. 'Braavosi' or 'Northmen'. The API matches the whole value rather than part of one, so it has to be spelled the way the API spells it.
Bornborntext: Optional. Filter by the API's own text for when and where a character was born, e.g. 'In 283 AC'. It is free text in the data, so this matches the whole phrase as the API spells it.
Dieddiedtext: Optional. Filter by the API's own text for when and where a character died, e.g. 'In 300 AC, at Castle Black'. Free text in the data, matched whole.
Aliveis_alivetrue/false: Optional. Yes for characters the API records no death for, No for the dead. Leave it unset for both.
Pagepagenumber: Optional. Which page of results to return; the first page by default. Each result carries the next page number when there is one, so a workflow can walk the whole set.From 1 to 100000. Default: 1.
Results per pagepage_sizenumber: Optional. How many records to return per page, 1 to 50 (default 10). The API serves no more than that in one page.From 1 to 50. Default: 10.

Outputs

characterslist: The matching characters, in the API's own order.
countnumber: How many records came back on this page.
has_moretrue/false: True when the API offered a next page.
next_pagenumber: The page number to ask for next, or null on the last page.
pagenumber: Which page this is.
page_sizenumber: How many records a full page holds.
previous_pagenumber: The page number before this one, or null on the first page.
total_pagesnumber: How many pages the search has in total, from the API's own paging links. Zero when nothing matched, and null when there is more to come but the API did not say how much. The API publishes no total record count anywhere, so there is none to report.

Example output

{
  "characters": [
    {
      "alias_names": [
        "Lord Snow",
        "Ned Stark's Bastard",
        "The Snow of Winterfell"
      ],
      "aliases": [
        "Lord Snow",
        "Ned Stark's Bastard",
        "The Snow of Winterfell"
      ],
      "allegiance_count": 1,
      "allegiance_ids": [
        362
      ],
      "allegiances": [
        "https://www.anapioficeandfire.com/api/houses/362"
      ],
      "book_count": 1,
      "book_ids": [
        5
      ],
      "books": [
        "https://www.anapioficeandfire.com/api/books/5"
      ],
      "born": "In 283 AC",
      "culture": "Northmen",
      "died": "",
      "display_name": "Jon Snow",
      "father": "",
      "father_id": null,
      "gender": "Male",
      "id": 583,
      "is_alive": true,
      "is_pov_character": true,
      "mother": "",
      "mother_id": null,
      "name": "Jon Snow",
      "playedBy": [
        "Kit Harington"
      ],
      "played_by_names": [
        "Kit Harington"
      ],
      "povBooks": [
        "https://www.anapioficeandfire.com/api/books/1",
        "https://www.anapioficeandfire.com/api/books/2"
      ],
      "pov_book_ids": [
        1,
        2
      ],
      "spouse": "",
      "spouse_id": null,
      "title_names": [
        "Lord Commander of the Night's Watch"
      ],
      "titles": [
        "Lord Commander of the Night's Watch"
      ],
      "tvSeries": [
        "Season 1",
        "Season 2",
        "Season 3",
        "Season 4",
        "Season 5"
      ],
      "tv_series_names": [
        "Season 1",
        "Season 2",
        "Season 3",
        "Season 4",
        "Season 5"
      ],
      "url": "https://www.anapioficeandfire.com/api/characters/583"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_page": null,
  "page": 1,
  "page_size": 10,
  "previous_page": null,
  "total_pages": 1
}

Search houses

Search the houses of Westeros and beyond by name, region or words, and by whether they have words, titles, seats or ancestral weapons at all - or whether they have died out. Each house comes back with its coat of arms, seats, titles, ancestral weapons, cadet branches, and the ids of its lord, heir, overlord and sworn members.

Inputs

Namenametext: Optional. Filter by the house's name, e.g. 'House Stark of Winterfell'. The API matches the whole value rather than part of one, so it has to be spelled the way the API spells it.
Regionregiontext: Optional. Filter by the region the house sits in.One of: The North, The Vale, The Riverlands, The Iron Islands, The Westerlands, The Crownlands, The Stormlands, The Reach, Dorne, Beyond the Wall.
Wordswordstext: Optional. Filter by the house's words, e.g. 'Winter is Coming'. The API matches the whole value rather than part of one, so it has to be spelled the way the API spells it.
Has wordshas_wordstrue/false: Optional. Yes for houses that have words, No for those that do not. Leave it unset for both.
Has titleshas_titlestrue/false: Optional. Yes for houses that hold titles, No for those that hold none. Leave it unset for both.
Has seatshas_seatstrue/false: Optional. Yes for houses that hold a seat, No for those that hold none. Leave it unset for both.
Died outhas_died_outtrue/false: Optional. Yes for extinct houses, No for the ones still standing. Leave it unset for both.
Has ancestral weaponshas_ancestral_weaponstrue/false: Optional. Yes for houses with a named ancestral weapon, No for those without. Leave it unset for both.
Pagepagenumber: Optional. Which page of results to return; the first page by default. Each result carries the next page number when there is one, so a workflow can walk the whole set.From 1 to 100000. Default: 1.
Results per pagepage_sizenumber: Optional. How many records to return per page, 1 to 50 (default 10). The API serves no more than that in one page.From 1 to 50. Default: 10.

Outputs

countnumber: How many records came back on this page.
has_moretrue/false: True when the API offered a next page.
houseslist: The matching houses, in the API's own order.
next_pagenumber: The page number to ask for next, or null on the last page.
pagenumber: Which page this is.
page_sizenumber: How many records a full page holds.
previous_pagenumber: The page number before this one, or null on the first page.
total_pagesnumber: How many pages the search has in total, from the API's own paging links. Zero when nothing matched, and null when there is more to come but the API did not say how much. The API publishes no total record count anywhere, so there is none to report.

Example output

{
  "count": 1,
  "has_more": false,
  "houses": [
    {
      "ancestralWeapons": [
        "Ice"
      ],
      "ancestral_weapon_names": [
        "Ice"
      ],
      "cadetBranches": [
        "https://www.anapioficeandfire.com/api/houses/17",
        "https://www.anapioficeandfire.com/api/houses/303"
      ],
      "cadet_branch_count": 2,
      "cadet_branch_ids": [
        17,
        303
      ],
      "coatOfArms": "A grey direwolf on a white field. (Argent, a direwolf courant cendree)",
      "currentLord": "",
      "current_lord_id": null,
      "diedOut": "",
      "founded": "Age of Heroes",
      "founder": "",
      "founder_id": null,
      "has_died_out": false,
      "heir": "",
      "heir_id": null,
      "id": 362,
      "name": "House Stark of Winterfell",
      "overlord": "",
      "overlord_id": null,
      "region": "The North",
      "seat_names": [
        "Winterfell"
      ],
      "seats": [
        "Winterfell"
      ],
      "swornMembers": [
        "https://www.anapioficeandfire.com/api/characters/583",
        "https://www.anapioficeandfire.com/api/characters/1052"
      ],
      "sworn_member_count": 2,
      "sworn_member_ids": [
        583,
        1052
      ],
      "title_names": [
        "King in the North",
        "Lord of Winterfell",
        "Warden of the North"
      ],
      "titles": [
        "King in the North",
        "Lord of Winterfell",
        "Warden of the North"
      ],
      "url": "https://www.anapioficeandfire.com/api/houses/362",
      "words": "Winter is Coming"
    }
  ],
  "next_page": null,
  "page": 1,
  "page_size": 10,
  "previous_page": null,
  "total_pages": 1
}

An API of Ice and Fire

ActionsCopy Anchor Link

Get a bookCopy Anchor Link

Inputs

Outputs

Get a book's POV charactersCopy Anchor Link

Inputs

Outputs

Get a characterCopy Anchor Link

Inputs

Outputs

Get a character's relationsCopy Anchor Link

Inputs

Outputs

Get a houseCopy Anchor Link

Inputs

Outputs

Get a house's membersCopy Anchor Link

Inputs

Outputs

Search booksCopy Anchor Link

Inputs

Outputs

Search charactersCopy Anchor Link

Inputs

Outputs

Search housesCopy Anchor Link

Inputs

Outputs

On this page

Actions

Get a book

Get a book's POV characters

Get a character

Get a character's relations

Get a house

Get a house's members

Search books

Search characters

Search houses