ThronesAPI

ThronesAPI is a free, key-free API returning Game of Thrones television characters with their house, title and a hosted portrait image — a plain array, no pagination. Live example included.

No API key requiredCORS enabledHTTPSFree tier

Endpoint tested and returned HTTP 200 on 21 Aug 2026

What is the ThronesAPI?

ThronesAPI is a free, key-free REST API returning Game of Thrones characters as a flat JSON array. Each record carries first and last name, full name, in-world title, house and a hosted portrait image URL, with a separate continents endpoint alongside it.

This is the show-based counterpart to the book-based Ice and Fire API, and the difference is worth naming because they suit different projects. Ice and Fire models the novels in depth — houses, allegiances, sworn members, cross-linked by URL. ThronesAPI models the television series shallowly but visually: a short list of principal characters, each with a portrait that the project actually hosts rather than hotlinks. If you are building anything with faces in it, that hosting decision is the deciding factor.

It is deliberately simple. `GET /api/v2/Characters` returns the whole array with no envelope, no pagination and no filters — you fetch once and work in memory. Note the capitalised path segment, which trips people up, and note that `image` holds a bare filename while `imageUrl` holds the full address; use the latter. It is a small dataset covering the main cast rather than every named character, so check that the people your project needs are actually in it before building around it.

Quick facts

Base URL: https://thronesapi.com/api/v2
Authentication: No key or account.
Rate limit: No published limit. One request returns everything — there is no reason to call it twice.
Pricing: Free.
CORS: Enabled — callable directly from browser JavaScript
Official docs: Read the docs

How to use the ThronesAPI

Every request below was executed against the live API on 21 Aug 2026, and the response shown is the real body it returned — not an illustration.

1. Fetch every character

GET https://thronesapi.com/api/v2/Characters

curl

curl 'https://thronesapi.com/api/v2/Characters'

JavaScript (fetch)

const res = await fetch("https://thronesapi.com/api/v2/Characters");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

Python (requests)

import requests

res = requests.get("https://thronesapi.com/api/v2/Characters", timeout=20)
res.raise_for_status()
print(res.json())

Response — HTTP 200 (truncated)

