Magidoc

Taxonomy

Whatnot organizes every product in the marketplace under a single category tree — our product taxonomy. We publish the full, machine-readable taxonomy to a public GitHub repository so you can browse it, diff it, and build against it:

The repository is generated automatically from Whatnot's internal source of truth — it is published, not hand-edited. The taxonomy is available in two equivalent formats under data/ :

Each entry describes one category:

Field
Type
Description
id
number
Stable category identifier.
type
string
Machine-readable category slug.
label
string
Human-readable display name.
parent_id
number | null
Parent category id ; null for top-level categories.
allows_inventory
boolean
Whether the category accepts inventory (present where applicable).

The top-level version field is the published semantic version of the taxonomy. See the repository's CHANGELOG.md for the history of published versions.

Explore the taxonomy

#

The explorer below fetches data/taxonomy.json directly from GitHub on load, so it always reflects the latest published taxonomy. Search across every assembled breadcrumb, drill down level by level, and select any category to inspect its breadcrumb and full details.