search | eBay Catalog API

GET/product_summary/search

This method searches for and retrieves summaries of one or more products in the eBay catalog that match the search criteria provided by a seller. The seller can use the summaries to select the product in the eBay catalog that corresponds to the item that the seller wants to offer for sale. When a corresponding product is found and adopted by the seller, eBay will use the product information to populate the item listing. The criteria supported by search include keywords, product categories, and category aspects. To see the full details of a selected product, use the getProduct call.

In addition to product summaries, this method can also be used to identify refinements, which help you to better pinpoint the product you're looking for. A refinement consists of one or more aspect values and a count of the number of times that each value has been used in previous eBay listings. An aspect is a property (e.g. color or size) of an eBay category, used by sellers to provide details about the items they're listing. The refinement container is returned when you include the fieldGroups query parameter in the request with a value of ASPECT_REFINEMENTS or FULL.

Example
A seller wants to find a product that is "gray" in color, but doesn't know what term the manufacturer uses for that color. It might be Silver, Brushed Nickel, Pewter, or even Grey. The returned refinement container identifies all aspects that have been used in past listings for products that match your search criteria, along with all of the values those aspects have taken, and the number of times each value was used. You can use this data to present the seller with a histogram of the values of each aspect. The seller can see which color values have been used in the past, and how frequently they have been used, and selects the most likely value or values for their product. You issue the search method again with those values in the aspect_filter parameter to narrow down the collection of products returned by the call.

Although all query parameters are optional, this method must include at least the q parameter, or the category_ids, gtin, or mpn parameter with a valid value. If you provide more than one of these parameters, they will be combined with a logical AND to further refine the returned collection of matching products.

Note: This method requires that certain special characters in the query parameters be percent-encoded:

(space) = %20 , = %2C : = %3A [ = %5B ] = %5D { = %7B | = %7C } = %7D

This requirement applies to all query parameter values. However, for readability, method examples and samples in this documentation will not use the encoding.

This method returns product summaries rather than the full details of the products. To retrieve the full details of a product, use the getProduct method with an ePID.

Input

Resource URI (production)

GET https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?

q=string&

gtin=string&

mpn=string&

category_ids=string&

aspect_filter=AspectFilter&

fieldgroups=string&

limit=string&

offset=string&

URI parameters

Parameter	Type	Description
q	string	A string consisting of one or more keywords to use to search for products in the eBay catalog. Note: This method searches the following product record fields: title, description, brand, and aspects.localizedName, which do not include product IDs. Wildcard characters (e.g. ``) are not allowed. The keywords are handled as follows: If the keywords are separated by a comma (e.g. `iPhone,256GB`), the query returns products that have `iPhone` AND* `256GB`. If the keywords are separated by a space (e.g. `"iPhone ipad"` or `"iPhone, ipad"`), the query ignores any commas and returns products that have `iPhone` OR `iPad`. Note: Although all query parameters are optional, this method must include at least the q parameter, or the category_ids, gtin, or mpn parameter with a valid value. You cannot use the q parameter in the same method with either the gtin parameter or the mpn parameter. Occurrence: Optional
gtin	array of string	A string consisting of one or more comma-separated Global Trade Item Numbers (GTINs) that identify products to search for. Currently the GTIN values can include EAN, ISBN, and UPC identifier types. Note: Although all query parameters are optional, this method must include at least the q parameter, or the category_ids, gtin, or mpn parameter with a valid value. You cannot use the gtin parameter in the same method with either the q parameter or the aspect_filter parameter. Occurrence: Optional
mpn	array of string	A string consisting of one or more comma-separated Manufacturer Part Numbers (MPNs) that identify products to search for. This method will return all products that have one of the specified MPNs. MPNs are defined by manufacturers for their own products, and are therefore certain to be unique only within a given brand. However, many MPNs do turn out to be globally unique. Note: Although all query parameters are optional, this method must include at least the q parameter, or the category_ids, gtin, or mpn parameter with a valid value. You cannot use the mpn parameter in the same method with either the q parameter or the aspect_filter parameter. Occurrence: Optional
category_ids	array of string	Important: Currently, only the first category_id value is accepted. One or more comma-separated category identifiers for narrowing down the collection of products returned by this call. Note: This parameter requires a valid category ID value. You can use the Taxonomy API's getCategorySuggestions method to retrieve appropriate category IDs for your product based on keywords. The syntax for this parameter is as follows: `category_ids=category_id1,category_id2,.` Here is an example of a method with the category_ids parameter: br /> `GET https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search? category_ids=178893` Note: Although all query parameters are optional, this method must include at least the q parameter, or the category_ids, gtin, or mpn parameter with a valid value. If you provide only the category_ids parameter, you cannot specify a top-level (L1) category. Occurrence: Optional
aspect_filter	AspectFilter	An eBay category and one or more aspects of that category, with the values that can be used to narrow down the collection of products returned by this call. Aspects are product attributes that can represent different types of information for different products. Every product has aspects, but different products have different sets of aspects. You can determine appropriate values for the aspects by first submitting this method without this parameter. It will return either the productSummaries.aspects container, the refinement.aspectDistributions container, or both, depending on the value of the fieldgroups parameter in the request. The productSummaries.aspects container provides the category aspects and their values that are associated with each returned product. The refinement.aspectDistributions container provides information about the distribution of values of the set of category aspects associated with the specified categories. In both cases sellers can select from among the returned aspects to use with this parameter. Note: You can also use the Taxonomy API's getItemAspectsForCategory method to retrieve detailed information about aspects and their values that are appropriate for your selected category. The syntax for the aspect_filter parameter is as follows (on several lines for readability; categoryId is required): `aspect_filter=categoryId:category_id, aspect1:{valueA\|valueB\|...}, aspect2:{valueC\|valueD\|...},.` A matching product must be within the specified category, and it must have least one of the values identified for every specified aspect. Note: Aspect names and values are case sensitive. Here is an example of an aspect_filter parameter in which `9355` is the category ID, `Color` is an aspect of that category, and `Black` and `White` are possible values of that aspect (on several lines for readability): `GET https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search? aspect_filter=categoryId:9355,Color:{White\|Black}` Here is the aspect_filter with required URL encoding and a second aspect (on several lines for readability): `GET https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search? aspect_filter=categoryId:9355,Color:%7BWhite%7CBlack%7D, Storage%20Capacity:%128GB%7C256GB%7D` Note: You cannot use the aspect_filter parameter in the same method with either the gtin parameter or the mpn parameter. Occurrence: Optional
fieldgroups	array of string	The type of information to return in the response. Important: This parameter may not produce valid results if you also provide more than one value for the category_ids parameter. It is recommended that you avoid using this combination. Valid Values: `ASPECT_REFINEMENTS` — This returns the refinement container, which includes the category aspect and aspect value distributions that apply to the returned products. For example, if you searched for `Ford Mustang`, some of the category aspects might be Model Year, Exterior Color, Vehicle Mileage, and so on. Note: Aspects are category specific. `FULL` — This returns all the refinement containers and all the matching products. This value overrides the other values, which will be ignored. `MATCHING_PRODUCTS` — This returns summaries for all products that match the values you provide for the q and category_ids parameters. This does not affect your use of the `ASPECT_REFINEMENTS` value, which you can use in the same call. Code so that your app gracefully handles any future changes to this list. Default: `MATCHING_PRODUCTS` Occurrence: Optional
limit	string	The number of product summaries to return. This is the result set, a subset of the full collection of products that match the search or filter criteria of this call. Maximum: `200` Default: `50` Occurrence: Optional
offset	string	This parameter is reserved for internal or future use. Occurrence: Optional

HTTP request headers

All requests made to eBay REST operations require you to provide the Authorization HTTP header for authentication authorization.

The table below shows additional HTTP request headers that are either required, conditionally required, or strongly recommended for this method. Other standard HTTP request headers- opens rest request components page (not in this table) can also be used, but they are optional.

Header Type Description

Header	Type	Description
X-EBAY-C-MARKETPLACE-ID	string	This method also uses the `X-EBAY-C-MARKETPLACE-ID` header to identify the seller's eBay marketplace. It is required for all supported marketplaces, except EBAY_US, which is the default. Occurrence: Conditional

X-EBAY-C-MARKETPLACE-ID

string

This method also uses the X-EBAY-C-MARKETPLACE-ID header to identify the seller's eBay marketplace. It is required for all supported marketplaces, except EBAY_US, which is the default.

Occurrence: Conditional

OAuth scope

This request requires an access token created with the authorization code grant flow, using one or more scopes from the following list (please check your Application Keys page for a list of OAuth scopes available to your application):

