Endpoint

List entities

GET /api/{game}/entities.json

Every entity in one game, reduced to what a list needs: identity, tags and counts. This is the file to search against — it holds no values, so it stays small enough to fetch up front.

Path parameters

game

string

A game slug from the index.

Response

An object holding the game’s entity index.

game	string	The slug this list belongs to.
title	string	Display name of the game.
attribution	string	Source and terms for this game’s data.
entities	EntitySummary[]	One entry per entity.
entities[].id	string	Stable identifier. Unique within the game only.
entities[].file	string	What to put in the entity URL. Differs from `id` where the id carries punctuation.
entities[].type	string	`ability`, `weapon`, `champion`, `spell`, `item`, `map`, `system`.
entities[].name	string	What players call it.
entities[].group	string	The heading it belongs under — its agent, champion or category.
entities[].tags	string[]	Identity worth showing in a row: slot, class, codename, removal patch.
entities[].description?	string \| null	What it does, in the game’s own words.
entities[].values	integer	How many values currently resolve.
entities[].facts	integer	How many facts in total, including superseded ones.

Fetch this once per game and filter it client-side. A search that refetches on every keystroke is slower and no fresher.

Request

curl -s -H "x-api-key: $KB_API_KEY" https://kb.play-ascend.com/api/valorant/entities.json

Response example

{
  "schemaVersion": 3,
  "game": "valorant",
  "title": "VALORANT",
  "attribution": "Ability figures are facts extracted from Riot Games' official VALORA…",
  "entities": [
    {
      "id": "abyss",
      "file": "abyss",
      "type": "map",
      "name": "Abyss",
      "group": "Maps",
      "tags": [
        "A/B Sites",
        "Infinity"
      ],
      "description": null,
      "values": 5,
      "facts": 5
    },
    {
      "id": "ares",
      "file": "ares",
      "type": "weapon",
      "name": "Ares",
      "group": "Heavy Weapons",
      "tags": [
        "Heavy Weapons",
        "LMG"
      ],
      "description": null,
      "values": 18,
      "facts": 21
    },
    "… 189 more"
  ]
}