Search a channel's categories
GET /rest/v1/channel_accounts/{id}/categories
The categories this account can publish into, for a product: the eBay category tree of the listing's site, Etsy's taxonomy, TikTok Shop's, Google product categories (Google Merchant Center and Meta catalogs), Shopify's standard product taxonomy, Kaufland's, OnBuy's, Faire's product types, and the shop's own categories on Square, Wix, WooCommerce and PrestaShop. Pass the id as category_id to POST /listings or PATCH /listings/{id}: the chosen category then wins over the one the channel picks itself, at publish and on edit (a live listing moves; OnBuy keeps the category a product page was created with). Amazon accounts use amazon_product_types.
Required scope: products:read.
Authorization
apiKey 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
Query Parameters
Keywords; default: the product title.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/channel_accounts/string/categories?product_id=string"{ "object": "list", "data": [ { "object": "category", "id": "116026", "name": "Dishwasher Parts", "path": "Home & Garden > Major Appliances > Major Appliances Parts & Accessories > Dishwasher Parts" } ]}Need help?
Email us and a human replies, usually within one business day.