Harry Potter

About Harry Potter

PotterAPI is a REST API built with Express.js that provides information and images related to the Harry Potter book series, covering books, characters, houses, and spells. Data is available in multiple languages, including English, Spanish, French, Italian, Portuguese, and Ukrainian, accessed by prefixing endpoints with the corresponding two-letter language code.

Each endpoint returns structured data: book endpoints include title, original title, release date, description, page count, and cover image; character endpoints include full name, nickname, Hogwarts house, actor, children, image, and birthdate; house endpoints include name, emoji, founder, colors, and animal; spell endpoints include name and description. Endpoints support query parameters for retrieving a single item by index, limiting and paginating results, and searching, and each also has a /random variant that returns one random item.

The API is deployed as serverless functions and can be run locally for development, with source code, tests, and TypeScript types included in the repository. It is intended for developers building applications that need structured Harry Potter reference data.

Key features

• REST API for Harry Potter books, characters, houses, and spells data
• Available in six languages: English, Spanish, French, Italian, Portuguese, Ukrainian
• Random item endpoint for each resource (e.g. /en/spells/random)
• Query params for search, pagination, and index-based filtering
• Interactive Swagger UI documentation
• Built with Express.js, free and open source under MIT license

Frequently asked questions