Free REST API · Open Source

HUNTER × HUNTER

DATABASE API

Your all-access Hunter license to the HxH universe. Access character profiles, group affiliations, and deep lore — structured JSON, instantly.

0+Characters
0+Groups
6Nen Types
FreeNo Cost
Free Forever · Open Source

No Paywalls.
No Sign-up Fees.
No Catch.

The HxH API is completely free to use and open source under the MIT license. Generate your API key in seconds, explore the full HxH universe in JSON, and contribute back to the codebase if you want to make it even better.

  • ✓No credit card required
  • ✓No usage fees — ever
  • ✓API key in under a minute
  • ✓Source code publicly available on GitHub
  • ✓Contributions welcome
Get Started

UP AND RUNNING IN 3 STEPS

No billing info. No waiting. Just your email address and you're ready to hunt.

1

Register

Enter your email address to create a Guest account. No password, no payment — just an email.

2

Verify & Receive Key

Check your inbox for a verification link. Once confirmed, your unique API key is generated automatically.

3

Start Querying

Pass your key in the x-api-key header and hit any endpoint. Filter, sort, paginate — the full API is yours.

The Cast

CHARACTERS

View All →
Aura System

NEN TYPES

Every Hunter channels their aura differently. Click a type to see its users — or query them yourself with ?nen_type=enhancement.

Adding API Key To Your Request

With the convenience of our hassle-free API key generation, accessing the API becomes a seamless and effortless experience.

Discover a Random Hunter

Hit the button — the API will surface a Hunter from the database at random.

Factions

GROUPS

What You Get

BUILT FOR DEVELOPERS

Everything you'd expect from a production REST API — filter, sort, paginate, and explore — all without writing a single line of backend code.

⚡

Filter Any Field

Query characters by name, Nen type, state, gender, or any field in the schema using flexible operator syntax.

?nen_type=transmutation&state=alive
↕

Sort Results

Order data by any field, ascending or descending, using a simple comma-separated sort param.

?sort=-createdAt,name
📄

Pagination

Every list endpoint is paginated. Response includes total count and page info so you can build infinite scroll or classic paging.

?page=2&limit=10
🎲

Random Endpoint

Hit /characters/random or /groups/random to surface a random entry — great for discovery features and easter eggs.

GET /characters/random
🔎

Field Projection

Only fetch the fields you need. Reduce payload size by specifying a comma-separated list of fields.

?fields=name,nen_type,image
🔗

Relational Data

Characters include their groups, relatives, and images as populated references — not just raw IDs.

groups, relatives, image

Simple to Integrate

One request is all it takes. Pass your API key in the header and get back a structured JSON response — no SDKs required.

Full Documentation
request.js
const response = await fetch(
  'https://hxh-api.onrender.com/api/v1/characters?limit=5',
  {
    headers: {
      'x-api-key': 'your_api_key_here'
    }
  }
);

const data = await response.json();
200 OK response.json
"status": "success",
"data": [
  {
    "name": "gon freecss",
    "gender": "male",
    "nen_type": ["enhancement"],
    "state": "alive",
    "professions": ["hunter"],
    "abilities": ["Jajanken", "Ko", "Ken"]
  },
  { "name": "killua zoldyck", ... }
],
"_paginate": {
  "page": 1,
  "limit": 5,
  "total": 248,
  "pages": 50
}