Harry Potter API

How to Use This API

1. All Characters

https://hp-api.onrender.com/api/characters

Returns all characters with full details (over 400 entries including minor characters).

2. Characters by House

https://hp-api.onrender.com/api/characters/house/gryffindor

Filter by Hogwarts house: gryffindor, slytherin, ravenclaw, hufflepuff.

3. Characters with Patronus

https://hp-api.onrender.com/api/characters?patronus=stag

Query parameters available: patronus, bloodStatus, ancestry, house.

4. All Spells

https://hp-api.onrender.com/api/spells

Returns every known spell with incantation, name, description, and type (Charm, Hex, Jinx, Curse, Transfiguration).

5. JavaScript — House Explorer

async function getHouseCharacters(house) {
  const resp = await fetch(
    `https://hp-api.onrender.com/api/characters/house/${house}`
  );
  const characters = await resp.json();
  
  const wandTypes = {};
  characters.forEach(c => {
    if (c.wand?.wood) {
      wandTypes[c.wand.wood] = (wandTypes[c.wand.wood] || 0) + 1;
    }
  });
  
  console.log(`${house} — ${characters.length} characters`);
  console.log('Most common wand woods:');
  Object.entries(wandTypes)
    .sort((a, b) => b[1] - a[1])
    .slice(0, 5)
    .forEach(([wood, count]) => {
      console.log(`  ${wood}: ${count}`);
    });
}

getHouseCharacters('gryffindor');

6. Python — Spell Finder

import requests

def find_spells_by_type(spell_type='Charm'):
    resp = requests.get('https://hp-api.onrender.com/api/spells')
    spells = resp.json()
    
    filtered = [s for s in spells if s.get('type') == spell_type]
    print(f"{spell_type}s ({len(filtered)} total):")
    for s in filtered[:10]:
        print(f"  {s['name']} — \"{s['incantation']}\"")
        print(f"    {s.get('description', '')}")

find_spells_by_type('Curse')