Open API v2 will be deprecated on April 3, 2023. Please begin transitioning to Open API v3 as soon as possible. As of September 29, 2022 all new apps will only be permitted to use Open API v3.
- ApiMethod
- BillCharge
- BillingOverview
- BillPayment
- Cart
- CartListing
- Country
- Coupon
- DataType
- FavoriteListing
- FavoriteUser
- Feedback
- FeedbackInfo
- ForumPost
- Guest
- GuestCart
- ImageType
- Ledger
- LedgerEntry
- Listing
- ListingFile
- ListingImage
- ListingInventory
- ListingOffering
- ListingProduct
- ListingTranslation
- ListingVariationImage
- Money
- ParamList
- Payment
- PaymentAccountLedgerEntry
- PaymentAdjustment
- PaymentAdjustmentItem
- PaymentTemplate
Taxonomy
Overview 
A new-style category for Etsy listings, replacing Category. If you set the taxonomy_id property of a Listing Etsy will automatically fill in the corresponding category_id, and vice-versa. This Taxonomy can be deeper than the three levels provided by Category. We now have two taxonomies, one for sellers and one for buyers. You must use the seller taxonomy when deciding which taxonomy_id to use for a listing. The seller taxonomy is optimized for completeness and specificity. The buyer taxonomy is optimized for how buyers search on Etsy.
Fields
| Field | Visibility Level | Permission Scope | Type | Description |
|---|---|---|---|---|
id |
public |
none | int |
The unique ID of this taxonomy node. |
level |
public |
none | int |
Depth in the taxonomy, roots are at level 0. |
name |
public |
none | string |
Human readable name for this taxonomy node. |
parent |
public |
none | string |
Path of our parent node. |
parent_id |
public |
none | int |
ID of our parent node. |
path |
public |
none | string |
Path from the root to this node, separated by periods. |
category_id |
public |
none | int |
The corresponding ID in Etsy's Category API resource. |
children |
public |
none | array(taxonomy) |
The child Taxonomy nodes, embedded directly in the response. |
children_ids |
public |
none | array(int) |
The taxonomy_ids of our child nodes. |
full_path_taxonomy_ids |
public |
none | array(int) |
The taxonomy_ids of this node and all its parents. They are listed in order from root to leaf. |
Associations
This resource has no associations.
Methods
getBuyerTaxonomy
| Method Name | getBuyerTaxonomy |
|---|---|
| Synopsis | Retrieve the entire taxonomy as seen by buyers in search. |
| HTTP Method | GET |
| URI | /taxonomy/buyer/get |
| Parameters | none |
| Requires OAuth | N |
| Permission Scope | none |
getSellerTaxonomy
| Method Name | getSellerTaxonomy |
|---|---|
| Synopsis | Retrieve the entire taxonomy as used by sellers in the listing process. |
| HTTP Method | GET |
| URI | /taxonomy/seller/get |
| Parameters | none |
| Requires OAuth | N |
| Permission Scope | none |
getSellerTaxonomyVersion
| Method Name | getSellerTaxonomyVersion |
|---|---|
| Synopsis | Get the current version of the seller taxonomy |
| HTTP Method | GET |
| URI | /taxonomy/seller/version |
| Parameters | none |
| Requires OAuth | N |
| Permission Scope | none |