Skip to content

The data model

item AK-47 | Case Hardened def_index 7, paint_index 44
└ guide one Steam guide, one author
└ system one property being ranked "Blue Gem", "Max Black"
└ level one place in that ranking "top", "1", "2"
└ seeds
level what it is example
item identity: weapon, finish, (def_index, paint_index) AK-47 | Case Hardened, def 7 paint 44
guide one Steam guide, one author (or a listed collaborator) “AK-47 Case Hardened | Blue Gem” by korenevskiy
system one property the guide ranks “AK-47 Blue Gem”, “Gold Gem Patterns”
level one place in that system’s own ranking top, 1, 2, 3
seed a pattern seed placed at that level, with the verbatim quote it came from seed 387 at level 1

A tier guide is one system with many levels (Tier 1, Tier 2, …). A group guide is many systems with one level each: membership only, no ranking within the group. Both have the same JSON shape, so don’t branch on which one a guide is.

Many items have more than one guide. GET /v1/items/{def}/{paint} returns a menu: every guide that covers the item and every system in each, with counts but no seeds. Fetch a guide (GET /v1/guides/{steam_id}) or a seed (GET /v1/items/{def}/{paint}/seeds/{seed}) for the gradings.

Item identity (def_index, paint_index, slug, weapon, finish) and guide opinion (systems, levels, gradings) are kept apart. /items/{def}/{paint} returns identity plus a guide menu; /guides/{steam_id} returns one guide’s full opinion. A guide never changes item identity.