An API of Ice And Fire website screenshot

An API of Ice And Fire

An API of Ice And Fire is the world's greatest source for quantified and structured data from the universe of A Song of Ice and Fire (and the HBO series Game of Thrones). The open, read-only REST API exposes Books, Characters, and Houses as hypermedia resources with HAL-style URL references, RFC 5988 Link-header pagination, conditional caching, and version selection via custom media types. It is free, unauthenticated, and rate-limited at 20,000 requests per IP per day.

An API of Ice And Fire publishes 4 APIs on the APIs.io network, including Books API, Characters API, Houses API, and 1 more. Tagged areas include Video, Public APIs, Open Source, Game of Thrones, and A Song of Ice and Fire.

The An API of Ice And Fire catalog on APIs.io includes 1 Spectral governance ruleset.

An API of Ice And Fire’s developer surface includes documentation and 12 more developer resources.

26.3/100 emerging ▼ -5.7 Agent 25/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
4 APIs
VideoPublic APIsOpen SourceGame of ThronesA Song of Ice and FireFan APIHypermediaHALRESTOpen DataEntertainment

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 26.3/100 · emerging
Contract Quality 11.0 / 25
Developer Ergonomics 1.7 / 20
Commercial Clarity 0.0 / 20
Operational Transparency 0.7 / 13
Governance 5.7 / 12
Discoverability 8.2 / 10
Agent readiness — 25/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 0 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 0 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/an-api-of-ice-and-fire: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 4

Individual APIs this provider publishes, each with its own machine-readable definition.

An API of Ice And Fire Books API

Books in the A Song of Ice and Fire series.

An API of Ice And Fire Characters API

Characters from the A Song of Ice and Fire universe.

An API of Ice And Fire Houses API

Noble houses of Westeros and Essos.

An API of Ice And Fire Root API

API entry-point listing the top-level resource URLs.

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

An API of Ice And Fire

OPEN COLLECTION

GraphQL 1

GraphQL schemas published by this provider.

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

An API of Ice And Fire API Rules

53 rules · 16 errors 26 warnings 11 info

SPECTRAL

Security Posture 1

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

An Api Of Ice And Fire Agentic Access

7 operations

7 operations · 0 acting

AGENTIC

Resources

Documentation 3

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

Build 3

SDKs, sample code, and the tooling you integrate with

Access & Security 1

Authentication, authorization, and security posture

Commercial 1

Pricing, plans, and the legal terms of use

Company 1

The organization behind the API

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: an-api-of-ice-and-fire
accessModel:
  pricing: unknown
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Unknown
  confidence: low
  source: []
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/an-api-of-ice-and-fire.png
name: An API of Ice And Fire
description: An API of Ice And Fire is the world's greatest source for quantified and structured data from the universe of
  A Song of Ice and Fire (and the HBO series Game of Thrones). The open, read-only REST API exposes Books, Characters, and
  Houses as hypermedia resources with HAL-style URL references, RFC 5988 Link-header pagination, conditional caching, and
  version selection via custom media types. It is free, unauthenticated, and rate-limited at 20,000 requests per IP per day.