https://api.ebay.com/oauth/api_scope/sell.inventory

https://api.ebay.com/oauth/api_scope/commerce.catalog.readonly

See OAuth access tokens for more information.

Note: Only the sell.inventory scope is required for selling applications, and only the commerce.catalog.readonly scope is required for buying applications.

Request payload

This call has no payload.

Request fields

This call has no field definitions.

Output

HTTP response headers

This call has no response headers.

Response payload

Copy complete valid JSON to clipboard

{ /* ProductSearchResponse */

"href" : "string",

"limit" : "integer",

"next" : "string",

"offset" : "integer",

"prev" : "string",

"productSummaries" : [

{ /* ProductSummary */

"additionalImages" : [

{ /* Image */

"height" : "integer",

"imageUrl" : "string",

"width" : "integer"

}

"aspects" : [

{ /* Aspect */

"localizedName" : "string",

"localizedValues" : [

"string"

]

}

"brand" : "string",

"ean" : [

"string"

"epid" : "string",

"gtin" : [

"string"

"image" :

{ /* Image */

"height" : "integer",

"imageUrl" : "string",

"width" : "integer"

"isbn" : [

"string"

"mpn" : [

"string"

"productHref" : "string",

"productWebUrl" : "string",

"title" : "string",

"upc" : [

"string"

]

}

"" :

{ /* Refinement */

"" : [

{ /* AspectDistribution */

"" : [

{ /* AspectValueDistribution */

"" : "string",

"" : "integer",

"" : "string"

}

"" : "string"

}

"" : "string"

"total" : "integer"

}

Response fields

Output container/field	Type	Description
href	string	This field is reserved for internal or future use. Occurrence: NA
limit	integer	The number of product summaries returned in the response. This is the result set, a subset of the full collection of products that match the search or filter criteria of this call. If the limit query parameter was included in the request, this field will have the same value. Default: `50` Occurrence: Always
next	string	This field is reserved for internal or future use. Occurrence: NA
offset	integer	This field is reserved for internal or future use. Occurrence: NA
prev	string	This field is reserved for internal or future use. !-- Not returned if the currently returned result set is the first set of product records from the current collection of matching products. This field contains the search call URI for the previous result set. For example, the following URI returns products 21 thru 30 from the collection of products: `path/product_summary/search?limit=10&offset=20` Note: This feature employs a zero-based list, where the first product in the list has an offset of `0`. > Occurrence: NA
productSummaries	array of ProductSummary	Returned if the fieldGroups query parameter was omitted from the request, or if it was included with a value of `MATCHING_PRODUCTS` or `FULL`. This container provides an array of product summaries in the current result set for products that match the combination of the q, category_ids, and aspect_filter parameters that were provided in the request. Each product summary includes information about the product's identifiers, product images, aspects, the product page URL, and the getProduct URL for retrieving the product details. Occurrence: Conditional
productSummaries.additionalImages	array of Image	Contains information about additional images associated with this product. For the primary image, see the image container. Occurrence: Conditional
productSummaries.additionalImages.height	integer	The height of the image in pixels. Occurrence: Conditional
productSummaries.additionalImages.imageUrl	string	The eBay Picture Services (EPS) URL of the image. Occurrence: Always
productSummaries.additionalImages.width	integer	The width of the image in pixels. Occurrence: Conditional
productSummaries.aspects	array of Aspect	Contains an array of the category aspects and their values that are associated with this product. Occurrence: Conditional
productSummaries.aspects.localizedName	string	The localized name of this category aspect. Occurrence: Conditional
productSummaries.aspects.localizedValues	array of string	A list of the localized values of this category aspect. Occurrence: Conditional
productSummaries.brand	string	The manufacturer's brand name for this product. Occurrence: Conditional
productSummaries.ean	array of string	A list of all European Article Numbers (EANs) that identify this product. Occurrence: Conditional
productSummaries.epid	string	The eBay product ID of this product. Occurrence: Always
productSummaries.gtin	array of string	A list of all GTINs that identify this product. This includes all of the values returned in the ean, isbn, and upc fields. Occurrence: Conditional
productSummaries.image	Image	Contains information about the primary image of this product. For more images of this product, see the additionalImages container. Occurrence: Always
productSummaries.image.height	integer	The height of the image in pixels. Occurrence: Conditional
productSummaries.image.imageUrl	string	The eBay Picture Services (EPS) URL of the image. Occurrence: Always
productSummaries.image.width	integer	The width of the image in pixels. Occurrence: Conditional
productSummaries.isbn	array of string	A list of all International Standard Book Numbers (ISBNs) that identify this product. Occurrence: Conditional
productSummaries.mpn	array of string	A list of all Manufacturer Product Number (MPN) values that the manufacturer uses to identify this product. Occurrence: Conditional
productSummaries.productHref	string	The URI of the getProduct call request that retrieves this product's details. Occurrence: Always
productSummaries.productWebUrl	string	The URL for this product's eBay product page. Occurrence: Conditional
productSummaries.title	string	The title of this product on eBay. Occurrence: Always
productSummaries.upc	array of string	A list of Universal Product Codes (UPCs) that identify this product. Occurrence: Conditional
refinement	Refinement	Returned only if the fieldGroups query parameter was included in the request with a value of `ASPECT_REFINEMENTS` or `FULL`. An aspect is a property of a category, used by sellers to provide details about the items they're listing. For example, the Cell Phones & Smartphones category (#9355) includes a Storage Capacity aspect. This container provides information about the distribution of values of a set of category aspects. The category aspects are those associated with the category that eBay determines is most likely to cover the products that match the search criteria. Occurrence: Conditional
refinement.aspectDistributions	array of AspectDistribution	Contains information about one or more aspects that are associated with the category identified by dominantCategoryId. Occurrence: Conditional
refinement.aspectDistributions.aspectValueDistributions	array of AspectValueDistribution	Contains information about one or more values of the category aspect identified by localizedAspectName. Occurrence: Conditional
refinement.aspectDistributions.aspectValueDistributions.localizedAspectValue	string	The localized value of the category aspect identified by refinement.aspectDistributions.localizedAspectName. Occurrence: Conditional
refinement.aspectDistributions.aspectValueDistributions.matchCount	integer	The number of times the value of localizedAspectValue has been used for eBay product listings. By comparing this quantity to the matchCount for other values of the same aspect, you can present a histogram of the values to sellers, who can use that information to select which aspect value is most appropriate for their product. You can then include the user-selected value in the the search call's aspect_filter parameter to refine your search. Occurrence: Conditional
refinement.aspectDistributions.aspectValueDistributions.refinementHref	string	A HATEOAS reference that further refines the search with this particular localizedAspectValue. Occurrence: Conditional
refinement.aspectDistributions.localizedAspectName	string	The localized name of an aspect that is associated with the category identified by dominantCategoryId. Occurrence: Conditional
refinement.dominantCategoryId	string	The ID of the category that eBay determines is most likely to cover the products matching the search criteria. Occurrence: Conditional
total	integer	This field is reserved for internal or future use.

HTTP status codes

This call can return one of the following HTTP status codes. For an overview of the status codes, see HTTP status codes in Using eBay RESTful APIs.

Status	Meaning
200	Success
204	No Content
400	Bad Request
403	Forbidden
500	Internal Server Error

Error codes

For more on errors, plus the codes of other common errors, see Handling errors.

Code	Domain	Category	Meaning
75000	API_CATALOG	APPLICATION	There was a problem with an eBay internal system or process. Contact eBay developer support for assistance.
75001	API_CATALOG	REQUEST	The call must have a valid 'q', or 'category_ids' or 'gtin' or 'mpn' query parameter.
75004	API_CATALOG	REQUEST	The 'limit' value should be between 1 and 200 (inclusive).
75006	API_CATALOG	REQUEST	Top level category browsing is not allowed. Please provide keywords or more filters for the applied top level category.
75007	API_CATALOG	REQUEST	Currently, the {marketplaceId} marketplace is not supported. The supported Marketplaces are: {allowedMarketplaces} .
75008	API_CATALOG	REQUEST	The 'fieldgroups' value {fieldgroups} is invalid. The supported fieldgroups are: {supportedFieldgroups}
75012	API_CATALOG	REQUEST	The aspect_filter format is invalid. For more information, see the API call reference documentation.
75013	API_CATALOG	REQUEST	The 'aspect_filter' query parameter must include a categoryId. For more information, see the API call reference documentation.
75014	API_CATALOG	REQUEST	The categoryId in 'aspect_filter' query parameter is invalid. For more information, see the API call reference documentation.
75015	API_CATALOG	REQUEST	Insufficient permissions to fulfill the request.
75017	API_CATALOG	REQUEST	The specified GTIN value is invalid.
75018	API_CATALOG	REQUEST	The call must be made with either 'q' or 'gtin/mpn'.
75019	API_CATALOG	REQUEST	The call with 'gtin/mpn' cannot be made with aspect_filter.

Warnings

This call has no warnings.

Samples

New to making API calls? Please see Making a Call.

Note: Identifiers, such as order IDs or user IDs, and personal data in these samples might be anonymized or may no longer be active on eBay. If necessary, substitute current, relevant eBay data in your requests.

Sample 1: Search for Products by Keyword

Sample 2: Search for Products by Category

Sample 3: Search for Aspect Refinements Based on a Keyword

Sample 4: Search for Products Based on a Keyword and Filtered by Aspect

Sample 5: Search for Products Based on a GTIN

Sample 6: Search for Products Based on an MPN

Sample 1: Search for Products by Keyword

This sample returns a set of eBay products that match the keyword.

Input

The inputs are the query parameters q, which is the keyword, and limit. There is no payload with this request.

GEThttps://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=drone&limit=3

Output

If the call is successful, 3 product summaries will be returned in the result set.

{
    "productSummaries": [
        {
            "epid": "237137365",
            "gtin": [
                "0814838014791"
            ],
            "aspects": [
                {
                    "localizedName": "Leading Role",
                    "localizedValues": [
                        "SEAN Bean",
                        "Mary Mccormack",
                        "Patrick Sabongui",
                        "Joel Moore"
                    ]
                },
                {
                    "localizedName": "Director",
                    "localizedValues": [
                        "Jason Bourque"
                    ]
                },
                {
                    "localizedName": "Format",
                    "localizedValues": [
                        "Blu-ray Disc"
                    ]
                }
            ],
            "ean": [
                "0814838014791"
            ],
            "upc": [
                "0814838014791"
            ],
            "productHref": "https://api.ebay.com/commerce/catalog/v1_beta/product/237137365",
            "title": "Drone (Blu-ray Disc, 2017)",
            "productWebUrl": "https://www.latest.ebay.com/p/Drone+%28Blu%2Dray+Disc%2C+2017%29/237137365?src=urllib"
        },
        {
            "epid": "210388958",
            "gtin": [
                "9780578128801"
            ],
            "image": {
                "imageUrl": "https://i.ebayimg.com/00/s/NTAwWDMxMw==/z/nx4AAOSwLGtZs-57/$_6.JPG?set_id=89040003C1"
            },
            "aspects": [
                {
                    "localizedName": "Publication Year",
                    "localizedValues": [
                        "2013"
                    ]
                },
                {
                    "localizedName": "Language",
                    "localizedValues": [
                        "English"
                    ]
                },
                {
                    "localizedName": "Format",
                    "localizedValues": [
                        "Hardcover"
                    ]
                }
            ],
            "ean": [
                "9780578128801"
            ],
            "isbn": [
                "9780578128801"
            ],
            "productHref": "https://api.ebay.com/commerce/catalog/v1_beta/product/210388958",
            "title": "Uav and Drone Entrepreneurship by Jerry Lemieux (2013, Hardcover)",
            "productWebUrl": "https://www.latest.ebay.com/p/Uav+and+Drone+Entrepreneurship+by+Jerry+Lemieux+%282013%2C+Hardcover%29/210388958?src=urllib"
        },
        {
            "epid": "219437621",
            "gtin": [
                "0630509346929"
            ],
            "brand": "Hasbro",
            "mpn": [
                "B3926"
            ],
            "image": {
                "imageUrl": "https://i.ebayimg.com/00/s/NDAwWDQwMA==/z/1c4AAOSws4JW8XvW/$_6.JPG?set_id=89040003C1"
            },
            "aspects": [
                {
                    "localizedName": "Brand",
                    "localizedValues": [
                        "Hasbro"
                    ]
                },
                {
                    "localizedName": "MPN",
                    "localizedValues": [
                        "B3926"
                    ]
                },
                {
                    "localizedName": "Character Family",
                    "localizedValues": [
                        "Star Wars"
                    ]
                },
                {
                    "localizedName": "Recommended Age Range",
                    "localizedValues": [
                        "4+"
                    ]
                },
                {
                    "localizedName": "Size",
                    "localizedValues": [
                        "7in."
                    ]
                },
                {
                    "localizedName": "Year",
                    "localizedValues": [
                        "2015"
                    ]
                },
                {
                    "localizedName": "Type",
                    "localizedValues": [
                        "Action Figure Collection"
                    ]
                }
            ],
            "ean": [
                "0630509346929"
            ],
            "upc": [
                "0630509346929"
            ],
            "productHref": "https://api.ebay.com/commerce/catalog/v1_beta/product/219437621",
            "title": "Hasbro The Force Awakens BB-8 Droid Action Figure",
            "productWebUrl": "https://www.latest.ebay.com/p/Hasbro+The+Force+Awakens+BB%2D8+Droid+Action+Figure/219437621?src=urllib"
        }
    ],
    "limit": 3
}

Sample 2: Search for Products by Category

This sample returns a set of eBay products in the Cell Phones & Smartphones category.

Input

The input is the category_ids query parameter. There is no payload with this request.

GEThttps://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?category_ids=9355&limit=3

Output

If the call is successful, 3 product summaries will be returned in the result set.

{
    "productSummaries": [
        {
            "epid": "220023094",
            "gtin": [
                "0887276135649"
            ],
            "brand": "Samsung",
            "mpn": [
                "SM-G930VZDAVZW"
            ],
            "image": {
                "imageUrl": "https://i.ebayimg.com/00/s/NTAwWDMxMA==/z/9S4AAOSwUM5aCBzt/$_6.JPG?set_id=89040003C1"
            },
            "aspects": [
                {
                    "localizedName": "Brand",
                    "localizedValues": [
                        "Samsung"
                    ]
                },
                {
                    "localizedName": "MPN",
                    "localizedValues": [
                        "SMG930VZDAVZW"
                    ]
                },
                {
                    "localizedName": "Processor",
                    "localizedValues": [
                        "Quad Core"
                    ]
                },
                {
                    "localizedName": "Color",
                    "localizedValues": [
                        "Gold"
                    ]
                },
                {
                    "localizedName": "Network",
                    "localizedValues": [
                        "Verizon"
                    ]
                },
                {
                    "localizedName": "Storage Capacity",
                    "localizedValues": [
                        "32GB"
                    ]
                },
                {
                    "localizedName": "Screen Size",
                    "localizedValues": [
                        "5.1\""
                    ]
                },
                {
                    "localizedName": "Style",
                    "localizedValues": [
                        "Bar"
                    ]
                },
                {
                    "localizedName": "Camera Resolution",
                    "localizedValues": [
                        "12.0MP"
                    ]
                },
                {
                    "localizedName": "Model",
                    "localizedValues": [
                        "Samsung Galaxy S7"
                    ]
                },
                {
                    "localizedName": "Memory Card Type",
                    "localizedValues": [
                        "MicroSD"
                    ]
                },
                {
                    "localizedName": "Network Technology",
                    "localizedValues": [
                        "GSM"
                    ]
                }
            ],
            "ean": [
                "0887276135649"
            ],
            "upc": [
                "0887276135649"
            ],
            "productHref": "https://api.ebay.com/commerce/catalog/v1_beta/product/220023094",
            "title": "Samsung Galaxy S7 SM-G930 - 32GB - Gold Platinum (Verizon) Smartphone ",
            "productWebUrl": "https://www.latest.ebay.com/p/Samsung+Galaxy+S7+SM%2DG930+%2D+32GB+%2D+Gold+Platinum+%28Verizon%29+Smartphone/220023094?src=urllib"
        },
        {
            "epid": "220053197",
            "gtin": [
                "0887276155449"
            ],
            "brand": "Samsung",
            "mpn": [
                "SM-G930VZKAVZW"
            ],
            "image": {
                "imageUrl": "https://i.ebayimg.com/00/s/NjU2WDM4Mw==/z/bVQAAOSwAItZkv8X/$_6.JPG?set_id=89040003C1"
            },
            "aspects": [
                {
                    "localizedName": "Brand",
                    "localizedValues": [
                        "Samsung"
                    ]
                },
                {
                    "localizedName": "MPN",
                    "localizedValues": [
                        "SMG930VZKAVZW"
                    ]
                },
                {
                    "localizedName": "Processor",
                    "localizedValues": [
                        "Quad Core"
                    ]
                },
                {
                    "localizedName": "Color",
                    "localizedValues": [
                        "Black"
                    ]
                },
                {
                    "localizedName": "Network",
                    "localizedValues": [
                        "Verizon"
                    ]
                },
                {
                    "localizedName": "Storage Capacity",
                    "localizedValues": [
                        "32GB"
                    ]
                },
                {
                    "localizedName": "Screen Size",
                    "localizedValues": [
                        "5.1\""
                    ]
                },
                {
                    "localizedName": "Style",
                    "localizedValues": [
                        "Bar"
                    ]
                },
                {
                    "localizedName": "Camera Resolution",
                    "localizedValues": [
                        "12.0MP"
                    ]
                },
                {
                    "localizedName": "Lock Status",
                    "localizedValues": [
                        "Network Locked"
                    ]
                },
                {
                    "localizedName": "Model",
                    "localizedValues": [
                        "Samsung Galaxy S7"
                    ]
                },
                {
                    "localizedName": "Memory Card Type",
                    "localizedValues": [
                        "MicroSD"
                    ]
                },
                {
                    "localizedName": "Bundle Listing",
                    "localizedValues": [
                        "No"
                    ]
                },
                {
                    "localizedName": "Network Technology",
                    "localizedValues": [
                        "GSM"
                    ]
                }
            ],
            "ean": [
                "0887276155449"
            ],
            "upc": [
                "0887276155449"
            ],
            "productHref": "https://api.ebay.com/commerce/catalog/v1_beta/product/220053197",
            "title": "Samsung Galaxy S7 SM-G930 - 32GB - Black Onyx (Verizon) Smartphone",
            "productWebUrl": "https://www.latest.ebay.com/p/Samsung+Galaxy+S7+SM%2DG930+%2D+32GB+%2D+Black+Onyx+%28Verizon%29+Smartphone/220053197?src=urllib"
        },
        {
            "epid": "235346440",
            "gtin": [
                "0887276218830"
            ],
            "brand": "Samsung",
            "mpn": [
                "SM-G950UZKAXAA"
            ],
            "image": {
                "imageUrl": "https://i.ebayimg.com/00/s/OTI3WDQ4NA==/z/EWQAAOSwU8hY45KT/$_6.JPG?set_id=89040003C1"
            },
            "additionalImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/MTYwMFg4MDA=/z/HngAAOSwuxFY0nWj/$_6.JPG?set_id=89040003C1"
                },
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/MTYwMFg3NDc=/z/dM0AAOSwPbBZddSp/$_6.JPG?set_id=89040003C1"
                }
            ],
            "aspects": [
                {
                    "localizedName": "Brand",
                    "localizedValues": [
                        "Samsung"
                    ]
                },
                {
                    "localizedName": "MPN",
                    "localizedValues": [
                        "SMG950UZKAXAA"
                    ]
                },
                {
                    "localizedName": "Processor",
                    "localizedValues": [
                        "Octa Core"
                    ]
                },
                {
                    "localizedName": "Color",
                    "localizedValues": [
                        "Black"
                    ]
                },
                {
                    "localizedName": "Network",
                    "localizedValues": [
                        "Unlocked"
                    ]
                },
                {
                    "localizedName": "Storage Capacity",
                    "localizedValues": [
                        "64GB"
                    ]
                },
                {
                    "localizedName": "Screen Size",
                    "localizedValues": [
                        "5.8\""
                    ]
                },
                {
                    "localizedName": "Style",
                    "localizedValues": [
                        "Bar"
                    ]
                },
                {
                    "localizedName": "Camera Resolution",
                    "localizedValues": [
                        "12.0MP"
                    ]
                },
                {
                    "localizedName": "Lock Status",
                    "localizedValues": [
                        "Factory Unlocked"
                    ]
                },
                {
                    "localizedName": "Model",
                    "localizedValues": [
                        "Samsung Galaxy S8"
                    ]
                },
                {
                    "localizedName": "Memory Card Type",
                    "localizedValues": [
                        "MicroSD"
                    ]
                },
                {
                    "localizedName": "Bundle Listing",
                    "localizedValues": [
                        "No"
                    ]
                },
                {
                    "localizedName": "Network Technology",
                    "localizedValues": [
                        "LTE"
                    ]
                }
            ],
            "ean": [
                "0887276218830"
            ],
            "upc": [
                "0887276218830"
            ],
            "productHref": "https://api.ebay.com/commerce/catalog/v1_beta/product/235346440",
            "title": "Samsung Galaxy S8 SM-G950U - 64GB - Midnight Black (Unlocked) Smartphone",
            "productWebUrl": "https://www.latest.ebay.com/p/Samsung+Galaxy+S8+SM%2DG950U+%2D+64GB+%2D+Midnight+Black+%28Unlocked%29+Smartphone/235346440?src=urllib"
        }
    ],
    "limit": 3
}

Sample 3: Search for Aspect Refinements Based on a Keyword

This call searches the catalog for the iphone keyword. Based on the results of that search, it returns the aspect refinements for the dominant category (Cell Phones & Smartphones) of products that contain the keyword.

Input

The input is the category_ids query parameter. There is no payload with this request.

GEThttps://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS

Output

If the call is successful, all aspects that apply to the dominant category of the products identified by the keyword will be returned in the result set, with counts of all values of those aspects that have been used.

{
    "refinement": {
        "aspectDistributions": [
            {
                "localizedAspectName": "Features",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "3G Data Capable",
                        "matchCount": 17586,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7B3G+Data+Capable%7D"
                    },
                    {
                        "localizedAspectValue": "4G Data Capable",
                        "matchCount": 17412,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7B4G+Data+Capable%7D"
                    },
                    {
                        "localizedAspectValue": "Bluetooth Enabled",
                        "matchCount": 17206,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BBluetooth+Enabled%7D"
                    },
                    {
                        "localizedAspectValue": "Fingerprint Sensor",
                        "matchCount": 12357,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BFingerprint+Sensor%7D"
                    },
                    {
                        "localizedAspectValue": "GPS",
                        "matchCount": 11085,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BGPS%7D"
                    },
                    {
                        "localizedAspectValue": "Internet Browser",
                        "matchCount": 9934,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BInternet+Browser%7D"
                    },
                    {
                        "localizedAspectValue": "Touchscreen",
                        "matchCount": 10326,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BTouchscreen%7D"
                    },
                    {
                        "localizedAspectValue": "Wi-Fi Capable",
                        "matchCount": 10104,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BWi-Fi+Capable%7D"
                    },
                    {
                        "localizedAspectValue": "4K Video Recording",
                        "matchCount": 5357,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7B4K+Video+Recording%7D"
                    },
                    {
                        "localizedAspectValue": "Accelerometer",
                        "matchCount": 6384,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BAccelerometer%7D"
                    },
                    {
                        "localizedAspectValue": "Air Gesture",
                        "matchCount": 1339,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BAir+Gesture%7D"
                    },
                    {
                        "localizedAspectValue": "ANT+",
                        "matchCount": 170,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BANT%2B%7D"
                    },
                    {
                        "localizedAspectValue": "Dual Rear Cameras",
                        "matchCount": 558,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BDual+Rear+Cameras%7D"
                    },
                    {
                        "localizedAspectValue": "Dual SIM",
                        "matchCount": 430,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BDual+SIM%7D"
                    },
                    {
                        "localizedAspectValue": "Front Camera",
                        "matchCount": 1485,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BFront+Camera%7D"
                    },
                    {
                        "localizedAspectValue": "Geotagging",
                        "matchCount": 656,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BGeotagging%7D"
                    },
                    {
                        "localizedAspectValue": "Global Ready",
                        "matchCount": 5708,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BGlobal+Ready%7D"
                    },
                    {
                        "localizedAspectValue": "High Capacity Battery (5000 mAh or More)",
                        "matchCount": 110,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BHigh+Capacity+Battery+%285000+mAh+or+More%29%7D"
                    },
                    {
                        "localizedAspectValue": "Iris Scanning",
                        "matchCount": 52,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BIris+Scanning%7D"
                    },
                    {
                        "localizedAspectValue": "Music Player",
                        "matchCount": 8476,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BMusic+Player%7D"
                    },
                    {
                        "localizedAspectValue": "Near Field Communication",
                        "matchCount": 3222,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BNear+Field+Communication%7D"
                    },
                    {
                        "localizedAspectValue": "Proximity Sensor",
                        "matchCount": 367,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BProximity+Sensor%7D"
                    },
                    {
                        "localizedAspectValue": "Push to Talk",
                        "matchCount": 639,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BPush+to+Talk%7D"
                    },
                    {
                        "localizedAspectValue": "QWERTY Keyboard",
                        "matchCount": 1066,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BQWERTY+Keyboard%7D"
                    },
                    {
                        "localizedAspectValue": "Rear Camera",
                        "matchCount": 1172,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BRear+Camera%7D"
                    },
                    {
                        "localizedAspectValue": "Rugged",
                        "matchCount": 26,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BRugged%7D"
                    },
                    {
                        "localizedAspectValue": "Speakerphone",
                        "matchCount": 9858,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BSpeakerphone%7D"
                    },
                    {
                        "localizedAspectValue": "TTY Compatible",
                        "matchCount": 2741,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BTTY+Compatible%7D"
                    },
                    {
                        "localizedAspectValue": "Voice-Activated Dialing",
                        "matchCount": 4985,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BVoice-Activated+Dialing%7D"
                    },
                    {
                        "localizedAspectValue": "Water-Resistant",
                        "matchCount": 525,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BWater-Resistant%7D"
                    },
                    {
                        "localizedAspectValue": "Wireless Charging",
                        "matchCount": 355,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CFeatures%3A%7BWireless+Charging%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Network",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "AT&T",
                        "matchCount": 14763,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CNetwork%3A%7BAT%26T%7D"
                    },
                    {
                        "localizedAspectValue": "Sprint",
                        "matchCount": 6862,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CNetwork%3A%7BSprint%7D"
                    },
                    {
                        "localizedAspectValue": "T-Mobile",
                        "matchCount": 5021,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CNetwork%3A%7BT-Mobile%7D"
                    },
                    {
                        "localizedAspectValue": "Verizon",
                        "matchCount": 10122,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CNetwork%3A%7BVerizon%7D"
                    },
                    {
                        "localizedAspectValue": "Unlocked",
                        "matchCount": 23959,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CNetwork%3A%7BUnlocked%7D"
                    },
                    {
                        "localizedAspectValue": "Bell Mobility",
                        "matchCount": 73,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CNetwork%3A%7BBell+Mobility%7D"
                    },
                    {
                        "localizedAspectValue": "Boost Mobile",
                        "matchCount": 581,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CNetwork%3A%7BBoost+Mobile%7D"
                    },
                    {
                        "localizedAspectValue": "Cricket",
                        "matchCount": 379,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CNetwork%3A%7BCricket%7D"
                    },
                    {
                        "localizedAspectValue": "Fido",
                        "matchCount": 24,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CNetwork%3A%7BFido%7D"
                    },
                    {
                        "localizedAspectValue": "MetroPCS",
                        "matchCount": 198,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CNetwork%3A%7BMetroPCS%7D"
                    },
                    {
                        "localizedAspectValue": "Rogers Wireless",
                        "matchCount": 74,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CNetwork%3A%7BRogers+Wireless%7D"
                    },
                    {
                        "localizedAspectValue": "SaskTel",
                        "matchCount": 41,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CNetwork%3A%7BSaskTel%7D"
                    },
                    {
                        "localizedAspectValue": "Straight Talk",
                        "matchCount": 751,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CNetwork%3A%7BStraight+Talk%7D"
                    },
                    {
                        "localizedAspectValue": "Telus",
                        "matchCount": 103,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CNetwork%3A%7BTelus%7D"
                    },
                    {
                        "localizedAspectValue": "TracFone",
                        "matchCount": 390,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CNetwork%3A%7BTracFone%7D"
                    },
                    {
                        "localizedAspectValue": "U.S. Cellular",
                        "matchCount": 247,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CNetwork%3A%7BU.S.+Cellular%7D"
                    },
                    {
                        "localizedAspectValue": "Videotron",
                        "matchCount": 25,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CNetwork%3A%7BVideotron%7D"
                    },
                    {
                        "localizedAspectValue": "Virgin Mobile",
                        "matchCount": 162,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CNetwork%3A%7BVirgin+Mobile%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 22,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CNetwork%3A%7BNot+Specified%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Model",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "iPhone 6s",
                        "matchCount": 9211,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel%3A%7BiPhone+6s%7D"
                    },
                    {
                        "localizedAspectValue": "iPhone 6",
                        "matchCount": 11677,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel%3A%7BiPhone+6%7D"
                    },
                    {
                        "localizedAspectValue": "iPhone 7",
                        "matchCount": 5678,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel%3A%7BiPhone+7%7D"
                    },
                    {
                        "localizedAspectValue": "iPhone 7 Plus",
                        "matchCount": 4216,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel%3A%7BiPhone+7+Plus%7D"
                    },
                    {
                        "localizedAspectValue": "iPhone 6s Plus",
                        "matchCount": 5022,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel%3A%7BiPhone+6s+Plus%7D"
                    },
                    {
                        "localizedAspectValue": "iPhone SE",
                        "matchCount": 3260,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel%3A%7BiPhone+SE%7D"
                    },
                    {
                        "localizedAspectValue": "iPhone X",
                        "matchCount": 1070,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel%3A%7BiPhone+X%7D"
                    },
                    {
                        "localizedAspectValue": "iPhone 6 Plus",
                        "matchCount": 6532,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel%3A%7BiPhone+6+Plus%7D"
                    },
                    {
                        "localizedAspectValue": "iPhone 8 Plus",
                        "matchCount": 813,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel%3A%7BiPhone+8+Plus%7D"
                    },
                    {
                        "localizedAspectValue": "iPhone 5s",
                        "matchCount": 5547,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel%3A%7BiPhone+5s%7D"
                    },
                    {
                        "localizedAspectValue": "iPhone 5c",
                        "matchCount": 2858,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel%3A%7BiPhone+5c%7D"
                    },
                    {
                        "localizedAspectValue": "iPhone 4s",
                        "matchCount": 2285,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel%3A%7BiPhone+4s%7D"
                    },
                    {
                        "localizedAspectValue": "iPhone 5",
                        "matchCount": 2205,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel%3A%7BiPhone+5%7D"
                    },
                    {
                        "localizedAspectValue": "iPhone 4",
                        "matchCount": 2060,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel%3A%7BiPhone+4%7D"
                    },
                    {
                        "localizedAspectValue": "iPhone 8",
                        "matchCount": 613,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel%3A%7BiPhone+8%7D"
                    },
                    {
                        "localizedAspectValue": "iPhone 3GS",
                        "matchCount": 488,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel%3A%7BiPhone+3GS%7D"
                    },
                    {
                        "localizedAspectValue": "iPhone 3G",
                        "matchCount": 264,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel%3A%7BiPhone+3G%7D"
                    },
                    {
                        "localizedAspectValue": "iPhone 1st Generation",
                        "matchCount": 168,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel%3A%7BiPhone+1st+Generation%7D"
                    },
                    {
                        "localizedAspectValue": "HTC One",
                        "matchCount": 1,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel%3A%7BHTC+One%7D"
                    },
                    {
                        "localizedAspectValue": "Samsung Galaxy S5",
                        "matchCount": 1,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel%3A%7BSamsung+Galaxy+S5%7D"
                    },
                    {
                        "localizedAspectValue": "Sony Ericsson Xperia X10 mini",
                        "matchCount": 1,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel%3A%7BSony+Ericsson+Xperia+X10+mini%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 11,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel%3A%7BNot+Specified%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Storage Capacity",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "256GB",
                        "matchCount": 2879,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CStorage+Capacity%3A%7B256GB%7D"
                    },
                    {
                        "localizedAspectValue": "128GB",
                        "matchCount": 9387,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CStorage+Capacity%3A%7B128GB%7D"
                    },
                    {
                        "localizedAspectValue": "64GB",
                        "matchCount": 14766,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CStorage+Capacity%3A%7B64GB%7D"
                    },
                    {
                        "localizedAspectValue": "32GB",
                        "matchCount": 8868,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CStorage+Capacity%3A%7B32GB%7D"
                    },
                    {
                        "localizedAspectValue": "16GB",
                        "matchCount": 24938,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CStorage+Capacity%3A%7B16GB%7D"
                    },
                    {
                        "localizedAspectValue": "8GB",
                        "matchCount": 3113,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CStorage+Capacity%3A%7B8GB%7D"
                    },
                    {
                        "localizedAspectValue": "4GB",
                        "matchCount": 17,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CStorage+Capacity%3A%7B4GB%7D"
                    },
                    {
                        "localizedAspectValue": "1GB",
                        "matchCount": 1,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CStorage+Capacity%3A%7B1GB%7D"
                    },
                    {
                        "localizedAspectValue": "512MB",
                        "matchCount": 1,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CStorage+Capacity%3A%7B512MB%7D"
                    },
                    {
                        "localizedAspectValue": "128MB",
                        "matchCount": 2,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CStorage+Capacity%3A%7B128MB%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 9,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CStorage+Capacity%3A%7BNot+Specified%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Color",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "Black",
                        "matchCount": 10434,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CColor%3A%7BBlack%7D"
                    },
                    {
                        "localizedAspectValue": "Gold",
                        "matchCount": 12103,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CColor%3A%7BGold%7D"
                    },
                    {
                        "localizedAspectValue": "Gray",
                        "matchCount": 17350,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CColor%3A%7BGray%7D"
                    },
                    {
                        "localizedAspectValue": "Red",
                        "matchCount": 441,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CColor%3A%7BRed%7D"
                    },
                    {
                        "localizedAspectValue": "Rose Gold",
                        "matchCount": 6495,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CColor%3A%7BRose+Gold%7D"
                    },
                    {
                        "localizedAspectValue": "Silver",
                        "matchCount": 11851,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CColor%3A%7BSilver%7D"
                    },
                    {
                        "localizedAspectValue": "White",
                        "matchCount": 3438,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CColor%3A%7BWhite%7D"
                    },
                    {
                        "localizedAspectValue": "Blue",
                        "matchCount": 689,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CColor%3A%7BBlue%7D"
                    },
                    {
                        "localizedAspectValue": "Green",
                        "matchCount": 387,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CColor%3A%7BGreen%7D"
                    },
                    {
                        "localizedAspectValue": "Pink",
                        "matchCount": 490,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CColor%3A%7BPink%7D"
                    },
                    {
                        "localizedAspectValue": "Yellow",
                        "matchCount": 296,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CColor%3A%7BYellow%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 7,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CColor%3A%7BNot+Specified%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Model Number",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "A1522 (GSM Only)",
                        "matchCount": 2756,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1522+%28GSM+Only%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1533 (GSM Only)",
                        "matchCount": 3334,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1533+%28GSM+Only%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1549 (GSM Only)",
                        "matchCount": 4771,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1549+%28GSM+Only%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1586 (CDMA + GSM)",
                        "matchCount": 4196,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1586+%28CDMA+%2B+GSM%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1633 (CDMA + GSM)",
                        "matchCount": 4520,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1633+%28CDMA+%2B+GSM%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1687 (CDMA + GSM)",
                        "matchCount": 2885,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1687+%28CDMA+%2B+GSM%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1688 (CDMA + GSM)",
                        "matchCount": 4693,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1688+%28CDMA+%2B+GSM%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1778 (GSM Only)",
                        "matchCount": 3167,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1778+%28GSM+Only%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1203 (GSM Only)",
                        "matchCount": 168,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1203+%28GSM+Only%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1241 (GSM Only)",
                        "matchCount": 264,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1241+%28GSM+Only%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1303 (GSM Only)",
                        "matchCount": 492,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1303+%28GSM+Only%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1332 (GSM Only)",
                        "matchCount": 729,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1332+%28GSM+Only%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1349 (CDMA Only)",
                        "matchCount": 1326,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1349+%28CDMA+Only%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1387 (CDMA + GSM)",
                        "matchCount": 2280,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1387+%28CDMA+%2B+GSM%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1428 (GSM Only)",
                        "matchCount": 1430,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1428+%28GSM+Only%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1429 (CDMA + GSM)",
                        "matchCount": 773,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1429+%28CDMA+%2B+GSM%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1429 (GSM Only)",
                        "matchCount": 3,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1429+%28GSM+Only%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1453 (CDMA + GSM)",
                        "matchCount": 668,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1453+%28CDMA+%2B+GSM%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1456 (CDMA + GSM)",
                        "matchCount": 607,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1456+%28CDMA+%2B+GSM%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1457 (GSM Only)",
                        "matchCount": 17,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1457+%28GSM+Only%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1507 (GSM Only)",
                        "matchCount": 3,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1507+%28GSM+Only%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1522 (CDMA + GSM)",
                        "matchCount": 1106,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1522+%28CDMA+%2B+GSM%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1524 (CDMA + GSM)",
                        "matchCount": 2667,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1524+%28CDMA+%2B+GSM%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1532 (CDMA + GSM)",
                        "matchCount": 793,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1532+%28CDMA+%2B+GSM%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1532 (GSM Only)",
                        "matchCount": 1455,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1532+%28GSM+Only%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1533 (CDMA + GSM)",
                        "matchCount": 1317,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1533+%28CDMA+%2B+GSM%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1549 (CDMA + GSM)",
                        "matchCount": 2588,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1549+%28CDMA+%2B+GSM%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1634 (CDMA + GSM)",
                        "matchCount": 2137,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1634+%28CDMA+%2B+GSM%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1660 (CDMA + GSM)",
                        "matchCount": 2511,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1660+%28CDMA+%2B+GSM%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1661 (CDMA + GSM)",
                        "matchCount": 2068,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1661+%28CDMA+%2B+GSM%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1662 (CDMA + GSM)",
                        "matchCount": 2565,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1662+%28CDMA+%2B+GSM%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1723 (CDMA + GSM)",
                        "matchCount": 693,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1723+%28CDMA+%2B+GSM%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1784 (GSM Only)",
                        "matchCount": 2150,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1784+%28GSM+Only%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1863 (CDMA + GSM)",
                        "matchCount": 234,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1863+%28CDMA+%2B+GSM%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1864 (CDMA + GSM)",
                        "matchCount": 343,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1864+%28CDMA+%2B+GSM%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1865 (CDMA + GSM)",
                        "matchCount": 441,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1865+%28CDMA+%2B+GSM%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1897 (GSM Only)",
                        "matchCount": 470,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1897+%28GSM+Only%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1901 (GSM Only)",
                        "matchCount": 629,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1901+%28GSM+Only%29%7D"
                    },
                    {
                        "localizedAspectValue": "A1905 (GSM Only)",
                        "matchCount": 379,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BA1905+%28GSM+Only%29%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 353,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CModel+Number%3A%7BNot+Specified%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Processor",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "Single Core",
                        "matchCount": 2935,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CProcessor%3A%7BSingle+Core%7D"
                    },
                    {
                        "localizedAspectValue": "Dual Core",
                        "matchCount": 48576,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CProcessor%3A%7BDual+Core%7D"
                    },
                    {
                        "localizedAspectValue": "Quad Core",
                        "matchCount": 9874,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CProcessor%3A%7BQuad+Core%7D"
                    },
                    {
                        "localizedAspectValue": "Hexa Core",
                        "matchCount": 2494,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CProcessor%3A%7BHexa+Core%7D"
                    },
                    {
                        "localizedAspectValue": "Quad+Quad Core",
                        "matchCount": 1,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CProcessor%3A%7BQuad%2BQuad+Core%7D"
                    },
                    {
                        "localizedAspectValue": "Octa Core",
                        "matchCount": 1,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CProcessor%3A%7BOcta+Core%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 100,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CProcessor%3A%7BNot+Specified%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Bundle Listing",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "No",
                        "matchCount": 30698,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CBundle+Listing%3A%7BNo%7D"
                    },
                    {
                        "localizedAspectValue": "Yes",
                        "matchCount": 4516,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CBundle+Listing%3A%7BYes%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 28767,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CBundle+Listing%3A%7BNot+Specified%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Camera Resolution",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "8.0 - 11.9MP",
                        "matchCount": 99,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CCamera+Resolution%3A%7B8.0+-+11.9MP%7D"
                    },
                    {
                        "localizedAspectValue": "12.0 - 15.9MP",
                        "matchCount": 59,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CCamera+Resolution%3A%7B12.0+-+15.9MP%7D"
                    },
                    {
                        "localizedAspectValue": "2.0 - 4.9MP",
                        "matchCount": 15,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CCamera+Resolution%3A%7B2.0+-+4.9MP%7D"
                    },
                    {
                        "localizedAspectValue": "5.0 - 7.9MP",
                        "matchCount": 16,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CCamera+Resolution%3A%7B5.0+-+7.9MP%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 40,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CCamera+Resolution%3A%7BNot+Specified%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Brand",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "BlackBerry",
                        "matchCount": 1,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CBrand%3A%7BBlackBerry%7D"
                    },
                    {
                        "localizedAspectValue": "Apple",
                        "matchCount": 63975,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CBrand%3A%7BApple%7D"
                    },
                    {
                        "localizedAspectValue": "Casio",
                        "matchCount": 1,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CBrand%3A%7BCasio%7D"
                    },
                    {
                        "localizedAspectValue": "HTC",
                        "matchCount": 1,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CBrand%3A%7BHTC%7D"
                    },
                    {
                        "localizedAspectValue": "LG",
                        "matchCount": 1,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CBrand%3A%7BLG%7D"
                    },
                    {
                        "localizedAspectValue": "Samsung",
                        "matchCount": 1,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CBrand%3A%7BSamsung%7D"
                    },
                    {
                        "localizedAspectValue": "Sony Ericsson",
                        "matchCount": 1,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CBrand%3A%7BSony+Ericsson%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Operating System",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "Android",
                        "matchCount": 108,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2COperating+System%3A%7BAndroid%7D"
                    },
                    {
                        "localizedAspectValue": "iOS",
                        "matchCount": 63402,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2COperating+System%3A%7BiOS%7D"
                    },
                    {
                        "localizedAspectValue": "Aliyun OS",
                        "matchCount": 1,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2COperating+System%3A%7BAliyun+OS%7D"
                    },
                    {
                        "localizedAspectValue": "Fire OS",
                        "matchCount": 1,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2COperating+System%3A%7BFire+OS%7D"
                    },
                    {
                        "localizedAspectValue": "Windows Phone 7",
                        "matchCount": 3,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2COperating+System%3A%7BWindows+Phone+7%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 466,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2COperating+System%3A%7BNot+Specified%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Style",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "Bar",
                        "matchCount": 63927,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CStyle%3A%7BBar%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 26,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CStyle%3A%7BNot+Specified%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Contract",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "Prepaid",
                        "matchCount": 509,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CContract%3A%7BPrepaid%7D"
                    },
                    {
                        "localizedAspectValue": "Without Contract",
                        "matchCount": 27486,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CContract%3A%7BWithout+Contract%7D"
                    },
                    {
                        "localizedAspectValue": "With Contract",
                        "matchCount": 213,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CContract%3A%7BWith+Contract%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 35773,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CContract%3A%7BNot+Specified%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Screen Size",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "3.9\" & Under",
                        "matchCount": 58,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CScreen+Size%3A%7B3.9%22+%26+Under%7D"
                    },
                    {
                        "localizedAspectValue": "4.5-4.9\"",
                        "matchCount": 56,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CScreen+Size%3A%7B4.5-4.9%22%7D"
                    },
                    {
                        "localizedAspectValue": "4.0-4.4\"",
                        "matchCount": 55,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CScreen+Size%3A%7B4.0-4.4%22%7D"
                    },
                    {
                        "localizedAspectValue": "5.5-5.9\"",
                        "matchCount": 27,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CScreen+Size%3A%7B5.5-5.9%22%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 37,
                        "refinementHref": "https://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A9355%2CScreen+Size%3A%7BNot+Specified%7D"
                    }
                ]
            }
        ],
        "dominantCategoryId": "9355"
    }
}

Sample 4: Search for Products Based on a Keyword and Filtered by Aspect

This call searches the catalog for the iphone keyword, and filters the results for the Color aspect value of Black.

Input

The inputs are the query parameters q, which is the keyword, aspect_filter, fieldgroups, and limit. There is no payload with this request.

GEThttps://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q=iphone&aspect_filter=categoryId%3A9355%2CColor%3A%7BBlack%7D&fieldgroups=MATCHING_PRODUCTS&limit=3

Output

If the call is successful, 3 iPhone product summaries in the color Black will be returned in the result set.

{
    "productSummaries": [
        {
            "epid": "225209639",
            "gtin": [
                "0190198071798",
                "0400055803586"
            ],
            "brand": "Apple",
            "mpn": [
                "MN9D2LL/A"
            ],
            "image": {
                "imageUrl": "https://i.ebayimg.com/00/s/NjgwWDU5Ng==/z/eRcAAOSwLF1X454V/$_6.JPG?set_id=89040003C1"
            },
            "additionalImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/MTYwMFg4MDA=/z/l58AAOSw-YVXmbwB/$_6.JPG?set_id=89040003C1"
                }
            ],
            "aspects": [
                {
                    "localizedName": "Brand",
                    "localizedValues": [
                        "Apple"
                    ]
                },
                {
                    "localizedName": "MPN",
                    "localizedValues": [
                        "MN9D2LLA"
                    ]
                },
                {
                    "localizedName": "Processor",
                    "localizedValues": [
                        "Quad Core"
                    ]
                },
                {
                    "localizedName": "Color",
                    "localizedValues": [
                        "Black"
                    ]
                },
                {
                    "localizedName": "Network",
                    "localizedValues": [
                        "AT&T"
                    ]
                },
                {
                    "localizedName": "Storage Capacity",
                    "localizedValues": [
                        "32GB"
                    ]
                },
                {
                    "localizedName": "Screen Size",
                    "localizedValues": [
                        "4.7\""
                    ]
                },
                {
                    "localizedName": "Style",
                    "localizedValues": [
                        "Bar"
                    ]
                },
                {
                    "localizedName": "Camera Resolution",
                    "localizedValues": [
                        "12.0MP"
                    ]
                },
                {
                    "localizedName": "Model",
                    "localizedValues": [
                        "Apple iPhone 7"
                    ]
                },
                {
                    "localizedName": "Memory Card Type",
                    "localizedValues": [
                        "Built-In Memory"
                    ]
                },
                {
                    "localizedName": "Model Number",
                    "localizedValues": [
                        "A1778 (GSM Only)"
                    ]
                }
            ],
            "ean": [
                "0190198071798",
                "0400055803586"
            ],
            "upc": [
                "0190198071798",
                "0400055803586"
            ],
            "productHref": "https://api.ebay.com/commerce/catalog/v1_beta/product/225209639",
            "title": "Apple iPhone 7 - 32GB - Black (AT&T) A1778 (GSM)",
            "productWebUrl": "https://www.ebay.com/p/Apple-iPhone-7-32GB-Black-AT-T-A1778-GSM/225209639"
        },
        {
            "epid": "224725522",
            "gtin": [
                "0190198072214"
            ],
            "brand": "Apple",
            "mpn": [
                "MNAY2LL/A"
            ],
            "image": {
                "imageUrl": "https://i.ebayimg.com/00/s/NjgwWDU5Ng==/z/eRcAAOSwLF1X454V/$_6.JPG?set_id=89040003C1"
            },
            "additionalImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/MTYwMFg4MDA=/z/l58AAOSw-YVXmbwB/$_6.JPG?set_id=89040003C1"
                }
            ],
            "aspects": [
                {
                    "localizedName": "Brand",
                    "localizedValues": [
                        "Apple"
                    ]
                },
                {
                    "localizedName": "MPN",
                    "localizedValues": [
                        "MNAY2LLA"
                    ]
                },
                {
                    "localizedName": "Processor",
                    "localizedValues": [
                        "Quad Core"
                    ]
                },
                {
                    "localizedName": "Color",
                    "localizedValues": [
                        "Black"
                    ]
                },
                {
                    "localizedName": "Network",
                    "localizedValues": [
                        "Sprint"
                    ]
                },
                {
                    "localizedName": "Storage Capacity",
                    "localizedValues": [
                        "32GB"
                    ]
                },
                {
                    "localizedName": "Screen Size",
                    "localizedValues": [
                        "4.7\""
                    ]
                },
                {
                    "localizedName": "Style",
                    "localizedValues": [
                        "Bar"
                    ]
                },
                {
                    "localizedName": "Camera Resolution",
                    "localizedValues": [
                        "12.0MP"
                    ]
                },
                {
                    "localizedName": "Model",
                    "localizedValues": [
                        "Apple iPhone 7"
                    ]
                },
                {
                    "localizedName": "Memory Card Type",
                    "localizedValues": [
                        "Built-In Memory"
                    ]
                },
                {
                    "localizedName": "Bundle Listing",
                    "localizedValues": [
                        "No"
                    ]
                },
                {
                    "localizedName": "Model Number",
                    "localizedValues": [
                        "A1660 (CDMA + GSM)"
                    ]
                }
            ],
            "ean": [
                "0190198072214"
            ],
            "upc": [
                "0190198072214"
            ],
            "productHref": "https://api.ebay.com/commerce/catalog/v1_beta/product/224725522",
            "title": "Apple iPhone 7 - 32GB - Black (Sprint) A1660 (CDMA + GSM)",
            "productWebUrl": "https://www.ebay.com/p/Apple-iPhone-7-32GB-Black-Sprint-A1660-CDMA-GSM/224725522"
        },
        {
            "epid": "225208146",
            "gtin": [
                "0190198071934"
            ],
            "brand": "Apple",
            "mpn": [
                "MN9U2LL/A"
            ],
            "image": {
                "imageUrl": "https://i.ebayimg.com/00/s/NjgwWDU5Ng==/z/eRcAAOSwLF1X454V/$_6.JPG?set_id=89040003C1"
            },
            "additionalImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/MTYwMFg4MDA=/z/l58AAOSw-YVXmbwB/$_6.JPG?set_id=89040003C1"
                }
            ],
            "aspects": [
                {
                    "localizedName": "Brand",
                    "localizedValues": [
                        "Apple"
                    ]
                },
                {
                    "localizedName": "MPN",
                    "localizedValues": [
                        "MN9U2LLA"
                    ]
                },
                {
                    "localizedName": "Processor",
                    "localizedValues": [
                        "Quad Core"
                    ]
                },
                {
                    "localizedName": "Color",
                    "localizedValues": [
                        "Black"
                    ]
                },
                {
                    "localizedName": "Network",
                    "localizedValues": [
                        "T-Mobile"
                    ]
                },
                {
                    "localizedName": "Storage Capacity",
                    "localizedValues": [
                        "32GB"
                    ]
                },
                {
                    "localizedName": "Screen Size",
                    "localizedValues": [
                        "4.7\""
                    ]
                },
                {
                    "localizedName": "Style",
                    "localizedValues": [
                        "Bar"
                    ]
                },
                {
                    "localizedName": "Camera Resolution",
                    "localizedValues": [
                        "12.0MP"
                    ]
                },
                {
                    "localizedName": "Model",
                    "localizedValues": [
                        "Apple iPhone 7"
                    ]
                },
                {
                    "localizedName": "Memory Card Type",
                    "localizedValues": [
                        "Built-In Memory"
                    ]
                },
                {
                    "localizedName": "Model Number",
                    "localizedValues": [
                        "A1778 (GSM Only)"
                    ]
                }
            ],
            "ean": [
                "0190198071934"
            ],
            "upc": [
                "0190198071934"
            ],
            "productHref": "https://api.ebay.com/commerce/catalog/v1_beta/product/225208146",
            "title": "Apple iPhone 7 - 32GB - Black (T-Mobile) A1778 (GSM)",
            "productWebUrl": "https://www.ebay.com/p/Apple-iPhone-7-32GB-Black-T-Mobile-A1778-GSM/225208146"
        }
    ],
    "limit": 3
}

