The category ID is used to limit the results that are returned. This field may pass in one category ID or a comma separated list of IDs as illustrated in the following examples:

/buy/browse/v1/item_summary/search?category_ids=29792

/buy/browse/v1/item_summary/search?category_ids=267,29792

Note: Currently, you can pass in only one category ID per request.
To refine the set of information that is returned, category_ids may be combined with EITHER:

epid and/or gtin values
q keywords

For example, when looking of a toy phone, simply searching for "phone" will return mobile phones because that is the "Best Match" for the search. To further refine the request to include toy phones, include the Toys & Hobbies category ID as illustrated here:

/buy/browse/v1/item_summary/search?q=phone&category_ids=220

Because the list of eBay category IDs is not published and category IDs are not the same across all eBay marketplaces, category IDs may be determined by:

Visiting the Category Changes page
Using the Taxonomy API. Refer to Get Categories for Buy APIs for complete information.

Issuing the following call to retrieve the dominantCategoryId for an item:

/buy/browse/v1/item_summary/search?q= keyword&fieldgroups=ASPECT_REFINEMENTS

Note: If a top-level (L1) category is specified, you must also include a q query parameter.

Types that use Items

Call that uses Items

Fields