url: https://anapioficeandfire.com/
specificationVersion: '0.20'
created: '2026-05-28'
modified: '2026-05-30'
x-source: public-apis/public-apis
x-category: Video
x-type: opensource
x-tier: 3
x-tier-reason: bulk-registered-from-public-apis
tags:
- Video
- Public APIs
- Open Source
- Game of Thrones
- A Song of Ice and Fire
- Fan API
- Hypermedia
- HAL
- REST
- Open Data
- Entertainment
apis:
- aid: an-api-of-ice-and-fire:an-api-of-ice-and-fire-books-api
  name: An API of Ice And Fire Books API
  description: Books in the A Song of Ice and Fire series.
  humanURL: https://anapioficeandfire.com/
  baseURL: https://anapioficeandfire.com/api
  tags:
  - Books
  properties:
  - type: OpenAPI
    url: openapi/an-api-of-ice-and-fire-books-api-openapi.yml
  - type: Documentation
    url: https://anapioficeandfire.com/Documentation
  - type: Documentation
    url: https://github.com/joakimskoog/AnApiOfIceAndFire/wiki
  - type: SourceCode
    url: https://github.com/joakimskoog/AnApiOfIceAndFire
  - type: SignupURL
    url: https://anapioficeandfire.com/
  - type: SDKs
    url: https://github.com/joakimskoog/anapioficeandfire-python
  - type: SDKs
    url: https://github.com/sotojuan/maester
  - type: SDKs
    url: https://github.com/afram/iceandfire-graphql
  - type: SDKs
    url: https://github.com/kberger/anapioficeandfire-haskell
  - type: SDKs
    url: https://github.com/arbazsiddiqui/A-song-of-ice-and-fire-API
  - type: SDKs
    url: https://github.com/alexwebb2/node-api-iceandfire
  - type: SDKs
    url: https://github.com/MangoTheCat/GoTr
  - type: SDKs
    url: https://github.com/jzntam/game_of_thrones_api
  - type: SDKs
    url: https://github.com/Yag000/asoiaf-rs
  - type: SDKs
    url: https://github.com/murphb52/IceAndFireKit
  - type: SDKs
    url: https://github.com/ujell/IceAndFireLoader
  - type: SDKs
    url: https://github.com/fitomad/WesterosKit
  - type: SDKs
    url: https://github.com/anujpradhaan/anapioficeandfire-go
  - type: SDKs
    url: https://github.com/zytron3/AnAPIofIceAndFireCpp
  - type: SDKs
    url: https://github.com/voxgig-sdk/anapioficeandfire-sdk
  - type: Tools
    url: https://github.com/pipeworx-io/mcp-anapioficeandfire
  - type: Tools
    url: https://github.com/stephdietzel/ConnectorOfIceAndFire
  - type: GraphQL
    url: graphql/an-api-of-ice-and-fire-graphql.md
- aid: an-api-of-ice-and-fire:an-api-of-ice-and-fire-characters-api
  name: An API of Ice And Fire Characters API
  description: Characters from the A Song of Ice and Fire universe.
  humanURL: https://anapioficeandfire.com/
  baseURL: https://anapioficeandfire.com/api
  tags:
  - Characters
  properties:
  - type: OpenAPI
    url: openapi/an-api-of-ice-and-fire-characters-api-openapi.yml
  - type: Documentation
    url: https://anapioficeandfire.com/Documentation
  - type: Documentation
    url: https://github.com/joakimskoog/AnApiOfIceAndFire/wiki
  - type: SourceCode
    url: https://github.com/joakimskoog/AnApiOfIceAndFire
  - type: SignupURL
    url: https://anapioficeandfire.com/
  - type: SDKs
    url: https://github.com/joakimskoog/anapioficeandfire-python
  - type: SDKs
    url: https://github.com/sotojuan/maester
  - type: SDKs
    url: https://github.com/afram/iceandfire-graphql
  - type: SDKs
    url: https://github.com/kberger/anapioficeandfire-haskell
  - type: SDKs
    url: https://github.com/arbazsiddiqui/A-song-of-ice-and-fire-API
  - type: SDKs
    url: https://github.com/alexwebb2/node-api-iceandfire
  - type: SDKs
    url: https://github.com/MangoTheCat/GoTr
  - type: SDKs
    url: https://github.com/jzntam/game_of_thrones_api
  - type: SDKs
    url: https://github.com/Yag000/asoiaf-rs
  - type: SDKs
    url: https://github.com/murphb52/IceAndFireKit
  - type: SDKs
    url: https://github.com/ujell/IceAndFireLoader
  - type: SDKs
    url: https://github.com/fitomad/WesterosKit
  - type: SDKs
    url: https://github.com/anujpradhaan/anapioficeandfire-go
  - type: SDKs
    url: https://github.com/zytron3/AnAPIofIceAndFireCpp
  - type: SDKs
    url: https://github.com/voxgig-sdk/anapioficeandfire-sdk
  - type: Tools
    url: https://github.com/pipeworx-io/mcp-anapioficeandfire
  - type: Tools
    url: https://github.com/stephdietzel/ConnectorOfIceAndFire
  - type: GraphQL
    url: graphql/an-api-of-ice-and-fire-graphql.md