[
  {
    "id": 0,
    "firstName": "Daenerys",
    "lastName": "Targaryen",
    "fullName": "Daenerys Targaryen",
    "title": "Mother of Dragons",
    "family": "House Targaryen",
    "image": "daenerys.jpg",
    "imageUrl": "https://thronesapi.com/assets/images/daenerys.jpg"
  },
  {
    "id": 1,
    "firstName": "Samwell",
    "lastName": "Tarly",
    "fullName": "Samwell Tarly",
    "title": "Maester",
    "family": "House Tarly",
    "image": "sam.jpg",
    "imageUrl": "https://thronesapi.com/assets/images/sam.jpg"
  },
  {
    "id": 2,
    "firstName": "Jon",
    "lastName": "Snow",
    "fullName": "Jon Snow",
    "title": "King of the North",
    "family": "House Stark",
    "image": "jon-snow.jpg",
    "imageUrl": "https://thronesapi.com/assets/images/jon-snow.jpg"
  },
  {
    "id": 3,
    "firstName": "Arya",
    "lastName": "Stark",
    "fullName": "Arya Stark",
    "title": "No One",
    "family": "House Stark",
    "image": "arya-stark.jpg",
    "imageUrl": "https://thronesapi.com/assets/images/arya-stark.jpg"
  },
  {
    "id": 4,
    "firstName": "Sansa",
    "lastName": "Stark",
    "fullName": "Sansa Stark",
    "title": "Lady of Winterfell",
    "family": "House Stark",
    "image": "sansa-stark.jpeg",
    "imageUrl": "https://thronesapi.com/assets/images/sansa-stark.jpeg"
  },
  {
    "id": 5,
    "firstName": "Brandon",
    "lastName": "Stark",
    "fullName": "Brandon Stark",
    "title": "Lord of Winterfell",
    "family": "House Stark",
    "image": "bran-stark.jpg",
    "imageUrl": "https://thronesapi.com/assets/images/bran-stark.jpg"
  },
  {
    "

Parameters

Parameter	Type	Required	Description
`id`	path segment	Optional	`/Characters/{id}` returns one character. Ids start at 0. `0`
`Continents`	path segment	Optional	`/Continents` returns the list of continents as a separate small collection. `Continents`

Response fields

idinteger: Character id, zero-based.
firstName / lastNamestring: Name components, split. Empty string where a character has no surname.
fullNamestring: The combined name — use this for display rather than concatenating the parts.
titlestring: In-world title, e.g. "Mother of Dragons" or "Maester".
familystring: House affiliation, e.g. "House Targaryen".
imagestring: Bare image filename. Not usable on its own.
imageUrlstring: The full, loadable portrait URL, hosted by the project itself rather than hotlinked.

What you can build with the ThronesAPI

Build a character gallery with reliable hosted portraits
Add house badges and titles to a fan wiki
Seed a guessing game or quiz with faces and names
Prototype a card layout with real images of a consistent aspect ratio

Common errors and how to fix them

404 on /api/v2/characters

The path segment is capitalised.

Fix: It is `/api/v2/Characters` with a capital C. The same applies to `/Continents`.

Broken images

You used `image` instead of `imageUrl`.

Fix: `image` is a bare filename such as `daenerys.jpg`. `imageUrl` is the complete address.

A character is missing

The dataset covers principal cast, not every named character.

Fix: Check coverage against your requirements up front. For depth across the books, the Ice and Fire API is the better source.

No pagination parameters work

There is no pagination.

Fix: The collection endpoint returns everything in one array. Filter and page in your own code.

ThronesAPI — frequently asked questions

Is there a free Game of Thrones API with character images?

Yes. ThronesAPI returns the main television characters with house, title and a portrait image that the project hosts itself, with no key or account.

How is it different from the Ice and Fire API?

ThronesAPI covers the television series and its strength is hosted character images. An API of Ice And Fire covers the novels in far greater depth — houses, sworn members, allegiances, cross-linked between records — but carries no images at all.

Why do my image URLs 404?

You are probably using the `image` field, which is only a filename. The complete address is in `imageUrl`.

Does it support pagination or filtering?

No. One call returns the entire array with no envelope and no query parameters, which is fine given the size — fetch it once, cache it, and filter in your own code.

Tools that pair with this API

JSON Formatter

Format, beautify and minify JSON online with 2-space, 4-space or tab indentation. Sort keys alphabetically and catch syntax errors instantly — free and private.

JSON to CSV Converter

Convert a JSON array of objects to CSV online. Automatic column headers from the union of all keys, delimiter choice and proper quoting — all in-browser.

Image to Base64 Converter

Convert an image to a Base64 data URL online. Get copy-ready HTML img tags and CSS background-image snippets. Free, instant and fully private.

Alternatives to ThronesAPI

If ThronesAPI does not fit, these video & streaming apis cover similar ground. Every one was called before publishing, and each links to its own reference page with a working curl command and the response it returned.

API	What it does	Auth	CORS	Last verified
TVmaze	Free TV show API with no key: series info, full episode guides, cast, air dates and daily schedules with images. Genuinely open, no signup. Tested example.	No key	Yes	19 Aug 2026
Noembed	Free oEmbed proxy API with no key: get embed HTML, thumbnails and metadata for YouTube, Vimeo, Twitter and 200+ other sites from one endpoint. Tested.	No key	Yes	19 Aug 2026
IPTV-org	Free IPTV-org API with no key: 10,000+ TV channels worldwide with countries, languages, categories, logos and stream metadata as static JSON. Tested example.	No key	Yes	19 Aug 2026
YouTube oEmbed	Free YouTube oEmbed endpoint with no API key: video title, author, thumbnail and embed HTML from any video URL. No quota, unlike the Data API. Tested.	No key	No	20 Aug 2026
AniList	Free AniList GraphQL API with no key for public data: anime, manga, characters, staff and studios with precise field selection in one query. Tested POST.	No key	Yes	20 Aug 2026
Anime News Network Encyclopedia	Anime News Network's encyclopedia API returns full anime and manga records as XML with no key: staff, cast, genres, themes, ratings and release history. Live example included.	No key	Yes	21 Aug 2026

All Video & Streaming APIs

ThronesAPI is an independent third-party service and is not affiliated with ByteTools or ByteVancer. Details on this page were verified on 21 Aug 2026; always check the official documentation before relying on this API in production, as terms and limits can change.