Sample 5: Search for Products Based on a GTIN

This call searches the catalog for the gtin value of 0813917020203. Based on the results of that search, it returns all product summaries of the product identified by the provided GTIN.

Input

The input is the gtin query parameter. There is no payload with this request.

GEThttp://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?gtin=0813917020203

Output

If the call is successful, the product summaries for the item identified by the specified GTIN (NEST thermostat model T3017US) will be returned in the result set.

{
    "productSummaries": [
        {
            "epid": "241111787",
            "gtin": [
                "0642892801039",
                "0813917020203"
            ],
            "brand": "Nest",
            "mpn": [
                "T3017US"
            ],
            "image": {
                "imageUrl": "https://i.ebayimg.com/00/s/MTUwMFgxNTAw/z/sLoAAOSw5KtaaHY5/$_6.JPG?set_id=89040003C1"
            },
            "aspects": [
                {
                    "localizedName": "Brand",
                    "localizedValues": [
                        "Nest"
                    ]
                },
                {
                    "localizedName": "Model",
                    "localizedValues": [
                        "Nest Learning Thermostat (3rd Generation)"
                    ]
                },
                {
                    "localizedName": "MPN",
                    "localizedValues": [
                        "T3017US"
                    ]
                },
                {
                    "localizedName": "User Interface",
                    "localizedValues": [
                        "Digital"
                    ]
                },
                {
                    "localizedName": "Connected Home Compatibility",
                    "localizedValues": [
                        "Nest"
                    ]
                },
                {
                    "localizedName": "Connected Home Protocol",
                    "localizedValues": [
                        "Wi-Fi"
                    ]
                },
                {
                    "localizedName": "Color",
                    "localizedValues": [
                        "White"
                    ]
                }
            ],
            "ean": [
                "0642892801039",
                "0813917020203"
            ],
            "upc": [
                "0642892801039",
                "0813917020203"
            ],
            "productHref": "https://api.ebay.com/commerce/catalog/v1_beta/product/241111787",
            "title": "Nest 3rd Generation Learning White Programmable Thermostat"
        },
        {
            "epid": "241104405",
            "gtin": [
                "0813917020203"
            ],
            "brand": "Nest",
            "mpn": [
                "T3017US_2PK"
            ],
            "image": {
                "imageUrl": "https://i.ebayimg.com/00/s/MjU5WDUwMA==/z/aFUAAOSwIVhaLp6e/$_6.JPG?set_id=89040003C1"
            },
            "aspects": [
                {
                    "localizedName": "Brand",
                    "localizedValues": [
                        "Nest"
                    ]
                },
                {
                    "localizedName": "Model",
                    "localizedValues": [
                        "Nest Learning Thermostat (3rd Generation)"
                    ]
                },
                {
                    "localizedName": "MPN",
                    "localizedValues": [
                        "T3017US2PK"
                    ]
                },
                {
                    "localizedName": "User Interface",
                    "localizedValues": [
                        "Digital"
                    ]
                },
                {
                    "localizedName": "Connected Home Compatibility",
                    "localizedValues": [
                        "Nest"
                    ]
                },
                {
                    "localizedName": "Connected Home Protocol",
                    "localizedValues": [
                        "Wi-Fi"
                    ]
                },
                {
                    "localizedName": "Color",
                    "localizedValues": [
                        "White"
                    ]
                }
            ],
            "ean": [
                "0813917020203"
            ],
            "upc": [
                "0813917020203"
            ],
            "productHref": "https://api.ebay.com/commerce/catalog/v1_beta/product/241104405",
            "title": "Nest 3rd Generation Learning White Programmable Thermostat 2 Pack"
        }
    ],
    "limit": 50
}