- aid: an-api-of-ice-and-fire:an-api-of-ice-and-fire-houses-api
  name: An API of Ice And Fire Houses API
  description: Noble houses of Westeros and Essos.
  humanURL: https://anapioficeandfire.com/
  baseURL: https://anapioficeandfire.com/api
  tags:
  - Houses
  properties:
  - type: OpenAPI
    url: openapi/an-api-of-ice-and-fire-houses-api-openapi.yml
  - type: Documentation
    url: https://anapioficeandfire.com/Documentation
  - type: Documentation
    url: https://github.com/joakimskoog/AnApiOfIceAndFire/wiki
  - type: SourceCode
    url: https://github.com/joakimskoog/AnApiOfIceAndFire
  - type: SignupURL
    url: https://anapioficeandfire.com/
  - type: SDKs
    url: https://github.com/joakimskoog/anapioficeandfire-python
  - type: SDKs
    url: https://github.com/sotojuan/maester
  - type: SDKs
    url: https://github.com/afram/iceandfire-graphql
  - type: SDKs
    url: https://github.com/kberger/anapioficeandfire-haskell
  - type: SDKs
    url: https://github.com/arbazsiddiqui/A-song-of-ice-and-fire-API
  - type: SDKs
    url: https://github.com/alexwebb2/node-api-iceandfire
  - type: SDKs
    url: https://github.com/MangoTheCat/GoTr
  - type: SDKs
    url: https://github.com/jzntam/game_of_thrones_api
  - type: SDKs
    url: https://github.com/Yag000/asoiaf-rs
  - type: SDKs
    url: https://github.com/murphb52/IceAndFireKit
  - type: SDKs
    url: https://github.com/ujell/IceAndFireLoader
  - type: SDKs
    url: https://github.com/fitomad/WesterosKit
  - type: SDKs
    url: https://github.com/anujpradhaan/anapioficeandfire-go
  - type: SDKs
    url: https://github.com/zytron3/AnAPIofIceAndFireCpp
  - type: SDKs
    url: https://github.com/voxgig-sdk/anapioficeandfire-sdk
  - type: Tools
    url: https://github.com/pipeworx-io/mcp-anapioficeandfire
  - type: Tools
    url: https://github.com/stephdietzel/ConnectorOfIceAndFire
  - type: GraphQL
    url: graphql/an-api-of-ice-and-fire-graphql.md
- aid: an-api-of-ice-and-fire:an-api-of-ice-and-fire-root-api
  name: An API of Ice And Fire Root API
  description: API entry-point listing the top-level resource URLs.
  humanURL: https://anapioficeandfire.com/
  baseURL: https://anapioficeandfire.com/api
  tags:
  - Root
  properties:
  - type: OpenAPI
    url: openapi/an-api-of-ice-and-fire-root-api-openapi.yml
  - type: Documentation
    url: https://anapioficeandfire.com/Documentation
  - type: Documentation
    url: https://github.com/joakimskoog/AnApiOfIceAndFire/wiki
  - type: SourceCode
    url: https://github.com/joakimskoog/AnApiOfIceAndFire
  - type: SignupURL
    url: https://anapioficeandfire.com/
  - type: SDKs
    url: https://github.com/joakimskoog/anapioficeandfire-python
  - type: SDKs
    url: https://github.com/sotojuan/maester
  - type: SDKs
    url: https://github.com/afram/iceandfire-graphql
  - type: SDKs
    url: https://github.com/kberger/anapioficeandfire-haskell
  - type: SDKs
    url: https://github.com/arbazsiddiqui/A-song-of-ice-and-fire-API
  - type: SDKs
    url: https://github.com/alexwebb2/node-api-iceandfire
  - type: SDKs
    url: https://github.com/MangoTheCat/GoTr
  - type: SDKs
    url: https://github.com/jzntam/game_of_thrones_api
  - type: SDKs
    url: https://github.com/Yag000/asoiaf-rs
  - type: SDKs
    url: https://github.com/murphb52/IceAndFireKit
  - type: SDKs
    url: https://github.com/ujell/IceAndFireLoader
  - type: SDKs
    url: https://github.com/fitomad/WesterosKit
  - type: SDKs
    url: https://github.com/anujpradhaan/anapioficeandfire-go
  - type: SDKs
    url: https://github.com/zytron3/AnAPIofIceAndFireCpp
  - type: SDKs
    url: https://github.com/voxgig-sdk/anapioficeandfire-sdk
  - type: Tools
    url: https://github.com/pipeworx-io/mcp-anapioficeandfire
  - type: Tools
    url: https://github.com/stephdietzel/ConnectorOfIceAndFire
  - type: GraphQL
    url: graphql/an-api-of-ice-and-fire-graphql.md
