account | DynamicAccount | Yes | - | Select the Amazon Ads profile; categories are per marketplace. |
lookup | string or SelectableOption | No | recommended_for_asins | What to look up. recommended_for_asins: the categories Amazon recommends for your ASINs, with the full category path and parent, the usual starting point for PRODUCT_CATEGORY targets. browse_tree: the whole targetable category tree of the marketplace, flattened to one row per category with its path; use name_search to narrow it. refinements: the brands, age ranges and genres you can refine a category with (their ids go into product_category_refinement). asin_count: how many ASINs a category, optionally narrowed by a refinement, would target. |
asins | array of string (also accepts a comma-separated string) | No | - | ASINs to get category recommendations for, as a list or comma-separated text. Required for recommended_for_asins. |
include_ancestors | boolean | No | True | For recommended_for_asins: also return the parent categories of the recommended ones, which is how you find the broad category above your product. Default true. |
category_id | string or SelectItem | No | - | Category ID from a previous lookup. Required for refinements and asin_count. |
refinement | object or string | No | - | For asin_count: the same productCategoryRefinement object amazon_ads_create_targets takes (productBrandId, productGenreId, productAgeRangeId, productPriceGreaterThan, productPriceLessThan, productRatingGreaterThan, productRatingLessThan, productPrimeShippingEligible), so you can size a target before creating it. productCategoryId inside it is ignored in favour of category_id. |
name_search | string | No | - | Return only categories whose name or path contains this text (case-insensitive). Applies to browse_tree and recommended_for_asins. |
locale | string | No | - | Optional locale for translated category names, for example en_US or de_DE. Passed to Amazon as-is. |
limit | integer | No | 200 | Maximum number of rows to return (1-5000). Default: 200. The full tree can hold thousands of categories, so narrow with name_search. |
