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.
Several guides per item
Section titled “Several guides per item”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.
Identity vs opinion
Section titled “Identity vs opinion”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.