List product categories
Retrieve the product categories your organization has ICP access to.
/v1/product-categoriesLists the product categories your organization has ICP access to.
Use a returned category's id as the product_category_id when you
submit a PDP by GTIN or
submit an image for scoring. Not required
for ASIN ingestion — category is derived from the retailer scrape.
Pass the optional retailer query parameter to scope the results to
a single retailer region.
Authorization
bearerAuth Short-lived access token issued by Create a token.
Send it on every request as Authorization: Bearer <token>.
In: header
Query Parameters
Optional retailer region to scope categories to (e.g., amazon_us,
walmart_us). Must be a valid retailer_region identifier; invalid
values return 400.
Response Body
application/json
application/json
curl -X GET "https://ext.vizit.com/v1/product-categories"[ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "category_name": "Fish Oil Supplements", "path": "Health & Household > Vitamins & Supplements > Fish Oil Supplements" }]{ "detail": "string", "status_code": 0, "error_code": "INVALID_GTIN", "request_id": "266ea41d-adf5-480b-af50-15b940c2b846", "extra": { "failed_urls": [ { "url": "https://cdn.example.com/broken.jpg", "reason": "IMAGE_DOWNLOAD_TIMEOUT" }, { "url": "https://cdn.example.com/icon.svg", "reason": "UNSUPPORTED_IMAGE_FORMAT" } ] }, "timestamp": "2019-08-24T14:15:22Z"}POSTCreate a token
The returned token authenticates every other call in this API. This endpoint itself is unauthenticated — no token required to call it.
GETList product retailers
Lists the retailer regions you can use to scope product category discovery. Pass a returned retailer's `id` (e.g. `amazon_us`, `walmart_us`) as the `retailer` query parameter on [list product categories](/api/product-details/listProductCategories).