Skip to main content
cURL
Cost: Free.
parent_id is null for a top-level category, and children is empty for a leaf. To walk down the tree, call this again with a child’s id. To find a category by name, use Search categories. For the attributes a listing in it can have, use Get category properties.

Authorizations

Authorization
string
header
required

An API key: Authorization: Bearer alura_sk_....

Path Parameters

id
string
required

Etsy seller-taxonomy ID.

Pattern: ^[1-9][0-9]{0,18}$
Example:

"1062"

Query Parameters

fields
string

Comma-separated dotted paths to return; id, object and as_of always come back.

Response

OK

object
string
required
Allowed value: "category"
id
string
required

Etsy seller-taxonomy ID, as a string.

name
string
required

The category's name, as Etsy writes it.

path
string[]
required

Names from the top level down to this category.

parent_id
string | null
required

null for a top-level category.

children
object[]
required

Direct subcategories; empty for a leaf.