- Pages
- /
- Dealers
- /
- Data Depot
- /
- Version 4
- /
- API
- /
- Services
- /
- Taxonomyterms
- Downloads
- API Documentation
- Support
API News and Updates
Subscribe to stay alert on the API.
Taxonomyterms
Taxonomyterms are a scheme of classification as it relates to the different services in our API. It is an order or arrangement of different Images, Items, Products, or Vehiclemodels into categories.
Taxonomyterms are how we categorize entities into nested structures. In the past, the WPS print catalogs were our primary method of categorization. This is no longer the case with the addition of Vocabularies and their associated Taxonomyterms in Version 4 of the WPS API.
Taxonomyterms are children of Vocabularies and have a one-to-many Vocabulary→Taxonomyterms relationship.
Info
Taxonomyterms utilize a Nested set model that allows us to manage and access hierarchical tree data in a performant manner.Example requests
Collection
https://api.wps-inc.com/taxonomyterms
Entity
https://api.wps-inc.com/taxonomyterms/197
...or send multiple ids separated by a comma(,)
https://api.wps-inc.com/taxonomyterms/1,2,3,4,5
Associated Images
https://api.wps-inc.com/taxonomyterms/10/images
Associated Items
https://api.wps-inc.com/taxonomyterms/197/items
Associated Products
https://api.wps-inc.com/taxonomyterms/76/products
Associated Vehiclemodels
https://api.wps-inc.com/taxonomyterms/50/vehiclemodels
Parent Vocabulary
https://api.wps-inc.com/taxonomyterms/197/vocabulary
Pro Tip: Catalog Classification
A very popular Vocabulary is one we call "Catalog Classification" which is used as a very top-level and overall classification to indicate which
print catalog an Item belongs to, is currently in, or has ever appeared in. The vocabulary id for this is 15 for which the Taxonomyterms can
be seen at /vocabularies/15/taxonomyterms
.
—
In the context of Taxonomyterms, this means you could retrieve all the Items for a specific Taxonomyterm (For example, id 193 is the
ATV catalog classification.) /taxonomyterms/193/items
This is a pretty easy way to get all Items that we classify as "ATV",
which is a question we get asked a lot.