Search channel categories

GET /rest/v1/channel_accounts/{id}/categories

Search the channel's category tree (e.g. eBay categories, Etsy taxonomy, Kaufland categories). Support varies by channel — see the discovery flags on the channel account. Channels without a category model (e.g. Shopify) return an empty list.

Authorization

apiKey

AuthorizationBearer <token>

Authorization: Bearer nbl_live_... (or nbl_test_... for test mode). Test-mode writes are validated and simulated but never persisted and never touch channels; simulated results are marked simulated.

In: header

Path Parameters

id*string

Channel account id from GET /channel_accounts (e.g. chac_...). Never construct it.

Query Parameters

q?string

Free-text search.

parent_id?string

List children of a category instead of searching.

limit?integer

Range1 <= value <= 100

Default25

Response Body

`application/json`

curl -X GET "https://example.com/channel_accounts/string/categories"

{  "object": "list",  "data": [    {      "id": "11450",      "object": "category",      "name": "Jackets & Coats",      "path": "Clothing > Men > Jackets & Coats",      "leaf": true    }  ]}

Last updated on July 28, 2026

Need help?

The API is in private beta — email us and a human replies, usually within one business day.

Email us API status

Authorization

Path Parameters

Query Parameters

Response Body

200application/json

404application/json

`application/json`

`application/json`