Sample 6: Search for Products Based on an MPN

This call searches the catalog for the mpn value of 3710RW. Based on the results of that search, it returns all product summaries of the product identified by the provided MPN.

Input

The input is the mpn query parameter. There is no payload with this request.

GEThttp://api.ebay.com/commerce/catalog/v1_beta/product_summary/search?mpn=3710RW

Output

If the call is successful, the product summaries for the item identified by the specified MPN (Roku media streamer model 3710RW) will be returned in the result set.

{
    "productSummaries": [
        {
            "epid": "241986095",
            "gtin": [
                "0829610001272"
            ],
            "brand": "Roku",
            "mpn": [
                "3710RW"
            ],
            "image": {
                "imageUrl": "https://i.ebayimg.com/00/s/MjgwWDcyNw==/z/Mr4AAOSw3EVaaHZV/$_6.JPG?set_id=89040003C1"
            },
            "aspects": [
                {
                    "localizedName": "Brand",
                    "localizedValues": [
                        "Roku"
                    ]
                },
                {
                    "localizedName": "Model",
                    "localizedValues": [
                        "Roku Express+ 3710"
                    ]
                },
                {
                    "localizedName": "MPN",
                    "localizedValues": [
                        "3710RW"
                    ]
                },
                {
                    "localizedName": "Media Streaming",
                    "localizedValues": [
                        "Home Network Media"
                    ]
                },
                {
                    "localizedName": "Features",
                    "localizedValues": [
                        "Picture Viewing"
                    ]
                },
                {
                    "localizedName": "Max. Resolution",
                    "localizedValues": [
                        "1080p"
                    ]
                },
                {
                    "localizedName": "Media Input Connectivity",
                    "localizedValues": [
                        "HDMI",
                        "USB",
                        "Wi-Fi"
                    ]
                },
                {
                    "localizedName": "Audio/Video Outputs",
                    "localizedValues": [
                        "Composite Video RCA",
                        "HDMI"
                    ]
                },
                {
                    "localizedName": "Color",
                    "localizedValues": [
                        "Black"
                    ]
                }
            ],
            "ean": [
                "0829610001272"
            ],
            "upc": [
                "0829610001272"
            ],
            "productHref": "https://api.ebay.com/commerce/catalog/v1_beta/product/241986095",
            "title": "Roku Express+ (5th Generation) media streamer (3710RW)"
        }
    ],
    "limit": 50
}