common:
- type: AgenticAccess
  url: agentic-access/an-api-of-ice-and-fire-agentic-access.yml
- type: DomainSecurity
  url: security/an-api-of-ice-and-fire-domain-security.yml
- type: Website
  url: https://anapioficeandfire.com/
- type: Documentation
  url: https://anapioficeandfire.com/Documentation
- type: Documentation
  title: Project Wiki
  url: https://github.com/joakimskoog/AnApiOfIceAndFire/wiki
- type: SourceCode
  url: https://github.com/joakimskoog/AnApiOfIceAndFire
- type: License
  title: BSD 3-Clause-like (see LICENSE.md)
  url: https://github.com/joakimskoog/AnApiOfIceAndFire/blob/master/LICENSE.md
- type: ContributingGuide
  url: https://github.com/joakimskoog/AnApiOfIceAndFire/blob/master/CONTRIBUTING.md
- type: GitHubRepository
  url: https://github.com/joakimskoog/AnApiOfIceAndFire
- type: GitHubOrganization
  title: Maintainer
  url: https://github.com/joakimskoog
- type: PublicAPIsListing
  url: https://github.com/public-apis/public-apis
- type: SpectralRules
  url: rules/an-api-of-ice-and-fire-spectral-rules.yml
- type: Vocabulary
  url: vocabulary/an-api-of-ice-and-fire-vocabulary.yml
features:
- name: Hypermedia Resources
  description: Every resource is returned with absolute `url` self-links and outbound URL references to related resources
    (e.g. characters point to allegiance houses, books, and POV books).
- name: RFC 5988 Link-Header Pagination
  description: Collection endpoints paginate via Link headers with `first`, `next`, `prev`, and `last` rels — no in-body pagination
    envelope, just ready-to-follow URLs.
- name: Conditional Caching
  description: Responses include ETag and Last-Modified headers. Clients can issue conditional GETs with `If-None-Match` /
    `If-Modified-Since` and receive 304 Not Modified to save bandwidth.
- name: Media-Type Versioning
  description: Versions are selected via the Accept header, e.g. `application/vnd.anapioficeandfire+json; version=1` — resources
    can evolve independently without breaking older clients.
- name: Rich Filtering
  description: Characters can be filtered by name, gender, culture, born, died, and isAlive; Houses by region, words, hasWords,
    hasTitles, hasSeats, hasDiedOut, hasAncestralWeapons; Books by name, fromReleaseDate, toReleaseDate.
- name: No Authentication
  description: Fully open read-only API — no API key, no OAuth, no signup. GET only.
- name: Generous Rate Limit
  description: 20,000 requests per IP per 24 hours, more than enough for most hobbyist and demo workloads. 403 Forbidden after
    exhaustion until the window resets.
useCases:
- name: Learning REST and Hypermedia
  description: Used in countless tutorials, bootcamps, and university courses to teach REST clients, HAL-style hypermedia
    traversal, Link-header pagination, and conditional caching against a real, free, fun dataset.
- name: Fan Apps and Visualizations
  description: Powers fan-built web and mobile apps that browse the ASOIAF universe — character profiles, house family trees,
    book timelines, and POV explorers.
- name: API Client Library Examples
  description: The community has produced helper libraries in Python, Elixir, Haskell, Node.js, R, Ruby, Rust, Swift, and
    a GraphQL wrapper, making the API a popular target for "write your own SDK" exercises.
- name: Game of Thrones Bots and Chat Integrations
  description: Reddit and Discord bots use the API to answer canon questions about characters, houses, and books in real time.
- name: Data Journalism and Analysis
  description: Notebooks and data-science demos slice the dataset to study character mortality, house power dynamics, and
    POV distribution across the novels.
integrations:
- name: A Song of Ice and Fire Wiki (canon source)
  description: The data behind the API is curated against the A Wiki of Ice and Fire canon source, kept in sync as new material
    is published.
- name: Public APIs Catalog
  description: Listed in the `public-apis/public-apis` directory under the Video category as a free, no-auth fan API.
solutions:
- name: Self-Hosting
  description: The full source (ASP.NET / C#) is available under a BSD-style license, so teams can fork and self-host their
    own ASOIAF data API.
- name: Mirror / Backup
  description: Because the API is read-only and the dataset is bounded (~12 books, ~2,100 characters, ~450 houses), a complete
    mirror fits in a small JSON archive — ideal for offline use and CI test fixtures.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com