Resource

Enemy Families

Top-level enemy families such as Hilichurls, The Abyss or Automatons. Each family lists its groups and all its enemies.

8items
1filters
2sort fields

Endpoints

GET/api/v1/enemy-familiesPaginated list
GET/api/v1/enemy-families/randomRandom item
GET/api/v1/enemy-families/{id or name}Single item

List

Returns a paginated list of enemy families in summary form.

Query parameters

ParameterDescription
limitItems per page (1-100, default 20)
offsetItems to skip (default 0)
sortOne of id, name. Prefix with - for descending.
namePartial match on the name
GET /api/v1/enemy-families?limit=2
{
  "count": 8,
  "next": "https://genshin-api.replace_me.workers.dev/api/v1/enemy-families?limit=2&offset=2",
  "previous": null,
  "results": [
    {
      "id": 1,
      "slug": "elemental-lifeforms",
      "name": "Elemental Lifeforms",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/enemy-families/elemental-lifeforms",
      "icon": null
    },
    {
      "id": 2,
      "slug": "hilichurls",
      "name": "Hilichurls",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/enemy-families/hilichurls",
      "icon": null
    }
  ]
}

Single item

Returns the full details of one item, by numeric id or by name. Arrays in the example below are shortened.

Fields

FieldType
idnumber
slugstring
namestring
urlstring
imagesobject
groupsReference[]
enemiesReference[]
GET /api/v1/enemy-families/hilichurls
{
  "id": 2,
  "slug": "hilichurls",
  "name": "Hilichurls",
  "url": "https://genshin-api.replace_me.workers.dev/api/v1/enemy-families/hilichurls",
  "images": {},
  "groups": [
    {
      "id": 2,
      "slug": "samachurls",
      "name": "Samachurls",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/enemy-groups/samachurls"
    },
    {
      "id": 3,
      "slug": "hilichurl-shooters",
      "name": "Hilichurl Shooters",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/enemy-groups/hilichurl-shooters"
    }
  ],
  "enemies": [
    {
      "id": 16,
      "slug": "anemo-samachurl",
      "name": "Anemo Samachurl",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/enemies/anemo-samachurl"
    },
    {
      "id": 17,
      "slug": "cryo-hilichurl-shooter",
      "name": "Cryo Hilichurl Shooter",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/enemies/cryo-hilichurl-shooter"
    }
  ]
}

Random

Returns one random item with the same shape as the single item endpoint. Accepts name.

Try it

GETgenshin-api.REPLACE_ME.workers.dev