Skip to main content
cURL
Cost: Free.
Alura fetches each category’s properties from Etsy weekly. fetched_at says when. properties is empty only when Etsy lists none.

What a listing can set

deprecated: true marks a property Etsy still lists but refuses in writes. Don’t set it on a listing.
It answers 503 with a Retry-After header, never an empty list. Retry after that many seconds.

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_properties"
category_id
string
required

Etsy seller-taxonomy ID, as a string.

properties
object[]
required

Etsy's properties for this category; empty when Etsy lists none.

fetched_at
string
required

When Alura last fetched this from Etsy (ISO 8601, UTC).