Get categories

The canonical Oyster product taxonomy — the closed set of categories a product may be
filed under, and the list a vendor picks from. Retired legacy categories are never
returned, whatever their active flag says.

Only the categories Oyster carries are returned: the face and body groups, plus
Kits & Sets for now. Hair care, makeup, fragrance, supplements, tools & devices,
baby and grooming exist in the taxonomy so they can be recognised, but a product
filed under one of them is rejected at upload and never listed.

The taxonomy is flat, so parent_id and include_children are accepted for backwards
compatibility but can never match anything.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params

Search term to filter categories by name or description

integer

Deprecated. The canonical taxonomy is flat, so this never matches a category.

boolean
Defaults to false

Deprecated. The canonical taxonomy is flat, so children is always empty.

Response

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json