search: eBay Browse API | eBay Developers Program

GET/item_summary/search

This method searches for eBay items by various query parameters and retrieves summaries of the items. You can search by keyword, category, eBay product ID (ePID), or GTIN, charity ID, or a combination of these.

Note: Only listings where FIXED_PRICE (Buy It Now) is a buying option are returned by default. To retrieve listings that do not have FIXED_PRICE as a buying option, the buyingOptions filter can be used to retrieve those listings.

Note that an auction listing enabled with the Buy it Now feature will initially show AUCTION and FIXED_PRICE as buying options, but if/when that auction listing receives a qualifying bid, only AUCTION remains as a buying option. If this happens, the buyingOptions filter would need to be used to retrieve that auction listing.
This method also supports the following:

Filtering by the value of one or multiple fields, such as listing format, item condition, price range, location, and more. For the fields supported by this method, refer to the filter parameter.
Retrieving the refinements (metadata) of an item, such as item aspects (color, brand) condition, category, etc. using the fieldgroups parameter.
Filtering by item aspects and other refinements using the aspect_filter parameter.
Filtering for items that are compatible with a specific product, using the compatibility_filter parameter.
Creating aspects histograms, which enables shoppers to drill down in each refinement narrowing the search results.

For additional information and examples of these capabilities, refer to Browse API in the Buying Integration Guide.

Pagination and sort controls

There are pagination controls (limit and offset fields) and sort query parameters that control/sort the data that are returned. By default, results are sorted by Best Match. For more information about Best Match, refer to Best Match.

Restrictions

This method can return a maximum of 10,000 items. For a list of supported sites and other restrictions, refer to API Restrictions.

eBay Partner Network: In order to receive a commission for your sales, you must use the URL returned in the itemAffiliateWebUrl field to forward your buyer to the ebay.com site.

Input

Resource URI

GET https://api.ebay.com/buy/browse/v1/item_summary/search?

q=string&

gtin=string&

charity_ids=string&

fieldgroups=string&

compatibility_filter=CompatibilityFilter&

aspect_filter=AspectFilter&

epid=string&

This method is supported in Sandbox environment. To access the endpoint, just replace the api.ebay.com root URI with api.sandbox.ebay.com

URI parameters

Parameter	Type	Description
q	string	A string consisting of one or more keywords used to search for items on eBay. Note: The `` wildcard character is not* allowed in this field. When providing two or more keywords in a single query, the string is processed as follows: When successive keywords are separated by a space, the list of keywords is processed as an `AND` request. For example, to retrieve items that include both of the keywords iphone AND ipad, submit the following query: /buy/browse/v1/item_summary/search?q=iphone ipad When successive keywords are comma-separated and surrounded by a single pair of parentheses, OR if the keywords are each URL-encoded, the list of keywords is processed as an `OR` request. For example, to retrieve items that include iphone OR ipad, submit one of the following queries: /buy/browse/v1/item_summary/search?q=(iphone, ipad) /buy/browse/v1/item_summary/search?q=%28iphone%2c%20ipad%29 Note: When specifying keywords using the `q` parameter, do not include an `epid` or `gtin` parameter value as neither can be used in conjuction with a keyword search. Occurrence: Conditional
gtin	string	This field lets you search by the Global Trade Item Number of an item as defined by https://www.gtin.info. For example: /buy/browse/v1/item_summary/search?gtin=099482432621 Note: You can search only by UPC (Universal Product Code). To search using another GTIN format, you must search by keyword.Note: When constructing a query, `gtin` may be combined with an `epid` value. However, do not specify keywords using the `q` parameter — keywords cannot be used in conjunction with `gtin`. Occurrence: Conditional
charity_ids	array of string	The charity ID filters results to return only those items associated with the specified charity. Note: `charity_ids` is only supported by the US and UK marketplaces. Charity ID is a charity's unique identification number: In the US, this is the Employer Identification Number (EIN). In the UK, this is the Charity Registration Number (CRN), commonly called Charity Number. `charity_ids` may be retrieved/determined as follows: Search for a supported charity using the Charity API's getCharityOrgs method. Important! The value to be passed in as `charity_ids` is that returned in the `registrationId` field. Search for a supported charity by visiting Charity Search. Click on the charity's name to display its information. The EIN number is included in the charity's information block at the top of the page. For example, the charity ID for American Red Cross, is `530196605`. Up to 20 comma-separated `charity_ids` may be specified in each query. Additionally, `charity_ids` may be combined with `category_ids` and/or `q` keyword values to further filter returned results. A sample query using `charity_ids` is: /buy/browse/v1/item_summary/search?charity_ids=13-1788491,300108469 Occurrence: Optional
fieldgroups	array of string	A comma-separated list of values that controls what is returned in the response. The default is `MATCHING_ITEMS`, which returns the items that match the keyword or category specified. The other values return data that can be used to create histograms or provide additional information. Valid Values: `ASPECT_REFINEMENTS` This field group adds the aspectDistributions container to the response. Note: Information returned by `ASPECT_REFINEMENTS` is category specific. `BUYING_OPTION_REFINEMENTS` This field group adds the buyingOptionDistributions container to the response. `CATEGORY_REFINEMENTS` This field group adds the categoryDistributions container to the response. `CONDITION_REFINEMENTS` This field group adds the conditionDistributions containers, such as `NEW`, `USED`, etc., to the response. Within these groups are multiple states of the condition. For example, `NEW` can be New without tag, New in box, New without box, etc. `EXTENDED` This field group adds the following fields to the response: shortDescription itemLocation.city `MATCHING_ITEMS` (default value) This field group is intended to be used with one or more of the refinement values listed above. This is used to return the specified refinements and all matching items. `FULL` This field group returns all refinement containers and all matching items. Default: `MATCHING_ITEMS` Occurrence: Optional
compatibility_filter	CompatibilityFilter	This field specifies the attributes used to define a specific product. The service searches for items matching the keyword, or matching the keyword and a product attribute value in the title of the item. Note: The only products supported are cars, trucks, and motorcycles. For example, if the keyword is `brakes` and `compatibility-filter=Year:2018;Make:BMW`, the items returned are items with brakes, 2018, or BMW in the title. The service uses the product attributes to determine whether the item is compatible. The service returns the attributes that are compatible and the CompatibilityMatchEnum value that indicates how well the item matches the attributes. Tip: Refer to the Samples section for a detailed example. Best Practice: Submit all of the product attributes for the specific product. To find the attributes and values for a specific marketplace, use the getCompatibilityProperties method in the Taxonomy API. For more information, refer to Check compatibility in the Buying Integration Guide. Note: Testing in Sandbox is only supported using mock data. Refer to Testing search in the Sandbox for details. Required: `q` (keyword) One parts-compatibility-supported category ID (such as `33559` Brakes) At least one vehicle attribute name/value pair Occurrence: Optional
auto_correct	array of string	A query parameter that enables auto correction. A sample is shown below: /buy/browse/v1/item_summary/search?auto_correct=KEYWORD Note: Auto correction is currently supported in the following marketplaces: United States Austria Australia Canada Switzerland Germany Spain France United Kingdom Ireland Italy Valid Values: `KEYWORD` Occurrence: Optional
category_ids	array of string	The category ID is used to limit the results that are returned. This field may pass in one category ID or a comma separated list of IDs as illustrated in the following examples: /buy/browse/v1/item_summary/search?category_ids=29792 /buy/browse/v1/item_summary/search?category_ids=267,29792 Note: Currently, you can pass in only one category ID per request. To refine the set of information that is returned, `category_ids` may be combined with EITHER: `epid` and/or `gtin` values `q` keywords For example, when looking of a toy phone, simply searching for "phone" will return mobile phones because that is the "Best Match" for the search. To further refine the request to include toy phones, include the Toys & Hobbies category ID as illustrated here: /buy/browse/v1/item_summary/search?q=phone&category_ids=220 Because the list of eBay category IDs is not published and category IDs are not the same across all eBay marketplaces, category IDs may be determined by: Visiting the Category Changes page Using the Taxonomy API. Refer to Get Categories for Buy APIs for complete information. Issuing the following call to retrieve the `dominantCategoryId` for an item: /buy/browse/v1/item_summary/search?q= keyword&fieldgroups=ASPECT_REFINEMENTS Note: If a top-level (L1) category is specified, you must also include a `q` query parameter. Occurrence: Optional
filter	array of FilterField	An array of field filters that can be used to limit/customize the result set. Refer to Buy API Field Filters for additional information and examples of all supported filters. For example, to filter shirts based on a specific range of prices, include the filter illustrated here: /buy/browse/v1/item_summary/search?q=shirt&filter=price:[10..50] Filters may also be combined within a single request as illustrated in the sample below which further refines results to return only those shirts available from specific sellers: /buy/browse/v1/item_summary/search?q=shirt&filter=price:[10..50],sellers:{rpseller\|bigSal} Occurrence: Optional
sort	array of SortField	Specifies the criteria on which returned items are to be sorted. Items can be sorted in ascending order based on: Price (`sort=price`) Returned items are sorted based on their total cost (i.e., price + shipping cost). Items with the lowest combined price are shown first. When sorting by price, it is highly recommended that: The `X-EBAY-C-ENDUSERCTX` request header is used, and The `contextualLocation` parameter specifies the delivery country and postal code. These values must be URL-encoded. Refer to the following example: X-EBAY-C-ENDUSERCTX: contextualLocation=country%3DUS%2Czip%3D19406 Descending price order To sort items from highest price to lowest price insert a minus sign (-) before `price` as the search criterion: sort=-price Distance (`sort=distance`) Returned items are sorted based on their distance from the buyer's location. Items that are closest to the buyer are listed first. Important! When sorting by distance, all required pickup filters must be included in the request. Date Items can be sorted by date based on: Listing date (`sort=newlyListed`) Returned items are sorted based on their listing date. Newly listed items are shown first. End date (`sort=endingSoonest`) Returned items are sorted based on the date/time on which their listing is scheduled to end. Items that are closest to their scheduled ending date/time are shown first. If no sort parameter is submitted, the result set is sorted by "Best Match". Refer to Optimizing your listings for Best Match for additional information. Occurrence: Optional
limit	string	The number of items from the result set returned in a single page. Note: If a value is set in the `limit` field, the value of `offset` must be either zero or a multiple of the `limit` value. An error is returned for invalid `offset` values. Note: This method can return a maximum of 10,000 items in one results set. Min: 1 Max: 200 Default: 50 Occurrence: Optional
offset	string	Specifies the number of items to skip in the result set. This is used with the `limit` field to control the pagination of the output. For example: If `offset` is 0 and `limit` is 10, the method will retrieve items 1-10 from the list of items returned If `offset` is 10 and `limit` is 10, the method will retrieve items 11-20 from the list of items returned. Note: The value of `offset` must be either zero or a multiple of the value set in the `limit` field. An error is returned for invalid `offset` values. Note: This method can return a maximum of 10,000 items in one results set. Min: 0 Max: 9,999 Default: 0 Occurrence: Optional
aspect_filter	AspectFilter	This field lets you filter by item aspects. The aspect name/value pairs and category, which is required, is used to limit the results to specific aspects of the item. For example, in a clothing category one aspect pair would be Color/Red. Note: The category ID must be specified twice: Once as a URI parameter in the `category_ids` field Once as part of the `aspect_filter` field These two values must be the same. For example, to return items for a woman's red shirt, issue the following request: /buy/browse/v1/item_summary/search?q=shirt&category_ids=15724&aspect_filter=categoryId:15724,Color:{Red} To get a list of the aspect pairs and the category, which is returned in the `dominantCategoryId` field, set `fieldgroups` to `ASPECT_REFINEMENTS` as illustrated here: /buy/browse/v1/item_summary/search?q=shirt&fieldgroups=ASPECT_REFINEMENTS Note: The pipe symbol is used as a delimiter between aspect filter values. If a value contains a pipe symbol (for example, the brand name 'Bed\|Stü'), you must enter a backslash before the pipe character to prevent it from being evaluated as a delimiter. The following example illustrates the correct format for entering two brand names as aspect filter values, one of which contains a pipe symbol: /buy/browse/v1/item_summary/search?limit=50&category_ids=3034&filter=buyingOptions:{AUCTION\|FIXED_PRICE}&aspect_filter=categoryId:3034,Brand:{Bed\\|Stü\|Nike} Occurrence: Optional
epid	string	The ePID is the eBay product identifier of a product from the eBay product catalog. This field limits the results to only items in the specified ePID. Use the product_summary/search method in the Catalog API to search for the ePID of the product. For example: /buy/browse/v1/item_summary/search?epid=15032 Note: When constructing a query, `epid` may be combined with a `gtin` value. However, do not specify keywords using the `q` parameter — keywords cannot be used in conjunction with an `epid`. Occurrence: Conditional

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
Accept-Language	string	This header is used to indicate the natural language and locale preferred by the user for the response. This header is required when targeting a specific locale of a marketplace that supports multiple locales. For example: When targeting the French locale of the Belgium marketplace, it is required to pass in `fr-BE` to specify this. If this locale is not specified, the language will default to Dutch. When targeting the French locale of the Canadian marketplace, it is required to pass in `fr-CA` to specify this. If this locale is not specified, the language will default to English. Occurrence: Conditional
X-EBAY-C-ENDUSERCTX	string	This header is required to support revenue sharing for eBay Partner Network and to improve the accuracy of shipping and delivery time estimations. For additional information, refer to Use request headers in the Buying Integration Guide. Occurrence: Optional
X-EBAY-C-MARKETPLACE-ID	string	This header identifies the seller's eBay marketplace. It is required for all marketplaces outside of the US. Note: If a marketplace ID value is not provided, the default value of `EBAY_US` is used. See MarketplaceIdEnum for supported values. Occurrence: Strongly Recommended

Accept-Language

string

This header is used to indicate the natural language and locale preferred by the user for the response.

This header is required when targeting a specific locale of a marketplace that supports multiple locales. For example:

When targeting the French locale of the Belgium marketplace, it is required to pass in fr-BE to specify this. If this locale is not specified, the language will default to Dutch.
When targeting the French locale of the Canadian marketplace, it is required to pass in fr-CA to specify this. If this locale is not specified, the language will default to English.

Occurrence: Conditional

X-EBAY-C-ENDUSERCTX

string

This header is required to support revenue sharing for eBay Partner Network and to improve the accuracy of shipping and delivery time estimations.

For additional information, refer to Use request headers in the Buying Integration Guide.

Occurrence: Optional

X-EBAY-C-MARKETPLACE-ID

string

This header identifies the seller's eBay marketplace. It is required for all marketplaces outside of the US.

Note: If a marketplace ID value is not provided, the default value of EBAY_US is used.
See MarketplaceIdEnum for supported values.

Occurrence: Strongly Recommended

OAuth scope

This request requires an access token created with the client credentials 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

See OAuth access tokens for more information.

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

{ /* SearchPagedCollection<ItemSummary> */

"autoCorrections" :

{ /* AutoCorrections */

"q" : "string"

"href" : "string",

"itemSummaries" : [

{ /* ItemSummary */

"additionalImages" : [

{ /* Image */

"height" : "integer",

"imageUrl" : "string",

"width" : "integer"

}

"adultOnly" : "boolean",

"availableCoupons" : "boolean",

"bidCount" : "integer",

"buyingOptions" : [

"string"

"categories" : [

{ /* Category */

"categoryId" : "string",

"categoryName" : "string"

}

"compatibilityMatch" : "CompatibilityMatchEnum : [EXACT,POSSIBLE]",

"compatibilityProperties" : [

{ /* CompatibilityProperty */

"localizedName" : "string",

"name" : "string",

"value" : "string"

}

"condition" : "string",

"conditionId" : "string",

"currentBidPrice" :

{ /* ConvertedAmount */

"convertedFromCurrency" : "CurrencyCodeEnum : [AED,AFN,ALL...]",

"convertedFromValue" : "string",

"currency" : "CurrencyCodeEnum : [AED,AFN,ALL...]",

"value" : "string"

"distanceFromPickupLocation" :

{ /* TargetLocation */

"unitOfMeasure" : "string",

"value" : "string"

"energyEfficiencyClass" : "string",

"epid" : "string",

"image" :

{ /* Image */

"height" : "integer",

"imageUrl" : "string",

"width" : "integer"

"itemAffiliateWebUrl" : "string",

"itemCreationDate" : "string",

"itemEndDate" : "string",

"itemGroupHref" : "string",

"itemGroupType" : "string",

"itemHref" : "string",

"itemId" : "string",

"itemLocation" :

{ /* ItemLocationImpl */

"addressLine1" : "string",

"addressLine2" : "string",

"city" : "string",

"country" : "CountryCodeEnum : [AD,AE,AF...]",

"county" : "string",

"postalCode" : "string",

"stateOrProvince" : "string"

"itemWebUrl" : "string",

"leafCategoryIds" : [

"string"

"legacyItemId" : "string",

"listingMarketplaceId" : "MarketplaceIdEnum : [EBAY_AU,EBAY_AT,EBAY_BE...]",

"marketingPrice" :

{ /* MarketingPrice */

"discountAmount" :

{ /* ConvertedAmount */

"convertedFromCurrency" : "CurrencyCodeEnum : [AED,AFN,ALL...]",

"convertedFromValue" : "string",

"currency" : "CurrencyCodeEnum : [AED,AFN,ALL...]",

"value" : "string"

"discountPercentage" : "string",

"originalPrice" :

{ /* ConvertedAmount */

"convertedFromCurrency" : "CurrencyCodeEnum : [AED,AFN,ALL...]",

"convertedFromValue" : "string",

"currency" : "CurrencyCodeEnum : [AED,AFN,ALL...]",

"value" : "string"

"priceTreatment" : "PriceTreatmentEnum : [MINIMUM_ADVERTISED_PRICE,LIST_PRICE,MARKDOWN]"

"pickupOptions" : [

{ /* PickupOptionSummary */

"pickupLocationType" : "string"

}

"price" :

{ /* ConvertedAmount */

"convertedFromCurrency" : "CurrencyCodeEnum : [AED,AFN,ALL...]",

"convertedFromValue" : "string",

"currency" : "CurrencyCodeEnum : [AED,AFN,ALL...]",

"value" : "string"

"priceDisplayCondition" : "PriceDisplayConditionEnum : [ONLY_SHOW_WHEN_ADDED_IN_CART,ONLY_SHOW_ON_REQUEST,ALWAYS_SHOW]",

"priorityListing" : "boolean",

"qualifiedPrograms" : [

"string"

"seller" :

{ /* Seller */

"feedbackPercentage" : "string",

"feedbackScore" : "integer",

"sellerAccountType" : "string",

"username" : "string"

"shippingOptions" : [

{ /* ShippingOptionSummary */

"guaranteedDelivery" : "boolean",

"maxEstimatedDeliveryDate" : "string",

"minEstimatedDeliveryDate" : "string",

"shippingCost" :

{ /* ConvertedAmount */

"convertedFromCurrency" : "CurrencyCodeEnum : [AED,AFN,ALL...]",

"convertedFromValue" : "string",

"currency" : "CurrencyCodeEnum : [AED,AFN,ALL...]",

"value" : "string"

"shippingCostType" : "string"

}

"shortDescription" : "string",

"thumbnailImages" : [

{ /* Image */

"height" : "integer",

"imageUrl" : "string",

"width" : "integer"

}

"title" : "string",

"topRatedBuyingExperience" : "boolean",

"tyreLabelImageUrl" : "string",

"unitPrice" :

{ /* ConvertedAmount */

"convertedFromCurrency" : "CurrencyCodeEnum : [AED,AFN,ALL...]",

"convertedFromValue" : "string",

"currency" : "CurrencyCodeEnum : [AED,AFN,ALL...]",

"value" : "string"

"unitPricingMeasure" : "string",

"watchCount" : "integer"

}

"limit" : "integer",

"next" : "string",

"offset" : "integer",

"prev" : "string",

"" :

{ /* Refinement */

"" : [

{ /* AspectDistribution */

"" : [

{ /* AspectValueDistribution */

"" : "string",

"" : "integer",

"" : "string"

}

"" : "string"

}

"" : [

{ /* BuyingOptionDistribution */

"" : "string",

"" : "integer",

"" : "string"

}

"" : [

{ /* CategoryDistribution */

"" : "string",

"" : "integer",

"" : "string"

}

"" : [

{ /* ConditionDistribution */

"" : "string",

"" : "integer",

"" : "string"

}

"" : "string"

"total" : "integer",

"warnings" : [

{ /* ErrorDetailV3 */

"category" : "string",

"domain" : "string",

"errorId" : "integer",

"inputRefIds" : [

"string"

"longMessage" : "string",

"message" : "string",

"outputRefIds" : [

"string"

"parameters" : [

{ /* ErrorParameterV3 */

"name" : "string",

"value" : "string"

}

"subdomain" : "string"

}

]

}

Response fields

Output container/field	Type	Description
autoCorrections	AutoCorrections	The auto-corrected inputs. Occurrence: Conditional
autoCorrections.q	string	The automatically spell-corrected keyword from the request. Occurrence: Conditional
href	string	The URI of the current page of results. The following example of the search method returns items 1 thru 5 from the list of items found. https://api.ebay.com/buy/v1/item_summary/search?q=shirt&limit=5&offset=0 . Occurrence: Always
itemSummaries	array of ItemSummary	An array of the items on this page. The items are sorted according to the sorting method specified in the request. Occurrence: Conditional
itemSummaries.additionalImages	array of Image	An array of containers with the URLs for the images that are in addition to the primary image. The primary image is returned in the `image.imageUrl` field. Occurrence: Conditional
itemSummaries.additionalImages.height	integer	Reserved for future use. Occurrence: Conditional
itemSummaries.additionalImages.imageUrl	string	The URL of the image. Occurrence: Always
itemSummaries.additionalImages.width	integer	Reserved for future use. Occurrence: Conditional
itemSummaries.adultOnly	boolean	This indicates if the item is for adults only. For more information about adult-only items on eBay, refer to the Adult items policy. Occurrence: Always
itemSummaries.availableCoupons	boolean	This boolean attribute indicates if coupons are available for the item. Occurrence: Always
itemSummaries.bidCount	integer	This integer value indicates the total number of bids that have been placed for an auction item. This field is only returned for auction items. Occurrence: Conditional
itemSummaries.buyingOptions	array of string	A comma separated list of all the purchase options available for the item. Values Returned: `FIXED_PRICE` Indicates the buyer can purchase the item for a set price using the Buy It Now button. `AUCTION` Indicates the buyer can place a bid for the item. After the first bid is placed, this becomes a live auction item and is the only buying option for this item. `BEST_OFFER` Items where the buyer can send the seller a price they are willing to pay for the item. The seller can accept, reject, or send a counter offer. For additional information about Best Offer, refer to Adding Best Offer to your listing and sending offers to buyers. `CLASSIFIED_AD` Indicates that the final sales transaction is to be completed outside of the eBay environment. Occurrence: Always
itemSummaries.categories	array of Category	This array returns the name and ID of each category associated with the item, including top level, branch, and leaf categories. Occurrence: Conditional
itemSummaries.categories.categoryId	string	The unique identifier of the category. Occurrence: Always
itemSummaries.categories.categoryName	string	The name of the category. Occurrence: Conditional
itemSummaries.compatibilityMatch	CompatibilityMatchEnum	This indicates how well an item matches the `compatibility_filter` product attributes. Valid Values: `EXACT` `POSSIBLE` `Occurrence: Conditional`
itemSummaries.compatibilityProperties	array of CompatibilityProperty	This container returns only the product attributes that are compatible with the item. These attributes were specified in the `compatibility_filter` in the request. This means that if you passed in 5 attributes and only 4 are compatible, only those 4 are returned. If none of the attributes are compatible, this container is not returned. Occurrence: Conditional
itemSummaries.compatibilityProperties.localizedName	string	The name of the product attribute that as been translated to the language of the site. Occurrence: Conditional
itemSummaries.compatibilityProperties.name	string	The name of the product attribute, such as Make, Model, Year, etc. Occurrence: Conditional
itemSummaries.compatibilityProperties.value	string	The value for the `name` attribute, such as BMW, R1200GS, 2011, etc. Occurrence: Conditional
itemSummaries.condition	string	The text describing the condition of the item, such as New or Used. For a list of condition names, refer to Item Condition IDs and Names. Occurrence: Conditional
itemSummaries.conditionId	string	The identifier of the condition of the item. For example, `1000` is the identifier for `NEW`. For a list of condition names and IDs, refer to Item Condition IDs and Names. Occurrence: Conditional
itemSummaries.currentBidPrice	ConvertedAmount	This container returns the current highest bid for an auction item. The `value` field shows the dollar value of the current highest bid, and the `currency` field (3-digit ISO code) denotes the currency associated with that bid value. This field is only returned for auction items. Occurrence: Conditional
itemSummaries.currentBidPrice.convertedFromCurrency	CurrencyCodeEnum	The three-letter ISO 4217 code representing the currency of the amount in the `convertedFromValue` field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency. Occurrence: Conditional
itemSummaries.currentBidPrice.convertedFromValue	string	The monetary amount before any conversion is performed, in the currency specified by the `convertedFromCurrency` field. This value is required or returned only if currency conversion/localization is required. The `value` field contains the converted amount of this value, in the currency specified by the `currency` field. Occurrence: Conditional
itemSummaries.currentBidPrice.currency	CurrencyCodeEnum	The three-letter ISO 4217 code representing the currency of the amount in the `value` field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the `value` field. Default: The currency of the authenticated user's country. Occurrence: Conditional
itemSummaries.currentBidPrice.value	string	The monetary amount in the currency specified by the `currency` field. If currency conversion/localization is required, this value is the converted amount, and the `convertedFromValue` field contains the amount in the original currency. Occurrence: Conditional
itemSummaries.distanceFromPickupLocation	TargetLocation	This container returns the distance away that the item is from the `pickupPostalCode` value that was supplied in the method request. This container is only returned if the "local pickup" filter fields are used in the request. Occurrence: Conditional
itemSummaries.distanceFromPickupLocation.unitOfMeasure	string	This value shows the unit of measurement used to measure the distance between the location of the item and the buyer's location. This value is typically `mi` or `km`. Occurrence: Conditional
itemSummaries.distanceFromPickupLocation.value	string	This value indicates the distance (measured in the measurement unit in the unitOfMeasure field) between the item location and the buyer's location. Occurrence: Conditional
itemSummaries.energyEfficiencyClass	string	This indicates the European energy efficiency rating (EEK) of the item. Energy efficiency ratings apply to products listed by commercial vendors in electronics categories only. Currently, this field is only applicable for the Germany site, and is returned only if the seller specifies the energy efficiency rating through item specifics at listing time. Rating values include `A+++`, `A++`, `A+`, `A`, `B`, `C`, `D`, `E`, `F`, and `G`. Occurrence: Conditional
itemSummaries.epid	string	An ePID is the eBay product identifier of a product from the eBay product catalog. This indicates the product in which the item belongs. Occurrence: Conditional
itemSummaries.image	Image	The URL to the primary image of the item. Occurrence: Always
itemSummaries.image.height	integer	Reserved for future use. Occurrence: Conditional
itemSummaries.image.imageUrl	string	The URL of the image. Occurrence: Always
itemSummaries.image.width	integer	Reserved for future use. Occurrence: Conditional
itemSummaries.itemAffiliateWebUrl	string	The URL to the View Item page of the item which includes the affiliate tracking ID. Note: In order to receive commissions on sales, eBay Partner Network affiliates must use this URL to forward buyers to the listing on the eBay marketplace. The `itemAffiliateWebUrl` is returned only if: The marketplace through which the item is being viewed is part of the eBay Partner Network. Currently Singapore (`EBAY_SG`) is not supported. For additional information, refer to eBay Partner Network. The seller enables affiliate tracking for the item by including the `X-EBAY-C-ENDUSERCTX` request header in the method. Occurrence: Conditional
itemSummaries.itemCreationDate	string	The date and time when the item listing was created. This value is returned in UTC format (yyyy-MM-ddThh:mm:ss.sssZ), which you can convert into the local time of the buyer. Occurrence: Conditional
itemSummaries.itemEndDate	string	The date and time up to which the item can be purchased. This value is returned in UTC format (yyyy-MM-ddThh:mm:ss.sssZ), which you can convert into the local time of the buyer. Note: This field is not returned for Good 'Til Cancelled (GTC) listings. Occurrence: Conditional
itemSummaries.itemGroupHref	string	The HATEOAS reference of the parent page of the item group. An item group is an item that has various aspect differences, such as color, size, storage capacity, etc. Note: This field is returned only for item groups. Occurrence: Conditional
itemSummaries.itemGroupType	string	The indicates the item group type. An item group is an item that has various aspect differences, such as color, size, storage capacity, etc. Currently only the `SELLER_DEFINED_VARIATIONS` is supported and indicates this is an item group created by the seller. Note: This field is returned only for item groups. Occurrence: Conditional
itemSummaries.itemHref	string	The URI for the Browse API getItem method, which can be used to retrieve more details about items in the search results. Occurrence: Always
itemSummaries.itemId	string	The unique RESTful identifier of the item. Occurrence: Always
itemSummaries.itemLocation	ItemLocationImpl	This container returns the location of the item. This container consists of fields you typically see for an address, including postal code, county, state/province, street address, city, and country (2-digit ISO code). Occurrence: Conditional
itemSummaries.itemLocation.addressLine1	string	The first line of the street address. Occurrence: Conditional
itemSummaries.itemLocation.addressLine2	string	The second line of the street address. This field may contain such values as an apartment or suite number. Occurrence: Conditional
itemSummaries.itemLocation.city	string	The city in which the item is located. Restriction: This field is populated in the `search` method response only when `fieldgroups` = `EXTENDED`. Occurrence: Conditional
itemSummaries.itemLocation.country	CountryCodeEnum	The two-letter ISO 3166 standard code that indicates the country in which the item is located. Occurrence: Always
itemSummaries.itemLocation.county	string	The county in which the item is located. Occurrence: Conditional
itemSummaries.itemLocation.postalCode	string	The postal code (or zip code in US) where the item is located. Sellers set a postal code for items when they are listed. The postal code is used for calculating proximity searches. It is anonymized when returned in `itemLocation.postalCode` via the API. Occurrence: Conditional
itemSummaries.itemLocation.stateOrProvince	string	The state or province in which the item is located. Occurrence: Conditional
itemSummaries.itemWebUrl	string	The URL to the View Item page of the item. This enables you to include a "Report Item on eBay" hyperlink that takes the buyer to the View Item page on eBay. From there they can report any issues regarding this item to eBay. Occurrence: Always
itemSummaries.leafCategoryIds	array of string	The leaf category IDs of the item. When the item belongs to two leaf categories, the ID values are returned in the order primary, secondary. Occurrence: Always
itemSummaries.legacyItemId	string	The unique identifier of the eBay listing that contains the item. This is the traditional/legacy ID that is often seen in the URL of the listing View Item page. Occurrence: Always
itemSummaries.listingMarketplaceId	MarketplaceIdEnum	The ID of the eBay marketplace on which the seller listed the item. Occurrence: Always
itemSummaries.marketingPrice	MarketingPrice	This container is returned if the item is eligible for a seller discount and contains the item's original price, and the seller discount amount and percentage. Occurrence: Conditional
itemSummaries.marketingPrice.discountAmount	ConvertedAmount	This container returns the monetary amount of the seller discount. Occurrence: Conditional
itemSummaries.marketingPrice.discountAmount.convertedFromCurrency	CurrencyCodeEnum	The three-letter ISO 4217 code representing the currency of the amount in the `convertedFromValue` field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency. Occurrence: Conditional
itemSummaries.marketingPrice.discountAmount.convertedFromValue	string	The monetary amount before any conversion is performed, in the currency specified by the `convertedFromCurrency` field. This value is required or returned only if currency conversion/localization is required. The `value` field contains the converted amount of this value, in the currency specified by the `currency` field. Occurrence: Conditional
itemSummaries.marketingPrice.discountAmount.currency	CurrencyCodeEnum	The three-letter ISO 4217 code representing the currency of the amount in the `value` field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the `value` field. Default: The currency of the authenticated user's country. Occurrence: Conditional
itemSummaries.marketingPrice.discountAmount.value	string	The monetary amount in the currency specified by the `currency` field. If currency conversion/localization is required, this value is the converted amount, and the `convertedFromValue` field contains the amount in the original currency. Occurrence: Conditional
itemSummaries.marketingPrice.discountPercentage	string	This field expresses the percentage of the seller discount based on the value in the `originalPrice` container. Occurrence: Conditional
itemSummaries.marketingPrice.originalPrice	ConvertedAmount	This container returns the monetary amount of the item without the discount. Occurrence: Conditional
itemSummaries.marketingPrice.originalPrice.convertedFromCurrency	CurrencyCodeEnum	The three-letter ISO 4217 code representing the currency of the amount in the `convertedFromValue` field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency. Occurrence: Conditional
itemSummaries.marketingPrice.originalPrice.convertedFromValue	string	The monetary amount before any conversion is performed, in the currency specified by the `convertedFromCurrency` field. This value is required or returned only if currency conversion/localization is required. The `value` field contains the converted amount of this value, in the currency specified by the `currency` field. Occurrence: Conditional
itemSummaries.marketingPrice.originalPrice.currency	CurrencyCodeEnum	The three-letter ISO 4217 code representing the currency of the amount in the `value` field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the `value` field. Default: The currency of the authenticated user's country. Occurrence: Conditional
itemSummaries.marketingPrice.originalPrice.value	string	The monetary amount in the currency specified by the `currency` field. If currency conversion/localization is required, this value is the converted amount, and the `convertedFromValue` field contains the amount in the original currency. Occurrence: Conditional
itemSummaries.marketingPrice.priceTreatment	PriceTreatmentEnum	Indicates the pricing treatment (discount) that was applied to the price of the item. Note: The pricing treatment affects the way and where the discounted price can be displayed. Occurrence: Conditional
itemSummaries.pickupOptions	array of PickupOptionSummary	This container returns the local pickup options available to the buyer. This container is returned only if the user is searching for local pickup items and set the local pickup filters in the method request. Occurrence: Conditional
itemSummaries.pickupOptions.pickupLocationType	string	This container returns the local pickup options available to the buyer. Possible values are `ARRANGED_LOCATION` and `STORE`. Occurrence: Conditional
itemSummaries.price	ConvertedAmount	The price of the item after it has been converted into another currency. The price includes the value-added tax (VAT) for applicable jurisdictions when requested from supported marketplaces. In this case, users must do one or more of the following to view VAT-inclusive pricing: Pass the `X-EBAY-C-MARKETPLACE-ID` request header specifying the supported marketplace (such as `EBAY_GB`) Pass the `contextualLocation` values for the supported marketplace in the `X-EBAY-C-ENDUSERCTX` request header Specify the supported marketplace using the `deliveryCountry` `filter` URI parameter (such as `filter=deliveryCountry:GB`) Note: For more information on VAT, refer to Your VAT Obligations in the UK & EU. Occurrence: Always
itemSummaries.price.convertedFromCurrency	CurrencyCodeEnum	The three-letter ISO 4217 code representing the currency of the amount in the `convertedFromValue` field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency. Occurrence: Conditional
itemSummaries.price.convertedFromValue	string	The monetary amount before any conversion is performed, in the currency specified by the `convertedFromCurrency` field. This value is required or returned only if currency conversion/localization is required. The `value` field contains the converted amount of this value, in the currency specified by the `currency` field. Occurrence: Conditional
itemSummaries.price.currency	CurrencyCodeEnum	The three-letter ISO 4217 code representing the currency of the amount in the `value` field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the `value` field. Default: The currency of the authenticated user's country. Occurrence: Conditional
itemSummaries.price.value	string	The monetary amount in the currency specified by the `currency` field. If currency conversion/localization is required, this value is the converted amount, and the `convertedFromValue` field contains the amount in the original currency. Occurrence: Conditional
itemSummaries.priceDisplayCondition	PriceDisplayConditionEnum	Indicates when in the buying flow the item's price can appear for minimum advertised price (MAP) items, which is the lowest price a retailer can advertise/show for this item. Occurrence: Conditional
itemSummaries.priorityListing	boolean	This field is returned as `true` if the listing is part of a Promoted Listing campaign. Promoted Listings are available to Above Standard and Top Rated sellers with recent sales activity. Note: Priority Listing is returned only with a Best Match sort and will not be returned for other sort options. Occurrence: Always
itemSummaries.qualifiedPrograms	array of string	An array of the qualified programs available for the item, such as `EBAY_PLUS`, `AUTHENTICITY_GUARANTEE`, and `AUTHENTICITY_VERIFICATION`. eBay Plus is a premium account option for buyers, which provides benefits such as fast, free domestic shipping and free returns on selected items. Top-Rated eBay sellers must opt in to eBay Plus to be able to offer the program on qualifying listings. Sellers must commit to next-day delivery of those items. Note: eBay Plus is available only to buyers in the Germany, Austria, and Australia marketplaces. The eBay Authenticity Guarantee program enables third-party authenticators to perform authentication verification inspections on items such as watches and sneakers. Occurrence: Conditional
itemSummaries.seller	Seller	This container returns basic information about the seller of the item, such as name, feedback score, etc. Occurrence: Always
itemSummaries.seller.feedbackPercentage	string	The percentage of the total positive feedback. Occurrence: Always
itemSummaries.seller.feedbackScore	integer	The feedback score of the seller. This value is based on the ratings from eBay members that bought items from this seller. Occurrence: Always
itemSummaries.seller.sellerAccountType	string	Indicates if the seller is a business or an individual. This is determined when the seller registers with eBay: If they register for a business account, this value will be `BUSINESS.` `If they register for a private account, this value will be INDIVIDUAL.` `This designation is required by the tax laws in some countries. This field is returned only on the following sites: EBAY_AT, EBAY_BE, EBAY_CH, EBAY_DE, EBAY_ES, EBAY_FR, EBAY_GB, EBAY_IE, EBAY_IT, EBAY_PL Valid Values: BUSINESS or INDIVIDUAL Occurrence: Conditional`
itemSummaries.seller.username	string	The user name created by the seller for use on eBay. Occurrence: Always
itemSummaries.shippingOptions	array of ShippingOptionSummary	This container returns the shipping options available to ship the item. Occurrence: Conditional
itemSummaries.shippingOptions.guaranteedDelivery	boolean	Although this field is still returned, it can be ignored since eBay Guaranteed Delivery is no longer a supported feature on any marketplace. This field may get removed from the schema in the future. Occurrence: Conditional
itemSummaries.shippingOptions.maxEstimatedDeliveryDate	string	The end date of the delivery window (latest projected delivery date). This value is returned in UTC format (yyyy-MM-ddThh:mm:ss.sssZ), which you can convert into the local time of the buyer. Note: For the best accuracy, always include the `contextualLocation` values in the `X-EBAY-C-ENDUSERCTX` request header. Occurrence: Conditional
itemSummaries.shippingOptions.minEstimatedDeliveryDate	string	The start date of the delivery window (earliest projected delivery date). This value is returned in UTC format (yyyy-MM-ddThh:mm:ss.sssZ), which you can convert into the local time of the buyer. Note: For the best accuracy, always include the `contextualLocation` values in the `X-EBAY-C-ENDUSERCTX` request header. Occurrence: Conditional
itemSummaries.shippingOptions.shippingCost	ConvertedAmount	This is the estimated price to ship the item. The price includes the value-added tax (VAT) for applicable jurisdictions when requested from supported marketplaces. In this case, users must do one or more of the following to see VAT-inclusive pricing: Pass the `X-EBAY-C-MARKETPLACE-ID` request header specifying the supported marketplace (such as `EBAY_GB`) Pass the `contextualLocation` values for the supported marketplace in the `X-EBAY-C-ENDUSERCTX` request header Specify the supported marketplace using the `deliveryCountry` filter URI parameter (such as `filter=deliveryCountry:GB`) Note:For more information on VAT, refer to Your VAT Obligations in the UK & EU. Occurrence: Conditional
itemSummaries.shippingOptions.shippingCost.convertedFromCurrency	CurrencyCodeEnum	The three-letter ISO 4217 code representing the currency of the amount in the `convertedFromValue` field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency. Occurrence: Conditional
itemSummaries.shippingOptions.shippingCost.convertedFromValue	string	The monetary amount before any conversion is performed, in the currency specified by the `convertedFromCurrency` field. This value is required or returned only if currency conversion/localization is required. The `value` field contains the converted amount of this value, in the currency specified by the `currency` field. Occurrence: Conditional
itemSummaries.shippingOptions.shippingCost.currency	CurrencyCodeEnum	The three-letter ISO 4217 code representing the currency of the amount in the `value` field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the `value` field. Default: The currency of the authenticated user's country. Occurrence: Conditional
itemSummaries.shippingOptions.shippingCost.value	string	The monetary amount in the currency specified by the `currency` field. If currency conversion/localization is required, this value is the converted amount, and the `convertedFromValue` field contains the amount in the original currency. Occurrence: Conditional
itemSummaries.shippingOptions.shippingCostType	string	Indicates the type of shipping used to ship the item. Possible values are `FIXED` (flat-rate shipping) and `CALCULATED` (shipping cost calculated based on item and buyer location). Occurrence: Conditional
itemSummaries.shortDescription	string	This text string is derived from the item condition and the item aspects (such as size, color, capacity, model, brand, etc.) Sometimes the title does not provide enough information but the description is too big. Surfacing the `shortDescription` can often provide buyers with the additional information that could help them make a buying decision. For example: "title": "Petrel U42W FPV Drone RC Quadcopter w/HD Camera Live Video One Key Off / Landing", "shortDescription": "1 U42W Quadcopter. Syma X5SW-V3 Wifi FPV RC Drone Quadcopter 2.4Ghz 6-Axis Gyro with Headless Mode. Syma X20 Pocket Drone 2.4Ghz Mini RC Quadcopter Headless Mode Altitude Hold. One Key Take Off / Landing function: allow beginner to easy to fly the drone without any skill.", Restriction: This field is returned by the search method only when `fieldgroups` = `EXTENDED`. Occurrence: Conditional
itemSummaries.thumbnailImages	array of Image	An array of thumbnail images for the item. Occurrence: Conditional
itemSummaries.thumbnailImages.height	integer	Reserved for future use. Occurrence: Conditional
itemSummaries.thumbnailImages.imageUrl	string	The URL of the image. Occurrence: Always
itemSummaries.thumbnailImages.width	integer	Reserved for future use. Occurrence: Conditional
itemSummaries.title	string	The seller-created title of the item. Maximum Length: 80 characters Occurrence: Always
itemSummaries.topRatedBuyingExperience	boolean	This indicates if the item is a top-rated plus item. There are three benefits of a top-rated plus item: a minimum 30-day money-back return policy; shipping the item in 1 business day with tracking provided; and the added comfort of knowing that this item is from an experienced seller with the highest buyer ratings. For more information, refer to Look for Top Rated Plus Items and Seller performance overview. Occurrence: Conditional
itemSummaries.tyreLabelImageUrl	string	The URL to the image that shows the information on the tyre label. Occurrence: Conditional
itemSummaries.unitPrice	ConvertedAmount	The price per unit for the item. Some European countries require listings for certain types of products to include the price per unit so buyers can accurately compare prices. For example: "unitPricingMeasure": "100g", "unitPrice": { "value": "7.99", "currency": "GBP" Occurrence: Conditional
itemSummaries.unitPrice.convertedFromCurrency	CurrencyCodeEnum	The three-letter ISO 4217 code representing the currency of the amount in the `convertedFromValue` field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency. Occurrence: Conditional
itemSummaries.unitPrice.convertedFromValue	string	The monetary amount before any conversion is performed, in the currency specified by the `convertedFromCurrency` field. This value is required or returned only if currency conversion/localization is required. The `value` field contains the converted amount of this value, in the currency specified by the `currency` field. Occurrence: Conditional
itemSummaries.unitPrice.currency	CurrencyCodeEnum	The three-letter ISO 4217 code representing the currency of the amount in the `value` field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the `value` field. Default: The currency of the authenticated user's country. Occurrence: Conditional
itemSummaries.unitPrice.value	string	The monetary amount in the currency specified by the `currency` field. If currency conversion/localization is required, this value is the converted amount, and the `convertedFromValue` field contains the amount in the original currency. Occurrence: Conditional
itemSummaries.unitPricingMeasure	string	The designation, such as size, weight, volume, count, etc., that was used to specify the quantity of the item. This helps buyers compare prices. For example, the following tells the buyer that the item is 7.99 per 100 grams. "unitPricingMeasure": "100g", "unitPrice": { "value": "7.99", "currency": "GBP" Occurrence: Conditional
itemSummaries.watchCount	integer	The number of users that have added the item to their watch list. Note: This field is restricted to applications that have been granted permission to access this feature. You must submit an App Check ticket to request this access. In the App Check form, add a note to the Application Title/Summary and/or Application Details fields indicating that you want access to Watch Count data in the Browse API. Occurrence: Conditional
limit	integer	The value of the `limit` parameter submitted in the request, which is the maximum number of items to return on a page, from the result set. A result set is the complete set of items returned by the method. Occurrence: Always
next	string	The URI for the next page of results. This value is returned if there is an additional page of results to return from the result set. The following example of the search method returns items 5 thru 10 from the list of items found. https://api.ebay.com/buy/v1/item_summary/search?query=t-shirts&limit=5&offset=10 Occurrence: Conditional
offset	integer	This value indicates the `offset` used for current page of items being returned. Assume the initial request used an `offset` of `0` and a `limit` of `3`. Then in the first page of results, this value would be `0`, and items 1-3 are returned. For the second page, this value is `3` and so on. Occurrence: Always
prev	string	The URI for the previous page of results. This is returned if there is a previous page of results from the result set. The following example of the search method returns items 1 thru 5 from the list of items found, which would be the first set of items returned. https://api.ebay.com/buy/v1/item_summary/search?query=t-shirts&limit=5&offset=0 Occurrence: Conditional
refinement	Refinement	The container for all the search refinements. Occurrence: Conditional
refinement.aspectDistributions	array of AspectDistribution	An array of containers for the all the aspect refinements. Occurrence: Conditional
refinement.aspectDistributions.aspectValueDistributions	array of AspectValueDistribution	An array of containers for the various values of the aspect and the match count, and a HATEOAS reference (`refinementHref`) for this aspect. Occurrence: Conditional
refinement.aspectDistributions.aspectValueDistributions.localizedAspectValue	string	The value of an aspect. For example, Red is a value for the aspect Color. Occurrence: Always
refinement.aspectDistributions.aspectValueDistributions.matchCount	integer	The number of items with this aspect. Occurrence: Always
refinement.aspectDistributions.aspectValueDistributions.refinementHref	string	A HATEOAS reference for this aspect. Occurrence: Always
refinement.aspectDistributions.localizedAspectName	string	The name of an aspect, such as Brand, Color, etc. Occurrence: Conditional
refinement.buyingOptionDistributions	array of BuyingOptionDistribution	An array of containers for the all the buying option refinements. Occurrence: Conditional
refinement.buyingOptionDistributions.buyingOption	string	The container that returns the buying option type. This will be AUCTION, FIXED_PRICE, CLASSIFIED_AD, or a combination of these options. For details, see buyingOptions. Occurrence: Always
refinement.buyingOptionDistributions.matchCount	integer	The number of items having this buying option. Occurrence: Always
refinement.buyingOptionDistributions.refinementHref	string	The HATEOAS reference for this buying option. Occurrence: Always
refinement.categoryDistributions	array of CategoryDistribution	An array of containers for the all the category refinements. Occurrence: Conditional
refinement.categoryDistributions.categoryId	string	The unique identifier of the category. Occurrence: Always
refinement.categoryDistributions.categoryName	string	The name of the category, such as Baby & Toddler Clothing. Occurrence: Always
refinement.categoryDistributions.matchCount	integer	The number of items in this category. Occurrence: Always
refinement.categoryDistributions.refinementHref	string	The HATEOAS reference of this category. Occurrence: Always
refinement.conditionDistributions	array of ConditionDistribution	An array of containers for the all the condition refinements. Occurrence: Conditional
refinement.conditionDistributions.condition	string	The text describing the condition of the item, such as New or Used. For a list of condition names, refer to Item Condition IDs and Names. Occurrence: Conditional
refinement.conditionDistributions.conditionId	string	The identifier of the condition. For example, `1000` is the identifier for `NEW`. Occurrence: Conditional
refinement.conditionDistributions.matchCount	integer	The number of items having the condition. Occurrence: Always
refinement.conditionDistributions.refinementHref	string	The HATEOAS reference of this condition. Occurrence: Always
refinement.dominantCategoryId	string	The identifier of the category that most of the items are part of. Occurrence: Always
total	integer	The total number of items that match the input criteria. Note: `total` is just an indicator of the number of listings for a given query. It could vary based on the number of listings with variations included in the result. It is strongly recommended that `total` not be used in pagination use cases. Instead, use next to determine the results on the next page. Occurrence: Always
warnings	array of ErrorDetailV3	The container with all the warnings for the request. Occurrence: Conditional
warnings.category	string	This string value indicates the error category. There are three categories of errors: request errors, application errors, and system errors. Occurrence: Always
warnings.domain	string	The name of the primary system where the error occurred. This is relevant for application errors. Occurrence: Always
warnings.errorId	integer	A unique code that identifies the particular error or warning that occurred. Your application can use error codes as identifiers in your customized error-handling algorithms. Occurrence: Always
warnings.inputRefIds	array of string	An array of reference IDs that identify the specific request elements most closely associated to the error or warning, if any. Occurrence: Conditional
warnings.longMessage	string	A detailed description of the condition that caused the error or warning, and information on what to do to correct the problem. Occurrence: Conditional
warnings.message	string	A description of the condition that caused the error or warning. Occurrence: Always
warnings.outputRefIds	array of string	An array of reference IDs that identify the specific response elements most closely associated to the error or warning, if any. Occurrence: Conditional
warnings.parameters	array of ErrorParameterV3	An array of warning and error messages that return one or more variables contextual information about the error or warning. This is often the field or value that triggered the error or warning. Occurrence: Conditional
warnings.parameters.name	string	This is the name of input field that caused an issue with the call request. Occurrence: Conditional
warnings.parameters.value	string	This is the actual value that was passed in for the element specified in the `name` field. Occurrence: Conditional
warnings.subdomain	string	The name of the subdomain in which the error or warning occurred. Occurrence: NA

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	OK
400	Bad Request
500	Internal Server Error

Error codes

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

Code	Domain	Category	Meaning
12000	API_BROWSE	APPLICATION	There was a problem with an eBay internal system or process. Contact eBay developer support for assistance.
12001	API_BROWSE	REQUEST	The call must have a valid 'q', 'category_ids', 'epid' or 'gtin' query parameter.
12004	API_BROWSE	REQUEST	The 'offset' value cannot be negative.
12005	API_BROWSE	REQUEST	The 'offset' value must be an integer.
12006	API_BROWSE	REQUEST	The 'limit' value should be between 1 and 200 (inclusive).
12007	API_BROWSE	REQUEST	The 'limit' value must be an integer value.
12013	API_BROWSE	BUSINESS	Top level category browsing is not allowed. Please provide keywords or more filters for the applied top level category.
12019	API_BROWSE	BUSINESS	Currently, the {marketplaceId} marketplace is not supported. The supported Marketplaces are: {allowedMarketplaces} .
12020	API_BROWSE	BUSINESS	The 'fieldgroups' value {fieldgroups} is invalid when multiple 'category_ids' are specified. Either change the call to have only one value in 'category_ids' or remove the 'fieldgroups'.
12023	API_BROWSE	REQUEST	This keyword search results in a response that is too large to return. Either change the keyword or add additional query parameters and/or filters.
12025	API_BROWSE	REQUEST	The 'charity_ids' field has exceeded the maximum limit of 20.
12026	API_BROWSE	REQUEST	The 'charity_ids' field is not supported for the marketplace {marketplaceId}. Valid marketplaces are: {validMarketplaces}.
12027	API_BROWSE	REQUEST	The 'auto_correct' value is invalid. For the valid values, refer to the API call documentation.
12028	API_BROWSE	REQUEST	The 'auto_correct' is not supported for the marketplace {marketplaceId}. Valid marketplaces are: {validMarketplaces}
12029	API_BROWSE	REQUEST	The maximum number of listings that can be retrieved is 10,000, so your offset value must be less than 10,000. If 10,000 or more listings are matching your search criteria, consider narrowing the scope of your search.
12030	API_BROWSE	REQUEST	The number of categories in the request has exceeded the limit. Please reduce the number of categories to {allowedMaxCategories} or less.
12032	API_BROWSE	REQUEST	The number of sellers in the filter has exceeded the limit. Please reduce the number of sellers to 250 or fewer.
12033	API_BROWSE	REQUEST	The 'qualifiedPrograms' filter for {filterValue} requires valid 'deliveryPostalCode' and 'deliveryCountry' filter values.
12034	API_BROWSE	REQUEST	The 'buyingOptions' filter value {filterValue} is not supported for the sort by {sortOption}. For the supported values, refer to the API call documentation.
12503	API_BROWSE	REQUEST	There is no compatibility information found either because there is no compatibility results or the data provided in the compatibility_filter is invalid or insufficient.
12504	API_BROWSE	REQUEST	You must provide a category ID that supports fitment.
12505	API_BROWSE	REQUEST	The following compatibility attributes in the request are not supported: {attributes}.
12506	API_BROWSE	REQUEST	The category ID submitted does not support fitment.
12507	API_BROWSE	REQUEST	To filter by 'guaranteedDeliveryInDays', you must include 'deliveryCountry'.
12508	API_BROWSE	REQUEST	To filter by 'guaranteedDeliveryInDays', you must include 'deliveryPostalCode' for the 'deliveryCountry'.
12509	API_BROWSE	REQUEST	The 'guaranteedDeliveryInDays' value {guaranteedDeliveryInDays} is invalid for 'deliveryCountry' value {deliveryCountry}. Valid values for 'guaranteedDeliveryInDays' for {deliveryCountry} must be in the range of {rangeLowerBound} to {rangeUpperBound} inclusive.
12510	API_BROWSE	REQUEST	The 'guaranteedDeliveryInDays' filter is not supported for the marketplace {marketplaceId}. Valid marketplaces are: {validMarketplaces}
12512	API_BROWSE	REQUEST	The 'qualifiedPrograms' filter for {filterValue} is not supported for the marketplace {marketplaceId}. Valid marketplaces are: {validMarketplaces}
12513	API_BROWSE	BUSINESS	The 'priorityListing' filter for {filterValue} is not supported for the marketplace {marketplaceId}. Valid marketplaces are: {validMarketplaces}
12514	API_BROWSE	BUSINESS	The 'priorityListing' filter is not supported for the specified sort option. Refer to the API call documentation.
12515	API_BROWSE	REQUEST	The 'offset' value must be either zero or a multiple of the 'limit' value.
12516	API_BROWSE	REQUEST	The ‘q’ value is invalid. It must be longer than one character when using the ‘searchInDescription’ filter.
12517	API_BROWSE	REQUEST	Only one item location filter can be applied at a time. Refer to the API call documentation.
12518	API_BROWSE	REQUEST	The 'itemLocationRegion' filter value is not supported for the marketplace {marketplaceId}. Valid values are: {validRegionValues}

Warnings

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

Code	Domain	Category	Meaning
12002	API_BROWSE	REQUEST	The {filterName} value is invalid. For the valid values, refer to the API call documentation.
12003	API_BROWSE	REQUEST	A seller 'username' provided in the request filters is invalid.
12008	API_BROWSE	REQUEST	The 'sort' value is invalid. For the valid values, refer to the API call documentation.
12009	API_BROWSE	REQUEST	The 'category_ids' query parameter is invalid.
12010	API_BROWSE	REQUEST	There are four filters required for local pickup. 'pickupPostalCode','pickupCountry','pickupRadiusUnit','pickupRadius'. One or more is missing or invalid.
12011	API_BROWSE	REQUEST	'deliveryCountry' is a mandatory filter to provide a delivery location. 'deliveryPostalCode' is optional.
12012	API_BROWSE	REQUEST	A valid 'price' filter and a valid 'priceCurrency' filter is necessary to filter based on price.
12014	API_BROWSE	BUSINESS	The 'sellerAccountTypes' filter is not supported for the marketplace {marketplaceId}. Valid marketplaces are: {validMarketplaces}
12015	API_BROWSE	REQUEST	The postal code filter value is invalid for the specified country and this filter was ignored.
12016	API_BROWSE	REQUEST	The 'fieldgroups' value {fieldgroups} is invalid. For the valid values, refer to the API call reference documentation
12017	API_BROWSE	REQUEST	The 'aspect_filter' query parameter must include a categoryId. For information, see the API call reference documentation.
12018	API_BROWSE	REQUEST	The {aspectFilter} aspect_filter value is invalid. For information, see the API call reference documentation.
12021	API_BROWSE	REQUEST	The 'epid' value {epid} is invalid. For information, see the API call reference documentation.
12022	API_BROWSE	REQUEST	The 'gtin' value {gtin} is invalid. For information, see the API call reference documentation.
12024	API_BROWSE	REQUEST	The 'charity_ids' value {charity_id} is invalid. For more information see the API call reference documentation.
12502	API_BROWSE	REQUEST	The {compatibilityFilter} compatibility_filter is invalid. For information, see the API call reference documentation.
12511	API_BROWSE	REQUEST	Either 'deliveryCountry' or 'deliveryPostalCode' is invalid, hence 'guaranteedDeliveryInDays' filter was ignored.

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 Items by Keyword

Sample 2: Search for Items by Category

Sample 3: Refine Keyword Results by Category

Sample 4: Retrieve the Item Aspects by Keyword Search

Sample 5: Return All Refinements For a Category

Sample 6: Filter the Keyword Results by Item Aspects

Sample 7: Return Items with Free Shipping

Sample 8: Return Items Based on Price and Condition

Sample 9: Return Items Associated with a Charity

Sample 10: Return Items that are Compatible with the Keyword and Vehicle

Sample 11: Return Items Based on Auto-Corrected Keyword

Sample 1: Search for Items by Keyword

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

Input

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

GEThttps://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3

Output

If the call is successful, 3 items per set will be returned.

{
  "href": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&offset=0",
  "total": 260202,
  "next": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&offset=3",
  "limit": 3,
  "offset": 0,
  "itemSummaries": [
    {
      "itemId": "v1|1**********1|0",
      "title": "Syma X5SW-V3 Wifi FPV RC Drone Quadcopter 2.4Ghz 6-Axis Gyro with Headless Mode",
      "leafCategoryIds": [
        "179697",
        "182186"
      ],
      "categories": [
        {
          "categoryId": "179697",
          "categoryName": "Camera Drones"
        },
        {
          "categoryId": "182186",
          "categoryName": "Other RC Model Vehicles & Kits"
        },
        {
          "categoryId": "2562",
          "categoryName": "Radio Control & Control Line"
        },
        {
          "categoryId": "220",
          "categoryName": "Toys & Hobbies"
        },
        {
          "categoryId": "625",
          "categoryName": "Cameras & Photo"
        },
        {
          "categoryId": "182181",
          "categoryName": "RC Model Vehicles & Kits"
        }
      ],
      "image": {
        "imageUrl": "https://i.ebayimg.com/thumbs/images/g/n**************a/s-***5.jpg"
      },
      "price": {
        "value": "59.99",
        "currency": "USD"
      },
      "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1******************0",
      "seller": {
        "username": "m********e",
        "feedbackPercentage": "98.6",
        "feedbackScore": 130000
      },
      "marketingPrice": {
        "originalPrice": {
          "value": "74.99",
          "currency": "USD"
        },
        "discountPercentage": "20",
        "discountAmount": {
          "value": "15.00",
          "currency": "USD"
        },
        "priceTreatment": "LIST_PRICE"
      },
      "condition": "New",
      "conditionId": "1000",
      "thumbnailImages": [
        {
          "imageUrl": "https://i.ebayimg.com/images/g/n**************a/s-l***0.jpg"
        }
      ],
      "shippingOptions": [
        {
          "shippingCostType": "FIXED",
          "shippingCost": {
            "value": "0.00",
            "currency": "USD"
          },
          "minEstimatedDeliveryDate": "2022-11-19T08:00:00.000Z",
          "maxEstimatedDeliveryDate": "2022-11-21T08:00:00.000Z"
        }
      ],
      "buyingOptions": [
        "FIXED_PRICE",
        "BEST_OFFER"
      ],
      "itemAffiliateWebUrl": "https://www.ebay.com/itm/1**********1?hash=i************d*9",
      "itemWebUrl": "https://www.ebay.com/itm/1**********1?hash=i************d*p",
      "itemLocation": {
        "postalCode": "0****",
        "country": "US"
      },
      "additionalImages": [
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/1**********1_2_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/1**********1_3_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/1**********1_4_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/1**********1_5_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/1**********1_6_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/1**********1_7_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/1**********1_8_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/1**********1_9_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/1**********1_10_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/1**********1_11_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/1**********1_12_0_1/225x225.jpg"
        }
      ],
      "adultOnly": false,
      "legacyItemId": "1**********1",
      "availableCoupons": false,
      "itemCreationDate": "2022-12-25T07:14:44.000Z",
      "topRatedBuyingExperience": true,
      "priorityListing": true,
      "listingMarketplaceId": "EBAY_US"
    },
    {
      "itemId": "v1|3**********8|0",
      "title": "2022 New RC Drone 4k HD Wide Angle Camera WIFI FPV Foldable Camera Quadcopter US",
      "leafCategoryIds": [
        "179697",
        "182186"
      ],
      "categories": [
        {
          "categoryId": "179697",
          "categoryName": "Camera Drones"
        },
        {
          "categoryId": "182186",
          "categoryName": "Other RC Model Vehicles & Kits"
        },
        {
          "categoryId": "2562",
          "categoryName": "Radio Control & Control Line"
        },
        {
          "categoryId": "220",
          "categoryName": "Toys & Hobbies"
        },
        {
          "categoryId": "625",
          "categoryName": "Cameras & Photo"
        },
        {
          "categoryId": "182181",
          "categoryName": "RC Model Vehicles & Kits"
        }
      ],
      "image": {
        "imageUrl": "https://i.ebayimg.com/thumbs/images/g/l***********-ms~/s-l225.jpg"
      },
      "price": {
        "value": "46.99",
        "currency": "USD"
      },
      "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1******************0",
      "seller": {
        "username": "m********e",
        "feedbackPercentage": "98.6",
        "feedbackScore": 110000
      },
      "marketingPrice": {
        "originalPrice": {
          "value": "74.99",
          "currency": "USD"
        },
        "discountPercentage": "37",
        "discountAmount": {
          "value": "28.00",
          "currency": "USD"
        },
        "priceTreatment": "LIST_PRICE"
      },
      "condition": "New",
      "conditionId": "1000",
      "thumbnailImages": [
        {
          "imageUrl": "https://i.ebayimg.com/images/g/l***********-ms~/s-***00.jpg"
        }
      ],
      "shippingOptions": [
        {
          "shippingCostType": "FIXED",
          "shippingCost": {
            "value": "0.00",
            "currency": "USD"
          },
          "minEstimatedDeliveryDate": "2022-11-19T08:00:00.000Z",
          "maxEstimatedDeliveryDate": "2022-11-21T08:00:00.000Z"
        }
      ],
      "buyingOptions": [
        "FIXED_PRICE",
        "BEST_OFFER"
      ],
      "itemAffiliateWebUrl": "https://www.ebay.com/itm/3**********8?hash=item5********8*9",
      "itemWebUrl": "https://www.ebay.com/itm/3**********8?hash=item5********8*f",
      "itemLocation": {
        "postalCode": "085**",
        "country": "US"
      },
      "additionalImages": [
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/3**********8_2_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/3**********8_3_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/3**********8_4_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/3**********8_5_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/3**********8_6_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/3**********8_7_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/3**********8_8_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/3**********8_9_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/3**********8_10_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/3**********8_11_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/3**********8_12_0_1/225x225.jpg"
        }
      ],
      "adultOnly": false,
      "legacyItemId": "3**********8",
      "availableCoupons": false,
      "itemCreationDate": "2020-01-09T17:00:16.000Z",
      "topRatedBuyingExperience": true,
      "priorityListing": true,
      "listingMarketplaceId": "EBAY_US"
    },
    {
      "itemId": "v1|3**********1|0",
      "title": "WiFi FPV RC Drone with 4K HD Camera, 40 Mins Flight Time, Foldable Drone",
      "leafCategoryIds": [
        "179697",
        "182185"
      ],
      "categories": [
        {
          "categoryId": "179697",
          "categoryName": "Camera Drones"
        },
        {
          "categoryId": "182185",
          "categoryName": "Quadcopters & Multicopters"
        },
        {
          "categoryId": "2562",
          "categoryName": "Radio Control & Control Line"
        },
        {
          "categoryId": "220",
          "categoryName": "Toys & Hobbies"
        },
        {
          "categoryId": "625",
          "categoryName": "Cameras & Photo"
        },
        {
          "categoryId": "182181",
          "categoryName": "RC Model Vehicles & Kits"
        }
      ],
      "image": {
        "imageUrl": "https://i.ebayimg.com/thumbs/images/g/Y**************M/s-l225.jpg"
      },
      "price": {
        "value": "49.99",
        "currency": "USD"
      },
      "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1%7C3**********1%7C0",
      "seller": {
        "username": "epadronics",
        "feedbackPercentage": "97.8",
        "feedbackScore": 63000
      },
      "condition": "New",
      "conditionId": "1000",
      "thumbnailImages": [
        {
          "imageUrl": "https://i.ebayimg.com/images/g/Y**************M/s-l500.jpg"
        }
      ],
      "shippingOptions": [
        {
          "shippingCostType": "FIXED",
          "shippingCost": {
            "value": "0.00",
            "currency": "USD"
          },
          "minEstimatedDeliveryDate": "2022-11-19T08:00:00.000Z",
          "maxEstimatedDeliveryDate": "2022-11-21T08:00:00.000Z"
        }
      ],
      "buyingOptions": [
        "FIXED_PRICE"
      ],
      "itemAffiliateWebUrl": "https://www.ebay.com/itm/3**********1?hash=i************9*9",
      "itemWebUrl": "https://www.ebay.com/itm/3**********1?hash=i************9*D",
      "itemLocation": {
        "postalCode": "951**",
        "country": "US"
      },
      "additionalImages": [
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/3**********1_2_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/3**********1_3_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/3**********1_4_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/3**********1_5_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/3**********1_6_0_1/225x225.jpg"
        },
        {
          "imageUrl": "https://origin-galleryplus.ebayimg.com/ws/web/3**********1_7_0_1/225x225.jpg"
        }
      ],
      "adultOnly": false,
      "legacyItemId": "3**********1",
      "availableCoupons": false,
      "itemCreationDate": "2022-06-20T21:18:54.000Z",
      "topRatedBuyingExperience": false,
      "priorityListing": true,
      "listingMarketplaceId": "EBAY_US"
    }
  ]
}

Sample 2: Search for Items by Category

This sample searches for items in the Soccer Balls category.

Input

The inputs are category_ids, limit, and offset URI parameters. There is no payload with this request.

GEThttps://api.ebay.com/buy/browse/v1/item_summary/search?category_ids=20863&limit=3&offset=9

Output

If the call is successful, soccer balls are returned. Since limit=3 and offset=9 were specified, and the offset specified is a multiple of the limit, the fourth page containing items 10 through 12 (of the total 16987 items) was returned.

{
    "href": "https://api.ebay.com/buy/browse/v1/item_summary/search?limit=3&category_ids=20863&offset=9",
    "total": 16987,
    "next": "https://api.ebay.com/buy/browse/v1/item_summary/search?limit=3&category_ids=20863&offset=12",
    "prev": "https://api.ebay.com/buy/browse/v1/item_summary/search?limit=3&category_ids=20863&offset=6",	
    "limit": 3,
    "offset": 9,
    "itemSummaries": [
        {
            "itemId": "v1|3**********0|0",
            "title": "FIFA WORLD CUP FULL SIZE SOCCER BALL INTERNATIONAL COUNTRY FLAGS OFFICIAL SIZE 5",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/g/0**********p/s-l225.jpg"
            },
            "price": {
                "value": "8.95",
                "currency": "USD"
            },
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|3**********0|0",
            "seller": {
                "username": "u***s",
                "feedbackPercentage": "99.0",
                "feedbackScore": 378908
            },
            "condition": "New",
            "conditionId": "1000",
            "thumbnailImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/N**********=/z/0iIAAOSwEzxYUFbp/$_0.JPG?set_id=8**********F"
                }
            ],
            "shippingOptions": [
                {
                    "shippingCostType": "FIXED",
                    "shippingCost": {
                        "value": "0.00",
                        "currency": "USD"
                    }
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE"
            ],
            "currentBidPrice": {
                "value": "8.95",
                "currency": "USD"
            },
            "epid": "1134280568",
            "itemWebUrl": "http://www.ebay.com/itm/FIFA-WORLD-CUP-FULL-SIZE-SOCCER-BALL-INTERNATIONAL-COUNTRY-FLAGS-OFFICIAL-SIZE-5-/3**********0?hash=item4**********p",
            "itemLocation": {
                "postalCode": "6****",
                "country": "US"
            },
            "leafCategoryIds": ["20863"],
            "categories": [
                {
                    "categoryId": "20863",
                    "categoryName": "Soccer Balls"
                },
                {
                    "categoryId": "888",
                    "categoryName": "Sporting Goods"
                },
                {
                    "categoryId": "20862",
                    "categoryName": "Soccer Equipment"
                },
                {
                    "categoryId": "159049",
                    "categoryName": "Team Sports"
                }
            ],
            "additionalImages": [
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********0_2_0_1/225x225.jpg"
                }
            ],
            "priorityListing": true,
            "adultOnly": false,
            "availableCoupons": false,
            "legacyItemId": "3**********0"
        },
        {
            "itemId": "v1|2**********8|0",
            "title": "adidas Performance Confederations Cup Glider Soccer Ball Size 1",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/g/z**********a/s-l225.jpg"
            },
            "price": {
                "value": "12.00",
                "currency": "USD"
            },
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|2**********8|0",
            "seller": {
                "username": "o***n",
                "feedbackPercentage": "99.6",
                "feedbackScore": 25208
            },
            "condition": "New",
            "conditionId": "1000",
            "thumbnailImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/M**********w/z/z~EAAOSwACZZsz4a/$_0.JPG?set_id=8**********7"
                }
            ],
            "shippingOptions": [
                {
                    "shippingCostType": "FIXED",
                    "shippingCost": {
                        "value": "0.00",
                        "currency": "USD"
                    }
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE"
            ],
            "currentBidPrice": {
                "value": "12.00",
                "currency": "USD"
            },
            "epid": "2146258740",
            "itemWebUrl": "http://www.ebay.com/itm/adidas-Performance-Confederations-Cup-Glider-Soccer-Ball-Size-1-/2**********8?hash=item3**********a",
            "itemLocation": {
                "country": "US"
            },
            "leafCategoryIds": ["20863"],
            "categories": [
                {
                    "categoryId": "20863",
                    "categoryName": "Soccer Balls"
                },
                {
                    "categoryId": "888",
                    "categoryName": "Sporting Goods"
                },
                {
                    "categoryId": "20862",
                    "categoryName": "Soccer Equipment"
                },
                {
                    "categoryId": "159049",
                    "categoryName": "Team Sports"
                }
            ],
            "additionalImages": [
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********8_2_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********8_3_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********8_4_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********8_5_0_1/225x225.jpg"
                }
            ],
            "priorityListing": true,
            "adultOnly": false,
            "availableCoupons": false,
            "legacyItemId": "2**********8"
        },
        {
            "itemId": "v1|2**********0|0",
            "title": "Adidas Champions League Official Soccer Ball Capitano Finale Cardiff 2017 Size 5",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/g/0**********X/s-l225.jpg"
            },
            "price": {
                "value": "24.99",
                "currency": "USD"
            },
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|2**********0|0",
            "seller": {
                "username": "r***0",
                "feedbackPercentage": "100.0",
                "feedbackScore": 1272
            },
            "condition": "New",
            "conditionId": "1000",
            "thumbnailImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/N**********=/z/0rUAAOSwqgRZrKHX/$_0.JPG?set_id=8**********7"
                }
            ],
            "shippingOptions": [
                {
                    "shippingCostType": "FIXED",
                    "shippingCost": {
                        "value": "0.00",
                        "currency": "USD"
                    }
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE"
            ],
            "currentBidPrice": {
                "value": "24.99",
                "currency": "USD"
            },
            "epid": "2256353041",
            "itemWebUrl": "http://www.ebay.com/itm/Adidas-Champions-League-Official-Soccer-Ball-Capitano-Finale-Cardiff-2017-Size-5-/2**********0?hash=item4**********X",
            "itemLocation": {
                "postalCode": "9****",
                "country": "US"
            },
            "leafCategoryIds": ["20863"],
            "categories": [
                {
                    "categoryId": "20863",
                    "categoryName": "Soccer Balls"
                },
                {
                    "categoryId": "888",
                    "categoryName": "Sporting Goods"
                },
                {
                    "categoryId": "20862",
                    "categoryName": "Soccer Equipment"
                },
                {
                    "categoryId": "159049",
                    "categoryName": "Team Sports"
                }
            ],
            "additionalImages": [
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********0_2_0_1/225x225.jpg"
                }
            ],
            "priorityListing": true,
            "adultOnly": false,
            "availableCoupons": false,
            "legacyItemId": "2**********0"
        }
    ]
}

Sample 3: Refine Keyword Results by Category

Using a category ID with a keyword gives you additional control over the result set. For example, let's say you are looking of a toy phone. If you search for "phone", the result set will be mobile phones because this is the "Best Match" for this search. But if you also include the toy category ID, the results will be what you wanted.

Input

The inputs are q and categoryIds URI parameters. There is no payload with this request.

GEThttps://api.ebay.com/buy/browse/v1/item_summary/search?q=phone&category_ids=220&limit=3

Output

If the call is successful, toy phones are returned.

{
    "href": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=phone&limit=3&category_ids=220&offset=0",
    "total": 20131,
    "next": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=phone&limit=3&category_ids=220&offset=3",
    "limit": 3,
    "offset": 0,
    "itemSummaries": [
        {
            "itemId": "v1|3**********1|0",
            "title": "Kids Child Screen Educational Learning Toy Simulator Music Cell Phone Touch ",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/g/1**********A/s-l225.jpg"
            },
            "price": {
                "value": "6.17",
                "currency": "USD"
            },
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|3**********1|0",
            "seller": {
                "username": "l***9",
                "feedbackPercentage": "98.7",
                "feedbackScore": 39848
            },
            "condition": "New",
            "conditionId": "1000",
            "thumbnailImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/M**********w/z/1MoAAOSwvDpbKgFA/$_0.JPG?set_id=8**********F"
                }
            ],
            "shippingOptions": [
                {
                    "shippingCostType": "FIXED",
                    "shippingCost": {
                        "value": "0.00",
                        "currency": "USD"
                    }
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE"
            ],
            "currentBidPrice": {
                "value": "6.17",
                "currency": "USD"
            },
            "itemWebUrl": "https://www.ebay.com/itm/Kids-Child-Screen-Educational-Learning-Toy-Simulator-Music-Cell-Phone-Touch/3**********1?hash=item4**********A",
            "itemLocation": {
                "country": "US"
            },
			"leafCategoryIds": ["100227"],
            "categories": [
                {
                    "categoryId": "100227",
					"categoryName": "Developmental Toys"
                },
                {
                    "categoryId": "158695",
					"categoryName": "Electronic Learning Systems"
                },
                {
                    "categoryId": "220",
					"categoryName": "Toys & Hobbies"
                },
                {
                    "categoryId": "2984",
					"categoryName": "Baby Essentials"
                },
                {
                    "categoryId": "11731",
					"categoryName": "Educational Toys"
                },
                {
                    "categoryId": "19068",
					"categoryName": "Baby Toys"
                },
                {
                    "categoryId": "177915",
					"categoryName": "Electronic Learning Toys"
                }
            ],
            "additionalImages": [
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********1_2_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********1_3_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********1_4_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********1_5_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********1_6_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/33**********1_7_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********1_8_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********1_9_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********1_10_0_1/225x225.jpg"
                }
            ],
            "priorityListing": true,
            "adultOnly": false,
			"availableCoupons": false,
            "priorityListing": false,
			"legacyItemId": "3**********1"
        },
        {
            "itemId": "v1|1**********4|0",
            "title": "Vintage 1996 MB Electronic Dream Phone Board Game Missing 1 Card Works",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/g/8**********R/s-l225.jpg"
            },
            "price": {
                "value": "49.99",
                "currency": "USD"
            },
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|1**********4|0",
            "seller": {
                "username": "m***n",
                "feedbackPercentage": "99.9",
                "feedbackScore": 3032
            },
            "condition": "Used",
            "conditionId": "3000",
            "thumbnailImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/M**********4/z/8UoAAOSw5KFbSTBR/$_0.JPG?set_id=8**********F"
                }
            ],
            "shippingOptions": [
                {
                    "shippingCostType": "FIXED",
                    "shippingCost": {
                        "value": "0.00",
                        "currency": "USD"
                    }
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE"
            ],
            "currentBidPrice": {
                "value": "49.99",
                "currency": "USD"
            },
            "itemWebUrl": "https://www.ebay.com/itm/Vintage-1996-MB-Electronic-Dream-Phone-Board-Game-Missing-1-Card-Works/1**********4?hash=item2**********R",
            "itemLocation": {
                "postalCode": "2****",
                "country": "US"
            },
			"leafCategoryIds": ["180349"],
            "categories": [
                {
                    "categoryId": "180349",
					"categoryName": "Contemporary Manufacture Board & Traditional Games"
                },
                {
                    "categoryId": "220",
					"categoryName": "Toys & Hobbies"
                },
                {
                    "categoryId": "233",
					"categoryName": "Games"
                },
                {
                    "categoryId": "2550",
					"categoryName": "Board & Traditional Games"
                }
            ],
            "additionalImages": [
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_2_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_3_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_4_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_5_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_6_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_7_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_8_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_9_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_10_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_11_0_1/225x225.jpg"
                }
            ],
            "priorityListing": true,
            "adultOnly": false,
			"availableCoupons": false,
            "priorityListing": false,
			"legacyItemId": "1**********4"
        },
        {
            "itemId": "v1|1**********1|0",
            "title": "LeapFrog Chat and Count Smart Phone ~ Leap Frog Scout 18+ Months NEW IN PACKAGE",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/g/N**********5/s-l225.jpg"
            },
            "price": {
                "value": "8.50",
                "currency": "USD"
            },
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|1**********1|0",
            "seller": {
                "username": "k***n",
                "feedbackPercentage": "100.0",
                "feedbackScore": 215
            },
            "condition": "New",
            "conditionId": "1000",
            "thumbnailImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/M**********w/z/Nl0AAOSwzQ1bPXG5/$_0.JPG?set_id=8**********F"
                }
            ],
            "shippingOptions": [
                {
                    "shippingCostType": "FIXED",
                    "shippingCost": {
                        "value": "5.00",
                        "currency": "USD"
                    }
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE"
            ],
            "currentBidPrice": {
                "value": "8.50",
                "currency": "USD"
            },
            "epid": "1286192725",
            "itemWebUrl": "https://www.ebay.com/itm/LeapFrog-Chat-and-Count-Smart-Phone-Leap-Frog-Scout-18-Months-NEW-IN-PACKAGE/1**********1?hash=item2**********5",
            "itemLocation": {
                "postalCode": "2****",
                "country": "US"
            },
			"leafCategoryIds": ["19181"],
            "categories": [
                {
                    "categoryId": "19181",
					"categoryName": "Other Preschool & Pretend Play Toys"
                },
                {
                    "categoryId": "220",
					"categoryName": "Toys & Hobbies"
                },
                {
                    "categoryId": "19169",
					"categoryName": "Preschool Toys & Pretend Play"
                }
            ],
            "additionalImages": [
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********1_2_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********1_3_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********1_4_0_1/225x225.jpg"
                }
            ],
            "priorityListing": true,
            "adultOnly": false,
			"availableCoupons": false,
            "priorityListing": false,
			"legacyItemId": "1**********1"
        }
    ]
}

Sample 4: Retrieve the Item Aspects by Keyword Search

This call searches for drones. Based on the results of that search, it returns the dominant category ID, which is the category most of the items are in and the aspect refinements for this category.

Input

The inputs are q and fieldgroups=ASPECT_REFINEMENTS URI parameters. There is no payload with this request.

GEThttps://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&fieldgroups=ASPECT_REFINEMENTS

Output

If the call is successful, the dominantCategoryId field, which we will use in the next sample, and the aspectDistributions container are returned.

{
    "href": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&offset=0",
    "total": 163543,
    "limit": 50,
    "offset": 0,
    "refinement": {
        "dominantCategoryId": "179697",
        "aspectDistributions": [
            {
                "localizedAspectName": "Camera Features",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "4K HD Video Recording",
                        "matchCount": 1014,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Camera%20Features%3A%7B4K%20HD%20Video%20Recording%7D"
                    },
                    {
                        "localizedAspectValue": "2.7K HD Video Recording",
                        "matchCount": 342,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Camera%20Features%3A%7B2%2E7K%20HD%20Video%20Recording%7D"
                    },
                    {
                        "localizedAspectValue": "1080p HD Video Recording",
                        "matchCount": 1292,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Camera%20Features%3A%7B1080p%20HD%20Video%20Recording%7D"
                    },
                    {
                        "localizedAspectValue": "720p HD Video Recording",
                        "matchCount": 1770,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Camera%20Features%3A%7B720p%20HD%20Video%20Recording%7D"
                    },
                    {
                        "localizedAspectValue": "GoPro Compatible",
                        "matchCount": 450,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Camera%20Features%3A%7BGoPro%20Compatible%7D"
                    },
                    {
                        "localizedAspectValue": "Wide Angle Lens",
                        "matchCount": 559,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Camera%20Features%3A%7BWide%20Angle%20Lens%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Connectivity",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "APP Controller",
                        "matchCount": 1876,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Connectivity%3A%7BAPP%20Controller%7D"
                    },
                    {
                        "localizedAspectValue": "Remote Control",
                        "matchCount": 3400,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Connectivity%3A%7BRemote%20Control%7D"
                    },
                    {
                        "localizedAspectValue": "Wi-Fi Connection",
                        "matchCount": 2370,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Connectivity%3A%7BWi%2DFi%20Connection%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Brand",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "3d Robotics",
                        "matchCount": 243,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7B3d%20Robotics%7D"
                    },
                    {
                        "localizedAspectValue": "DJI",
                        "matchCount": 2040,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BDJI%7D"
                    },
                    {
                        "localizedAspectValue": "GoPro",
                        "matchCount": 34,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BGoPro%7D"
                    },
                    {
                        "localizedAspectValue": "Hubsan",
                        "matchCount": 134,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BHubsan%7D"
                    },
                    {
                        "localizedAspectValue": "Parrot",
                        "matchCount": 302,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BParrot%7D"
                    },
                    {
                        "localizedAspectValue": "Syma",
                        "matchCount": 323,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BSyma%7D"
                    },
                    {
                        "localizedAspectValue": "Unbranded/Generic",
                        "matchCount": 1333,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BUnbranded%2FGeneric%7D"
                    },
                    {
                        "localizedAspectValue": "Yuneec",
                        "matchCount": 177,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BYuneec%7D"
                    },
                    {
                        "localizedAspectValue": "Autel Robotics",
                        "matchCount": 48,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BAutel%20Robotics%7D"
                    },
                    {
                        "localizedAspectValue": "Best Choice Products",
                        "matchCount": 6,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BBest%20Choice%20Products%7D"
                    },
                    {
                        "localizedAspectValue": "Blade",
                        "matchCount": 46,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BBlade%7D"
                    },
                    {
                        "localizedAspectValue": "Dromida",
                        "matchCount": 45,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BDromida%7D"
                    },
                    {
                        "localizedAspectValue": "Eachine",
                        "matchCount": 31,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BEachine%7D"
                    },
                    {
                        "localizedAspectValue": "E-Flite",
                        "matchCount": 7,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BE%2DFlite%7D"
                    },
                    {
                        "localizedAspectValue": "JJRC",
                        "matchCount": 223,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BJJRC%7D"
                    },
                    {
                        "localizedAspectValue": "Monster",
                        "matchCount": 1,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BMonster%7D"
                    },
                    {
                        "localizedAspectValue": "Propel",
                        "matchCount": 61,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BPropel%7D"
                    },
                    {
                        "localizedAspectValue": "Red",
                        "matchCount": 9,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BRed%7D"
                    },
                    {
                        "localizedAspectValue": "Solo",
                        "matchCount": 39,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BSolo%7D"
                    },
                    {
                        "localizedAspectValue": "Swift Stream",
                        "matchCount": 129,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BSwift%20Stream%7D"
                    },
                    {
                        "localizedAspectValue": "Vivitar",
                        "matchCount": 11,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BVivitar%7D"
                    },
                    {
                        "localizedAspectValue": "Walkera",
                        "matchCount": 94,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BWalkera%7D"
                    },
                    {
                        "localizedAspectValue": "WLtoys",
                        "matchCount": 19,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BWLtoys%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 5223,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7B!%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Type",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "DIY Drone Kit",
                        "matchCount": 234,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Type%3A%7BDIY%20Drone%20Kit%7D"
                    },
                    {
                        "localizedAspectValue": "Ready to Fly Drone",
                        "matchCount": 3381,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Type%3A%7BReady%20to%20Fly%20Drone%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 7345,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Type%3A%7B!%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Maximum Flight Time",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "5-10min.",
                        "matchCount": 660,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Flight%20Time%3A%7B5%2D10min%2E%7D"
                    },
                    {
                        "localizedAspectValue": "11-20min.",
                        "matchCount": 260,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Flight%20Time%3A%7B11%2D20min%2E%7D"
                    },
                    {
                        "localizedAspectValue": "21-25min.",
                        "matchCount": 134,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Flight%20Time%3A%7B21%2D25min%2E%7D"
                    },
                    {
                        "localizedAspectValue": "26-30min.",
                        "matchCount": 194,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Flight%20Time%3A%7B26%2D30min%2E%7D"
                    },
                    {
                        "localizedAspectValue": "31-35min.",
                        "matchCount": 2,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Flight%20Time%3A%7B31%2D35min%2E%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 8199,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Flight%20Time%3A%7B!%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Bundle Listing",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "No",
                        "matchCount": 1243,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Bundle%20Listing%3A%7BNo%7D"
                    },
                    {
                        "localizedAspectValue": "Yes",
                        "matchCount": 703,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Bundle%20Listing%3A%7BYes%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 9446,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Bundle%20Listing%3A%7B!%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Maximum Control Range",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "<165ft. (50m)",
                        "matchCount": 119,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Control%20Range%3A%7B%3C165ft%2E%20%2850m%29%7D"
                    },
                    {
                        "localizedAspectValue": "165-426ft. (50-130m)",
                        "matchCount": 567,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Control%20Range%3A%7B165%2D426ft%2E%20%2850%2D130m%29%7D"
                    },
                    {
                        "localizedAspectValue": "427-984ft. (131-300m)",
                        "matchCount": 111,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Control%20Range%3A%7B427%2D984ft%2E%20%28131%2D300m%29%7D"
                    },
                    {
                        "localizedAspectValue": "985-1640ft. (301-500m)",
                        "matchCount": 25,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Control%20Range%3A%7B985%2D1640ft%2E%20%28301%2D500m%29%7D"
                    },
                    {
                        "localizedAspectValue": "1641-3280ft. (501-1000m)",
                        "matchCount": 74,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Control%20Range%3A%7B1641%2D3280ft%2E%20%28501%2D1000m%29%7D"
                    },
                    {
                        "localizedAspectValue": ">16404ft. (5000m)",
                        "matchCount": 31,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Control%20Range%3A%7B%3E16404ft%2E%20%285000m%29%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 9030,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Control%20Range%3A%7B!%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Camera Integration",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "Camera Included",
                        "matchCount": 9628,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Camera%20Integration%3A%7BCamera%20Included%7D"
                    },
                    {
                        "localizedAspectValue": "Camera Not Included",
                        "matchCount": 412,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Camera%20Integration%3A%7BCamera%20Not%20Included%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 1352,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,Camera%20Integration%3A%7B!%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "FPV Operation",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "Yes",
                        "matchCount": 9592,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,FPV%20Operation%3A%7BYes%7D"
                    },
                    {
                        "localizedAspectValue": "No",
                        "matchCount": 218,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,FPV%20Operation%3A%7BNo%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 1582,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=50&fieldgroups=ASPECT_REFINEMENTS&aspect_filter=categoryId%3A179697,FPV%20Operation%3A%7B!%7D"
                    }
                ]
            }
        ]
    }
}

Sample 5: Return All Refinements For a Category

This call retrieves all the refinements for the category submitted. We used the category ID returned by the previous sample in the dominantCategoryId field.

If you wanted to return the refinement and the items, you would replace fieldgroups=ASPECT_REFINEMENTS,CATEGORY_REFINEMENTS,CONDITION_REFINEMENTS,BUYING_OPTION_REFINEMENTS fieldgroups=FULL.

Input

The inputs are q and fieldgroups URI parameters. There is no payload with this request.

GEThttps://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS,CATEGORY_REFINEMENTS,CONDITION_REFINEMENTS,BUYING_OPTION_REFINEMENTS

Output

If the call is successful, the dominantCategoryId field is return, which is the category that was submitted in the call. The categoryDistributions container is return, which shows the category name. The conditionDistributions buyingOptionDistributions aspectDistributions containers are returned, which contain all the refinements for the category. You can use response from this call to create a histogram for this category, which gives your shoppers the ability to browse the items and further refine the results.

{
    "href": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&offset=0",
    "total": 11390,
    "limit": 3,
    "offset": 0,
    "refinement": {
        "dominantCategoryId": "179697",
        "categoryDistributions": [
            {
                "categoryName": "Camera Drones",
                "categoryId": "179697",
                "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&category_ids=179697"
            }
        ],
        "conditionDistributions": [
            {
                "condition": "New",
                "conditionId": "1000",
                "matchCount": 10360,
                "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&filter=conditionIds%3A%7B1000%7D"
            },
            {
                "condition": "New other (see details)",
                "conditionId": "1500",
                "matchCount": 340,
                "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&filter=conditionIds%3A%7B1500%7D"
            },
            {
                "condition": "Manufacturer refurbished",
                "conditionId": "2000",
                "matchCount": 78,
                "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&filter=conditionIds%3A%7B2000%7D"
            },
            {
                "condition": "Seller refurbished",
                "conditionId": "2500",
                "matchCount": 30,
                "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&filter=conditionIds%3A%7B2500%7D"
            },
            {
                "condition": "Used",
                "conditionId": "3000",
                "matchCount": 525,
                "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&filter=conditionIds%3A%7B3000%7D"
            },
            {
                "condition": "For parts or not working",
                "conditionId": "7000",
                "matchCount": 57,
                "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&filter=conditionIds%3A%7B7000%7D"
            }
        ],
        "buyingOptionDistributions": [
            {
                "buyingOption": "AUCTION",
                "matchCount": 504,
                "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&filter=buyingOptions%3A%7BAUCTION%7D"
            },
            {
                "buyingOption": "FIXED_PRICE",
                "matchCount": 11394,
                "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&filter=buyingOptions%3A%7BFIXED_PRICE%7D"
            }
        ],
        "aspectDistributions": [
            {
                "localizedAspectName": "Camera Features",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "4K HD Video Recording",
                        "matchCount": 1014,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Camera%20Features%3A%7B4K%20HD%20Video%20Recording%7D"
                    },
                    {
                        "localizedAspectValue": "2.7K HD Video Recording",
                        "matchCount": 342,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Camera%20Features%3A%7B2%2E7K%20HD%20Video%20Recording%7D"
                    },
                    {
                        "localizedAspectValue": "1080p HD Video Recording",
                        "matchCount": 1292,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Camera%20Features%3A%7B1080p%20HD%20Video%20Recording%7D"
                    },
                    {
                        "localizedAspectValue": "720p HD Video Recording",
                        "matchCount": 1770,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Camera%20Features%3A%7B720p%20HD%20Video%20Recording%7D"
                    },
                    {
                        "localizedAspectValue": "GoPro Compatible",
                        "matchCount": 450,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Camera%20Features%3A%7BGoPro%20Compatible%7D"
                    },
                    {
                        "localizedAspectValue": "Wide Angle Lens",
                        "matchCount": 559,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Camera%20Features%3A%7BWide%20Angle%20Lens%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Connectivity",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "APP Controller",
                        "matchCount": 1876,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Connectivity%3A%7BAPP%20Controller%7D"
                    },
                    {
                        "localizedAspectValue": "Remote Control",
                        "matchCount": 3400,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Connectivity%3A%7BRemote%20Control%7D"
                    },
                    {
                        "localizedAspectValue": "Wi-Fi Connection",
                        "matchCount": 2370,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Connectivity%3A%7BWi%2DFi%20Connection%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Brand",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "3d Robotics",
                        "matchCount": 243,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7B3d%20Robotics%7D"
                    },
                    {
                        "localizedAspectValue": "DJI",
                        "matchCount": 2040,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BDJI%7D"
                    },
                    {
                        "localizedAspectValue": "GoPro",
                        "matchCount": 34,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BGoPro%7D"
                    },
                    {
                        "localizedAspectValue": "Hubsan",
                        "matchCount": 134,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BHubsan%7D"
                    },
                    {
                        "localizedAspectValue": "Parrot",
                        "matchCount": 302,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BParrot%7D"
                    },
                    {
                        "localizedAspectValue": "Syma",
                        "matchCount": 323,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BSyma%7D"
                    },
                    {
                        "localizedAspectValue": "Unbranded/Generic",
                        "matchCount": 1333,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BUnbranded%2FGeneric%7D"
                    },
                    {
                        "localizedAspectValue": "Yuneec",
                        "matchCount": 177,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BYuneec%7D"
                    },
                    {
                        "localizedAspectValue": "Autel Robotics",
                        "matchCount": 48,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BAutel%20Robotics%7D"
                    },
                    {
                        "localizedAspectValue": "Best Choice Products",
                        "matchCount": 6,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BBest%20Choice%20Products%7D"
                    },
                    {
                        "localizedAspectValue": "Blade",
                        "matchCount": 46,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BBlade%7D"
                    },
                    {
                        "localizedAspectValue": "Dromida",
                        "matchCount": 45,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BDromida%7D"
                    },
                    {
                        "localizedAspectValue": "Eachine",
                        "matchCount": 31,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BEachine%7D"
                    },
                    {
                        "localizedAspectValue": "E-Flite",
                        "matchCount": 7,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BE%2DFlite%7D"
                    },
                    {
                        "localizedAspectValue": "JJRC",
                        "matchCount": 223,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BJJRC%7D"
                    },
                    {
                        "localizedAspectValue": "Monster",
                        "matchCount": 1,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BMonster%7D"
                    },
                    {
                        "localizedAspectValue": "Propel",
                        "matchCount": 61,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BPropel%7D"
                    },
                    {
                        "localizedAspectValue": "Red",
                        "matchCount": 9,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BRed%7D"
                    },
                    {
                        "localizedAspectValue": "Solo",
                        "matchCount": 39,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BSolo%7D"
                    },
                    {
                        "localizedAspectValue": "Swift Stream",
                        "matchCount": 129,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BSwift%20Stream%7D"
                    },
                    {
                        "localizedAspectValue": "Vivitar",
                        "matchCount": 11,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BVivitar%7D"
                    },
                    {
                        "localizedAspectValue": "Walkera",
                        "matchCount": 94,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BWalkera%7D"
                    },
                    {
                        "localizedAspectValue": "WLtoys",
                        "matchCount": 19,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7BWLtoys%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 5224,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Brand%3A%7B!%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Type",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "DIY Drone Kit",
                        "matchCount": 234,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Type%3A%7BDIY%20Drone%20Kit%7D"
                    },
                    {
                        "localizedAspectValue": "Ready to Fly Drone",
                        "matchCount": 3381,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Type%3A%7BReady%20to%20Fly%20Drone%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 7347,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Type%3A%7B!%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Maximum Flight Time",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "5-10min.",
                        "matchCount": 660,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Flight%20Time%3A%7B5%2D10min%2E%7D"
                    },
                    {
                        "localizedAspectValue": "11-20min.",
                        "matchCount": 260,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Flight%20Time%3A%7B11%2D20min%2E%7D"
                    },
                    {
                        "localizedAspectValue": "21-25min.",
                        "matchCount": 134,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Flight%20Time%3A%7B21%2D25min%2E%7D"
                    },
                    {
                        "localizedAspectValue": "26-30min.",
                        "matchCount": 194,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Flight%20Time%3A%7B26%2D30min%2E%7D"
                    },
                    {
                        "localizedAspectValue": "31-35min.",
                        "matchCount": 2,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Flight%20Time%3A%7B31%2D35min%2E%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 8201,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Flight%20Time%3A%7B!%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Bundle Listing",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "No",
                        "matchCount": 1243,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Bundle%20Listing%3A%7BNo%7D"
                    },
                    {
                        "localizedAspectValue": "Yes",
                        "matchCount": 703,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Bundle%20Listing%3A%7BYes%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 9448,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Bundle%20Listing%3A%7B!%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Maximum Control Range",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "<165ft. (50m)",
                        "matchCount": 119,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Control%20Range%3A%7B%3C165ft%2E%20%2850m%29%7D"
                    },
                    {
                        "localizedAspectValue": "165-426ft. (50-130m)",
                        "matchCount": 567,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Control%20Range%3A%7B165%2D426ft%2E%20%2850%2D130m%29%7D"
                    },
                    {
                        "localizedAspectValue": "427-984ft. (131-300m)",
                        "matchCount": 111,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Control%20Range%3A%7B427%2D984ft%2E%20%28131%2D300m%29%7D"
                    },
                    {
                        "localizedAspectValue": "985-1640ft. (301-500m)",
                        "matchCount": 25,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Control%20Range%3A%7B985%2D1640ft%2E%20%28301%2D500m%29%7D"
                    },
                    {
                        "localizedAspectValue": "1641-3280ft. (501-1000m)",
                        "matchCount": 74,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Control%20Range%3A%7B1641%2D3280ft%2E%20%28501%2D1000m%29%7D"
                    },
                    {
                        "localizedAspectValue": ">16404ft. (5000m)",
                        "matchCount": 31,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Control%20Range%3A%7B%3E16404ft%2E%20%285000m%29%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 9032,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Maximum%20Control%20Range%3A%7B!%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "Camera Integration",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "Camera Included",
                        "matchCount": 9629,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Camera%20Integration%3A%7BCamera%20Included%7D"
                    },
                    {
                        "localizedAspectValue": "Camera Not Included",
                        "matchCount": 412,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Camera%20Integration%3A%7BCamera%20Not%20Included%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 1353,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,Camera%20Integration%3A%7B!%7D"
                    }
                ]
            },
            {
                "localizedAspectName": "FPV Operation",
                "aspectValueDistributions": [
                    {
                        "localizedAspectValue": "Yes",
                        "matchCount": 9593,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,FPV%20Operation%3A%7BYes%7D"
                    },
                    {
                        "localizedAspectValue": "No",
                        "matchCount": 218,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,FPV%20Operation%3A%7BNo%7D"
                    },
                    {
                        "localizedAspectValue": "Not Specified",
                        "matchCount": 1583,
                        "refinementHref": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=ASPECT_REFINEMENTS%2CCATEGORY_REFINEMENTS%2CCONDITION_REFINEMENTS%2CBUYING_OPTION_REFINEMENTS&aspect_filter=categoryId%3A179697,FPV%20Operation%3A%7B!%7D"
                    }
                ]
            }
        ]
    }
}

Sample 6: Filter the Keyword Results by Item Aspects

This call searches for drones and returns only the items within the category and the item aspects specified. Because fieldgroups is set to EXTENDED it also returns the shortDescription and itemLocation.city fields.

Input

The inputs are q, category_ids, fieldgroups and aspect_filter URI parameters. There is no payload with this request.

Note: As with all query parameter values, the filter parameters must be URL encoded. But for readability in the request below, the encoding has been omitted. For more information about encoding request parameters, see URL encoding query parameter values.

The first line of the response is the encoded request.

GEThttps://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&category_ids=179697&limit=3&fieldgroups=EXTENDED,MATCHING_ITEMS&aspect_filter=categoryId:179697,conditionDistributions:{NEW},Connectivity:{App Controller},Camera Integration:{Camera Included},Type:{Ready to Fly Drone}

Output

If the call is successful, a paged collection of items matching the criteria are returned.

{
    "href": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=EXTENDED%2CMATCHING_ITEMS&aspect_filter=categoryId%3A179697%2CconditionDistributions%3A%7BNEW%7D%2CConnectivity%3A%7BApp%20Controller%7D%2CCamera%20Integration%3A%7BCamera%20Included%7D%2CType%3A%7BReady%20to%20Fly%20Drone%7D&offset=0",
    "total": 3737,
    "next": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&category_ids=179697&fieldgroups=EXTENDED%2CMATCHING_ITEMS&aspect_filter=categoryId%3A179697%2CconditionDistributions%3A%7BNEW%7D%2CConnectivity%3A%7BApp%20Controller%7D%2CCamera%20Integration%3A%7BCamera%20Included%7D%2CType%3A%7BReady%20to%20Fly%20Drone%7D&offset=3",
    "limit": 3,
    "offset": 0,
    "itemSummaries": [
        {
            "itemId": "v1|3**********7|0",
            "title": "DJI Phantom 3 Standard Drone 2.7K Camera Quadcopter - CP.PT.000455",
            "shortDescription": "DJI Phantom 3 Standard Quadcopter Drone. This DJI Drones Phantom 3 Standard Quadcopter is in great overall working condition. DJI Drones CP.PT.000455 Phantom 3 Standard Quadcopter Features 4 x 9450 Self-Tightening Propeller Set for Phantom 3 (Part 9).",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/g/e**********K/s-l225.jpg"
            },
            "price": {
                "value": "369.99",
                "currency": "USD"
            },
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|3**********7|0",
            "seller": {
                "username": "h***s",
                "feedbackPercentage": "99.2",
                "feedbackScore": 40624
            },
            "condition": "Used",
            "conditionId": "3000",
            "thumbnailImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/N**********=/z/e58AAOSwJ-pbGsNK/$_0.PNG?set_id=8**********7"
                }
            ],
            "shippingOptions": [
                {
                    "shippingCostType": "FIXED",
                    "shippingCost": {
                        "value": "0.00",
                        "currency": "USD"
                    }
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE"
            ],
            "currentBidPrice": {
                "value": "369.99",
                "currency": "USD"
            },
            "epid": "541323984",
            "itemWebUrl": "https://www.ebay.com/itm/DJI-Phantom-3-Standard-Drone-2-7K-Camera-Quadcopter-CP-PT-000455/3**********7?hash=item5**********K",
            "itemLocation": {
                "city": "W**********e",
                "postalCode": "6****",
                "country": "US"
            },
			"leafCategoryIds": ["179697"],
            "categories": [
                {
                    "categoryId": "179697",
					"categoryName": "Camera Drones"
                },
                {
                    "categoryId": "625",
					"categoryName": "Cameras & Photo"
                }
            ],
            "additionalImages": [
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********7_2_0_1/225x225.jpg"
                }
            ],
            "priorityListing": true,
            "adultOnly": false,
			"availableCoupons": false,
            "priorityListing": false,
			"legacyItemId": "3**********7"
        },
        {
            "itemId": "v1|2**********4|0",
            "title": "DJI Mavic Pro Folding Drone - 4K Stabilized Camera, GPS",
            "shortDescription": "Model: DJI Mavic ProFeatures:The DJI Mavic Pro folds down as small as a bottle of water, making it small enough to bring with you everywhere.New OcuSync transmission system offers up to 4.3 miles (7km) of transmission range.Fly at up to 40mph (64kmh) or for as long as 27-minutes.True 4K, fully stabilized ensures smooth footageActiveTrack, TapFly and other smart features make professional looking video effortless.Obstacle Avoidance combined with sensor redundancy increases flight safety and reliability.Vision positioning paired with GPS and GLONASS ensures.",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/g/k**********X/s-l225.jpg"
            },
            "price": {
                "value": "799.00",
                "currency": "USD"
            },
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|2**********4|0",
            "seller": {
                "username": "c***s",
                "feedbackPercentage": "99.1",
                "feedbackScore": 26672
            },
            "marketingPrice": {
                "originalPrice": {
                    "value": "1299.99",
                    "currency": "USD"
                },
                "discountPercentage": "39",
                "discountAmount": {
                    "value": "500.99",
                    "currency": "USD"
                }
            },
            "condition": "New",
            "conditionId": "1000",
            "thumbnailImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/M**********w/z/kSIAAOSwrnRaYJ3X/$_0.PNG?set_id=8**********F"
                }
            ],
            "shippingOptions": [
                {
                    "shippingCostType": "FIXED",
                    "shippingCost": {
                        "value": "0.00",
                        "currency": "USD"
                    }
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE"
            ],
            "currentBidPrice": {
                "value": "799.00",
                "currency": "USD"
            },
            "epid": "6019370475",
            "itemWebUrl": "https://www.ebay.com/itm/DJI-Mavic-Pro-Folding-Drone-4K-Stabilized-Camera-GPS/2**********4?hash=item3**********X",
            "itemLocation": {
                "city": "P**********a",
                "postalCode": "1****",
                "country": "US"
            },
			"leafCategoryIds": ["179697"],
            "categories": [
                {
                    "categoryId": "179697",
					"categoryName": "Camera Drones"
                },
                {
                    "categoryId": "625",
					"categoryName": "Cameras & Photo"
                }
            ],
            "additionalImages": [
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********4_2_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********4_3_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********4_4_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********4_5_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********4_6_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********4_7_0_1/225x225.jpg"
                }
            ],
            "priorityListing": true,
            "adultOnly": false,
			"availableCoupons": false,
            "priorityListing": false,
			"legacyItemId": "2**********4"
        },
        {
            "itemId": "v1|2**********6|0",
            "title": "AEE AP11 Pro 3-Axis  Quadcopter 1080p Full HD Drone Q with 16MP Action Camera",
            "shortDescription": "Take Vivid 16MP Photos. Drone body. Class 4 Wind Resistance. Maximum Speed of 44mph. Tool set. Maximum Ascent Speed 26.2 ft/s / 8 m/s. AC Input Power 100 to 240 VAC, 50 / 60 Hz. Color White.",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/g/w**********j/s-l225.jpg"
            },
            "price": {
                "value": "199.99",
                "currency": "USD"
            },
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|2**********6|0",
            "seller": {
                "username": "w***n",
                "feedbackPercentage": "99.4",
                "feedbackScore": 69446
            },
            "marketingPrice": {
                "originalPrice": {
                    "value": "449.99",
                    "currency": "USD"
                },
                "discountPercentage": "56",
                "discountAmount": {
                    "value": "250.00",
                    "currency": "USD"
                }
            },
            "condition": "New",
            "conditionId": "1000",
            "thumbnailImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/M**********w/z/wEYAAOSwdTZbHvCj/$_0.JPG?set_id=8**********F"
                }
            ],
            "shippingOptions": [
                {
                    "shippingCostType": "FIXED",
                    "shippingCost": {
                        "value": "0.00",
                        "currency": "USD"
                    }
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE"
            ],
            "currentBidPrice": {
                "value": "199.99",
                "currency": "USD"
            },
            "epid": "23017627631",
            "itemWebUrl": "https://www.ebay.com/itm/AEE-AP11-Pro-3-Axis-Quadcopter-1080p-Full-HD-Drone-Q-with-16MP-Action-Camera/2**********6?hash=item2**********j",
            "itemLocation": {
                "city": "N**********e",
                "postalCode": "3****",
                "country": "US"
            },
			"leafCategoryIds": ["179697"],
            "categories": [
                {
                    "categoryId": "179697",
					"categoryName": "Camera Drones"
                },
                {
                    "categoryId": "625",
					"categoryName": "Cameras & Photo"
                }
            ],
            "additionalImages": [
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********6_2_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********6_3_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********6_4_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********6_5_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********6_6_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********6_7_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********6_8_0_1/225x225.jpg"
                }
            ],
            "priorityListing": true,
            "adultOnly": false,
			"availableCoupons": false,
            "priorityListing": false,
			"legacyItemId": "2**********6"
        }
    ]
}

Sample 7: Return Items with Free Shipping

This call searches for drones and returns only the items that offer free shipping.

Input

The inputs are q and filter=maxDeliveryCost URI parameters. There is no payload with this request.

GEThttps://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&filter=maxDeliveryCost:0

Output

If the call is successful, three items that have free shipping (shippingOptions.shippingCost.value is 0) are returned.

{
    "href": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&filter=maxDeliveryCost%3A0&offset=0",
    "total": 124643,
    "next": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=3&filter=maxDeliveryCost%3A0&offset=3",
    "limit": 3,
    "offset": 0,
    "itemSummaries": [
        {
            "itemId": "v1|2**********6|0",
            "title": "DJI Mavic Air - Onyx Black Drone - 4K Camera, 32MP Sphere Panoramas!",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/g/L**********5.jpg"
            },
            "price": {
                "value": "799.00",
                "currency": "USD"
            },
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|2**********6|0",
            "seller": {
                "username": "c***s",
                "feedbackPercentage": "99.0",
                "feedbackScore": 24882
            },
            "marketingPrice": {
                "originalPrice": {
                    "value": "999.00",
                    "currency": "USD"
                },
                "discountPercentage": "20",
                "discountAmount": {
                    "value": "200.00",
                    "currency": "USD"
                }
            },
            "condition": "New",
            "conditionId": "1000",
            "thumbnailImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/M**********w/z/LtkAAOSwXkNab2Ga/$_0.JPG?set_id=8**********F"
                }
            ],
            "shippingOptions": [
                {
                    "shippingCostType": "FIXED",
                    "shippingCost": {
                        "value": "0.00",
                        "currency": "USD"
                    }
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE"
            ],
            "currentBidPrice": {
                "value": "799.00",
                "currency": "USD"
            },
            "epid": "14013624047",
            "itemWebUrl": "https://www.ebay.com/itm/DJI-Mavic-Air-Onyx-Black-Drone-4K-Camera-32MP-Sphere-Panoramas/2**********6?hash=item3**********a",
            "itemLocation": {
                "postalCode": "1****",
                "country": "US"
            },
			"leafCategoryIds": ["179697"],
            "categories": [
                {
                    "categoryId": "179697",
					"categoryName": "Camera Drones"
                },
                {
                    "categoryId": "625",
					"categoryName": "Cameras & Photo"
                }
            ],
            "additionalImages": [
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********6_2_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********6_3_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********6_4_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********6_5_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********6_6_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********6_7_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********6_8_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********6_9_0_1/225x225.jpg"
                }
            ],
            "priorityListing": true,
            "adultOnly": false,
			"availableCoupons": false,
            "priorityListing": false,
			"legacyItemId": "2**********6"
        },
        {
            "itemId": "v1|2**********3|0",
            "title": "Syma X5SW-V3 Wifi FPV Explorers 2.4G 4CH RC Quadcopter Drone HD Camera UFO Black",
            "subtitle": "Over 6500 Sold ! Wifi FPV Real-Time!US STOCK/FAST SHIP",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/g/z**********F/s-l225.jpg"
            },
            "price": {
                "value": "34.99",
                "currency": "USD"
            },
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|2**********3|0",
            "seller": {
                "username": "e***t",
                "feedbackPercentage": "99.2",
                "feedbackScore": 139772
            },
            "marketingPrice": {
                "originalPrice": {
                    "value": "91.64",
                    "currency": "USD"
                },
                "discountPercentage": "62",
                "discountAmount": {
                    "value": "56.65",
                    "currency": "USD"
                }
            },
            "condition": "New",
            "conditionId": "1000",
            "thumbnailImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/M**********w/z/ztoAAOSw~3paeeOF/$_0.JPG?set_id=8**********F"
                }
            ],
            "shippingOptions": [
                {
                    "shippingCostType": "FIXED",
                    "shippingCost": {
                        "value": "0.00",
                        "currency": "USD"
                    }
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE"
            ],
            "currentBidPrice": {
                "value": "34.99",
                "currency": "USD"
            },
            "epid": "28005982293",
            "itemWebUrl": "https://www.ebay.com/itm/Syma-X5SW-V3-Wifi-FPV-Explorers-2-4G-4CH-RC-Quadcopter-Drone-HD-Camera-UFO-Black/2**********3?hash=item4**********F",
            "itemLocation": {
                "postalCode": "9****",
                "country": "US"
            },
			"leafCategoryIds": ["179697","182185"],
            "categories": [
                {
                    "categoryId": "182185",
					"categoryName": "Quadcopters & Multicopters"
                },
                {
                    "categoryId": "179697",
					"categoryName": "Camera Drones"
                },
                {
                    "categoryId": "220",
					"categoryName": "Toys & Hobbies"
                },
                {
                    "categoryId": "625",
					"categoryName": "Cameras & Photo"
                },
                {
                    "categoryId": "2562",
					"categoryName": "Radio Control & Control Line"
                },
                {
                    "categoryId": "182181",
					"categoryName": "RC Model Vehicles & Kits"
                }
            ],
            "additionalImages": [
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********3_2_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********3_3_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********3_4_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********3_5_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********3_6_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********3_7_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********3_8_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********3_9_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********3_10_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********3_11_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********3_12_0_1/225x225.jpg"
                }
            ],
            "priorityListing": true,
            "adultOnly": false,
			"availableCoupons": false,
            "priorityListing": false,
			"legacyItemId": "2**********3"
        },
        {
            "itemId": "v1|2**********0|0",
            "title": "DJI Mavic Pro PLATINUM - Fly More COMBO Drone - 4K Stabilized Camera ActiveTrack",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/g/g**********H/s-l225.jpg"
            },
            "price": {
                "value": "1399.00",
                "currency": "USD"
            },
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|2**********0|0",
            "seller": {
                "username": "c***s",
                "feedbackPercentage": "99.0",
                "feedbackScore": 24883
            },
            "marketingPrice": {
                "originalPrice": {
                    "value": "1699.99",
                    "currency": "USD"
                },
                "discountPercentage": "18",
                "discountAmount": {
                    "value": "300.99",
                    "currency": "USD"
                }
            },
            "condition": "New",
            "conditionId": "1000",
            "thumbnailImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/M**********w/z/gu0AAOSwr8xaAp6H/$_0.JPG?set_id=8**********F"
                }
            ],
            "shippingOptions": [
                {
                    "shippingCostType": "FIXED",
                    "shippingCost": {
                        "value": "0.00",
                        "currency": "USD"
                    }
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE"
            ],
            "currentBidPrice": {
                "value": "1399.00",
                "currency": "USD"
            },
            "epid": "23011378347",
            "itemWebUrl": "https://www.ebay.com/itm/DJI-Mavic-Pro-PLATINUM-Fly-More-COMBO-Drone-4K-Stabilized-Camera-ActiveTrack/2**********0?hash=item3**********H",
            "itemLocation": {
                "postalCode": "1****",
                "country": "US"
            },
			"leafCategoryIds": ["179697"],
            "categories": [
                {
                    "categoryId": "179697",
					"categoryName": "Camera Drones"
                },
                {
                    "categoryId": "625",
					"categoryName": "Cameras & Photo"
                }
            ],
            "additionalImages": [
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********0_2_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********0_3_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********0_4_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********0_5_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********0_6_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********0_7_0_1/225x225.jpg"
                }
            ],
            "priorityListing": true,
            "adultOnly": false,
			"availableCoupons": false,
            "priorityListing": false,
			"legacyItemId": "2**********0"
        }
    ]
}

Sample 8: Return Items Based on Price and Condition

This call searches for new iPhones within a price range.

Input

The inputs are q and the price, priceCurrency, and conditions, filter URI parameters. There is no payload with this request.

GEThttps://api.ebay.com/buy/browse/v1/item_summary/search?q=drone&limit=5&filter=price:[300..800],priceCurrency:USD,conditions:{NEW}

Output

If the call is successful, the items meeting the criteria are returned.

{
    "href": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=iphone&limit=5&filter=price%3A%5B300..800%5D%2CpriceCurrency%3AUSD%2Cconditions%3A%7BNEW%7D&offset=0",
    "total": 8751,
    "next": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=iphone&limit=5&filter=price%3A%5B300..800%5D%2CpriceCurrency%3AUSD%2Cconditions%3A%7BNEW%7D&offset=50",
    "limit": 5,
    "offset": 0,
    "itemSummaries": [
        {
            "itemId": "v1|3**********3|5**********0",
            "title": "NEW OTHER? Apple iPhone 6S ~ (Factory Unlocked) (T-Mobile) (AT&T)",
            "itemGroupHref": "https://api.ebay.com/buy/browse/v1/item/get_items_by_item_group?item_group_id=3**********3",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/m/m**********Q/s-l225.jpg"
            },
            "price": {
                "value": "399.99",
                "currency": "USD"
            },
            "itemGroupType": "SELLER_DEFINED_VARIATIONS",
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|3**********3|5**********0",
            "seller": {
                "username": "t***e",
                "feedbackPercentage": "99.5",
                "feedbackScore": 5660
            },
            "condition": "New other (see details)",
            "conditionId": "1500",
            "shippingOptions": [
                {
                    "shippingCostType": "FIXED",
                    "shippingCost": {
                        "value": "0.00",
                        "currency": "USD"
                    }
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE"
            ],
            "currentBidPrice": {
                "value": "399.99",
                "currency": "USD"
            },
            "epid": "216202209",
            "itemWebUrl": "https://www.ebay.com/itm/NEW-OTHER-Apple-iPhone-6S-Factory-Unlocked-T-Mobile-AT-T/3**********3?hash=item4**********Q",
            "itemLocation": {
                "postalCode": "7****",
                "country": "US"
            },
			"leafCategoryIds": ["9355"],
            "categories": [
                {
                    "categoryId": "9355",
					"categoryName": "Cell Phones & Smartphones"
                },
                {
                    "categoryId": "15032",
					"categoryName": "Cell Phones, Smart Watches & Accessories"
                }
            ],
            "additionalImages": [
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********3_2_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********3_3_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********3_4_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********3_5_0_1/225x225.jpg"
                }
            ],
            "priorityListing": true,
            "adultOnly": false,
			"availableCoupons": false,
            "priorityListing": false,
			"legacyItemId": "3**********3"
        },
        {
            "itemId": "v1|1**********1|0",
            "title": "Apple iPhone 6s Plus - Space Gray 16GB (Verizon) Factory Unlocked Smartphone",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/g/5**********A/s-l225.jpg"
            },
            "price": {
                "value": "398.95",
                "currency": "USD"
            },
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|1**********1|0",
            "seller": {
                "username": "k***n",
                "feedbackPercentage": "100.0",
                "feedbackScore": 60
            },
            "condition": "New",
            "conditionId": "1000",
            "thumbnailImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/M**********y/z/51oAAOSwg31aeh4A/$_0.JPG?set_id=8**********F"
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE"
            ],
            "currentBidPrice": {
                "value": "398.95",
                "currency": "USD"
            },
            "epid": "216213677",
            "itemWebUrl": "https://www.ebay.com/itm/Apple-iPhone-6s-Plus-Space-Gray-16GB-Verizon-Factory-Unlocked-Smartphone/1**********1?hash=item2**********A",
            "itemLocation": {
                "postalCode": "1****",
                "country": "US"
            },
			"leafCategoryIds": ["9355"],
            "categories": [
                {
                    "categoryId": "9355",
					"categoryName": "Cell Phones & Smartphones"
                },
                {
                    "categoryId": "15032",
					"categoryName": "Cell Phones, Smart Watches & Accessories"
                }
            ],
            "priorityListing": true,
            "adultOnly": false,
			"availableCoupons": false,
            "priorityListing": false,
			"legacyItemId": "1**********1"
        },
        {
            "itemId": "v1|3**********8|5**********6",
            "title": "LIKE NEW?  Apple iPhone 6 - (Unlocked) (T-Mobile) (AT&T) WORLDWIDE!",
            "itemGroupHref": "https://api.ebay.com/buy/browse/v1/item/get_items_by_item_group?item_group_id=3**********8",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/m/m**********g/s-l225.jpg"
            },
            "price": {
                "value": "349.99",
                "currency": "USD"
            },
            "itemGroupType": "SELLER_DEFINED_VARIATIONS",
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|3**********8|5**********6",
            "seller": {
                "username": "t***e",
                "feedbackPercentage": "99.5",
                "feedbackScore": 5660
            },
            "condition": "New other (see details)",
            "conditionId": "1500",
            "shippingOptions": [
                {
                    "shippingCostType": "FIXED",
                    "shippingCost": {
                        "value": "0.00",
                        "currency": "USD"
                    }
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE"
            ],
            "currentBidPrice": {
                "value": "349.99",
                "currency": "USD"
            },
            "epid": "233752960",
            "itemWebUrl": "https://www.ebay.com/itm/LIKE-NEW-Apple-iPhone-6-Unlocked-T-Mobile-AT-T-WORLDWIDE/3**********8?hash=item4**********g",
            "itemLocation": {
                "postalCode": "7****",
                "country": "US"
            },
			"leafCategoryIds": ["9355"],
            "categories": [
                {
                    "categoryId": "9355",
					"categoryName": "Cell Phones & Smartphones"
                },
                {
                    "categoryId": "15032",
					"categoryName": "Cell Phones, Smart Watches & Accessories"
                }
            ],
            "additionalImages": [
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********8_2_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********8_3_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********8_4_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********8_5_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********8_6_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********8_7_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********8_8_0_1/225x225.jpg"
                }
            ],
            "priorityListing": true,
            "adultOnly": false,
			"availableCoupons": false,
            "priorityListing": false,
			"legacyItemId": "3**********8"
        },
        {
            "itemId": "v1|1**********8|0",
            "title": "New Inbox Apple iPhone 6s Plus - 128GB - Rose Gold (AT&T) GSM Unlocked A1634 ",
            "subtitle": "Comes with Free BodyGuardz Glass & Free Fast Shipping ",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/g/z**********e/s-l225.jpg"
            },
            "price": {
                "value": "499.99",
                "currency": "USD"
            },
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|1**********8|0",
            "seller": {
                "username": "a***s",
                "feedbackPercentage": "99.6",
                "feedbackScore": 63496
            },
            "condition": "New",
            "conditionId": "1000",
            "shippingOptions": [
                {
                    "shippingCostType": "FIXED",
                    "shippingCost": {
                        "value": "0.00",
                        "currency": "USD"
                    }
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE"
            ],
            "currentBidPrice": {
                "value": "499.99",
                "currency": "USD"
            },
            "epid": "216194804",
            "itemWebUrl": "https://www.ebay.com/itm/New-Inbox-Apple-iPhone-6s-Plus-128GB-Rose-Gold-AT-T-GSM-Unlocked-A1634/1**********8?hash=item2**********e",
            "itemLocation": {
                "postalCode": "7****",
                "country": "US"
            },
			"leafCategoryIds": ["9355"],
            "categories": [
                {
                    "categoryId": "9355",
					"categoryName": "Cell Phones & Smartphones"
                },
                {
                    "categoryId": "15032",
					"categoryName": "Cell Phones, Smart Watches & Accessories"
                }
            ],
            "priorityListing": true,
            "adultOnly": false,
			"availableCoupons": false,
            "priorityListing": false,
			"legacyItemId": "1**********8"
        },
        {
            "itemId": "v1|2**********4|0",
            "title": "Apple iPhone 6s Plus - 16GB - Space Gray Sprint A1687",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/g/f**********2/s-l225.jpg"
            },
            "price": {
                "value": "300.00",
                "currency": "USD"
            },
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|2**********4|0",
            "seller": {
                "username": "e***n",
                "feedbackPercentage": "99.6",
                "feedbackScore": 2216
            },
            "condition": "New",
            "conditionId": "1000",
            "thumbnailImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/M**********=/z/fugAAOSwlzRaeig2/$_0.JPG?set_id=8**********7"
                }
            ],
            "shippingOptions": [
                {
                    "shippingCostType": "FIXED",
                    "shippingCost": {
                        "value": "0.00",
                        "currency": "USD"
                    }
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE"
            ],
            "currentBidPrice": {
                "value": "300.00",
                "currency": "USD"
            },
            "epid": "219486022",
            "itemWebUrl": "https://www.ebay.com/itm/Apple-iPhone-6s-Plus-16GB-Space-Gray-Sprint-A1687/2**********4?hash=item3**********2",
            "itemLocation": {
                "postalCode": "0****",
                "country": "US"
            },
			"leafCategoryIds": ["9355"],
            "categories": [
                {
                    "categoryId": "9355",
					"categoryName": "Cell Phones & Smartphones"
                },
                {
                    "categoryId": "15032",
					"categoryName": "Cell Phones, Smart Watches & Accessories"
                }
            ],
            "additionalImages": [
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********4_2_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********4_3_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********4_4_0_1/225x225.jpg"
                }
            ],
            "priorityListing": true,
            "adultOnly": false,
			"availableCoupons": false,
            "priorityListing": false,
			"legacyItemId": "2**********4"
        }
    ]
}

Sample 9: Return Items Associated with a Charity

This call searches for items that are associated with the Toys for Tots charity.

Input

The inputs are q, charity_ids and limit.

GEThttps://api.ebay.com/buy/browse/v1/item_summary/search?charity_ids=203021444&limit=2

Output

If the call is successful, the items meeting the criteria are returned.

{
    "href": "https://api.ebay.com/buy/browse/v1/item_summary/search?limit=2&charity_ids=203021444&offset=0",
    "total": 1667,
    "next": "https://api.ebay.com/buy/browse/v1/item_summary/search?limit=2&charity_ids=203021444&offset=2",
    "limit": 2,
    "offset": 0,
    "itemSummaries": [
        {
            "itemId": "v1|3**********8|0",
            "title": "APC UPS USB to Ethernet (RJ45/RJ50) Data Cable Part No 940-0127E FCI - 6FT - New",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/g/-**********0/s-l225.jpg"
            },
            "price": {
                "value": "10.00",
                "currency": "USD"
            },
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|3**********8|0",
            "seller": {
                "username": "e***8",
                "feedbackPercentage": "100.0",
                "feedbackScore": 51
            },
            "condition": "New",
            "conditionId": "1000",
            "thumbnailImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/M**********w/z/-8gAAOSw~jpcjaN0/$_0.JPG?set_id=8**********7"
                }
            ],
            "shippingOptions": [
                {
                    "shippingCostType": "FIXED",
                    "shippingCost": {
                        "value": "0.00",
                        "currency": "USD"
                    }
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE"
            ],
            "currentBidPrice": {
                "value": "10.00",
                "currency": "USD"
            },
            "epid": "132075140",
            "itemWebUrl": "https://www.ebay.com/itm/APC-UPS-USB-to-Ethernet-RJ45-RJ50-Data-Cable-Part-No-940-0127E-FCI-6FT-New/3**********8?hash=item4**********0",
            "itemLocation": {
                "postalCode": "6****",
                "country": "US"
            },
			"leafCategoryIds": ["99265"],
            "categories": [
                {
                    "categoryId": "99265",
					"categoryName": "Computer Uninterruptible Power Supplies (UPS)"
                },
                {
                    "categoryId": "58058",
					"categoryName": "Computers, Tablets & Network Hardware"
                },
                {
                    "categoryId": "86722",
					"categoryName": "Power Protection & Distribution Units"
                }
            ],
            "additionalImages": [
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********8_2_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/3**********8_3_0_1/225x225.jpg"
                }
            ],
            "priorityListing": false,
            "adultOnly": false,
			"availableCoupons": false,
			"legacyItemId": "3**********8"
        },
        {
            "itemId": "v1|2**********9|0",
            "title": "LOT OF 5    \"SADIE'S MONTANA\" trilogy",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/g/m**********6/s-l225.jpg"
            },
            "price": {
                "value": "15.78",
                "currency": "USD"
            },
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|2**********9|0",
            "seller": {
                "username": "t***s",
                "feedbackPercentage": "100.0",
                "feedbackScore": 742
            },
            "condition": "Used",
            "conditionId": "3000",
            "thumbnailImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/O**********=/z/mh8AAOSwvjtcrh96/$_0.JPG?set_id=8**********7"
                }
            ],
            "shippingOptions": [
                {
                    "shippingCostType": "FIXED",
                    "shippingCost": {
                        "value": "0.00",
                        "currency": "USD"
                    }
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE"
            ],
            "currentBidPrice": {
                "value": "15.78",
                "currency": "USD"
            },
            "itemWebUrl": "https://www.ebay.com/itm/LOT-OF-5-SADIES-MONTANA-trilogy/2**********9?hash=item3**********6",
            "itemLocation": {
                "postalCode": "7****",
                "country": "US"
            },
			"leafCategoryIds": ["261186"],
            "categories": [
                {
                    "categoryId": "267",
					"categoryName": "Books & Magazines"
                },
                {
                    "categoryId": "261186",
					"categoryName": "Books"
                }
            ],
            "priorityListing": false,
            "adultOnly": false,
			"availableCoupons": false,
			"legacyItemId": "2**********9"
        }
    ]
}

Sample 10: Return Items that are Compatible with the Keyword and Vehicle

This call searches for brakes that are compatible with a 2018 BMW 318i.

Input

The inputs are q, category_ids, compatibility_filter, and limit. In order to get the best results, all the product attributes for the vehicle are specified; Make, Model, Year, Trim, and Engine.

GEThttps://api.ebay.com/buy/browse/v1/item_summary/search?q=brakes&category_ids=33559&compatibility_filter=Year:2018;Make:BMW;Model:318i;Trim:Executive Sedan 4-Door;Engine:1.5L 1499CC l3 GAS DOHC Turbocharged&limit=3

Output

If the call is successful, the items meeting the criteria are returned. The attributes that are compatible are returned in the compatibilityProperties container and the compatibilityMatch field tells you how well the item matches this vehicle.
In this example, all the items returned are an "exact" match.

{
	"href": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=brakes&limit=3&category_ids=33559&compatibility_filter=Year%3A2018%2CMake%3ABMW%2CModel%3A318i%2CTrim%3AExecutive%20Sedan%204%2DDoor%2CEngine%3A1%2E5L%201499CC%20l3%20GAS%20DOHC%20Turbocharged&offset=0",
	"total": 85,
	"next": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=brakes&limit=3&category_ids=33559&compatibility_filter=Year%3A2018%2CMake%3ABMW%2CModel%3A318i%2CTrim%3AExecutive%20Sedan%204%2DDoor%2CEngine%3A1%2E5L%201499CC%20l3%20GAS%20DOHC%20Turbocharged&offset=50",
	"limit": 3,
	"offset": 0,
	"itemSummaries": [{
			"itemId": "v1|2**********2|0",
			"title": "For BMW 1 3 5 7 Series X3 X5 X6 White Emblem LED Background Light 6000K 1PC 82mm",
			"image": {
				"imageUrl": "https://i.ebayimg.com/thumbs/images/g/P**********C/s-l225.jpg"
			},
			"price": {
				"value": "7.62",
				"currency": "USD"
			},
			"itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|2**********2|0",
			"seller": {
				"username": "c**********h",
				"feedbackPercentage": "98.9",
				"feedbackScore": 1202
			},
			"marketingPrice": {
				"originalPrice": {
					"value": "10.89",
					"currency": "USD"
				},
				"discountPercentage": "30",
				"discountAmount": {
					"value": "3.27",
					"currency": "USD"
				}
			},
			"condition": "New",
			"conditionId": "1000",
			"thumbnailImages": [{
				"imageUrl": "https://i.ebayimg.com/00/s/O**********=/z/PSUAAOSwW4RbneKC/$_0.JPG?set_id=8**********F"
			}],
			"shippingOptions": [{
				"shippingCostType": "FIXED",
				"shippingCost": {
					"value": "0.00",
					"currency": "USD"
				}
			}],
			"buyingOptions": [
				"FIXED_PRICE"
			],
			"currentBidPrice": {
				"value": "7.62",
				"currency": "USD"
			},
			"epid": "1044239019",
			"itemWebUrl": "https://www.ebay.com/itm/For-BMW-1-3-5-7-Series-X3-X5-X6-White-Emblem-LED-Background-Light-6000K-1PC-82mm/2**********2?fits=Year%3A2018%7CModel%3A318i%7CSubmodel%3AExecutive%7CEngine+-+Liter_Display%3A1.5L%7CMake%3ABMW&hash=item3**********C",
			"itemLocation": {
				"postalCode": "9****",
				"country": "US"
			},
			"leafCategoryIds": ["172517"],
			"categories": [
				{
					"categoryId": "42605",
					"categoryName": "Other Car & Truck Brakes"
				},
				{
					"categoryId": "6000",
					"categoryName": "eBay Motors"
				},
				{
					"categoryId": "6028",
					"categoryName": "Auto Parts & Accessories"
				},
				{
					"categoryId": "6030",
					"categoryName": "Car & Truck Parts & Accessories"
				},
				{
					"categoryId": "33559",
					"categoryName": "Car & Truck Brakes & Brake Parts"
				},
				{
					"categoryId": "33707",
					"categoryName": "Car & Truck Lighting & Lamps"
				},
				{
					"categoryId": "172517",
					"categoryName": "Car & Truck Light Bulbs & LEDs"
				}
			],
			"additionalImages": [{
					"imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********2_2_0_1/225x225.jpg"
				},
				{
					"imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********2_3_0_1/225x225.jpg"
				},
				{
					"imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********2_4_0_1/225x225.jpg"
				},
				{
					"imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********2_5_0_1/225x225.jpg"
				},
				{
					"imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********2_6_0_1/225x225.jpg"
				},
				{
					"imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********2_7_0_1/225x225.jpg"
				}
			],
			"adultOnly": false,
      "priorityListing": false,
			"compatibilityProperties": [{
					"name": "Year",
					"localizedName": "Year",
					"value": "2018"
				},
				{
					"name": "Make",
					"localizedName": "Make",
					"value": "BMW"
				},
				{
					"name": "Model",
					"localizedName": "Model",
					"value": "318i"
				},
				{
					"name": "Trim",
					"localizedName": "Trim",
					"value": "Executive Sedan 4-Door"
				},
				{
					"name": "Engine",
					"localizedName": "Engine",
					"value": "1.5L 1499CC l3 GAS DOHC Turbocharged"
				}
			],
			"compatibilityMatch": "EXACT",
			"availableCoupons": false,
			"legacyItemId": "2**********2",
            "priorityListing": true
		},
		{
			"itemId": "v1|1**********0|0",
			"title": "Car Suv Air Brake Fluid Replacement Pumping Oil Drained Exchange Tools Device",
			"image": {
				"imageUrl": "https://i.ebayimg.com/thumbs/images/g/A**********j/s-l225.jpg"
			},
			"price": {
				"value": "21.75",
				"currency": "USD"
			},
			"itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|1**********0|0",
			"seller": {
				"username": "x**********6",
				"feedbackPercentage": "99.3",
				"feedbackScore": 1697
			},
			"marketingPrice": {
				"originalPrice": {
					"value": "22.89",
					"currency": "USD"
				},
				"discountPercentage": "4",
				"discountAmount": {
					"value": "1.14",
					"currency": "USD"
				}
			},
			"condition": "New",
			"conditionId": "1000",
			"thumbnailImages": [{
				"imageUrl": "https://i.ebayimg.com/00/s/O**********=/z/A0sAAOSwUKxYZgPj/$_0.JPG?set_id=8**********F"
			}],
			"shippingOptions": [{
				"shippingCostType": "FIXED",
				"shippingCost": {
					"value": "0.00",
					"currency": "USD"
				}
			}],
			"buyingOptions": [
				"FIXED_PRICE"
			],
			"currentBidPrice": {
				"value": "21.75",
				"currency": "USD"
			},
			"epid": "4016652514",
			"itemWebUrl": "https://www.ebay.com/itm/Car-Suv-Air-Brake-Fluid-Replacement-Pumping-Oil-Drained-Exchange-Tools-Device/1**********0?fits=Year%3A2018%7CModel%3A318i%7CSubmodel%3AExecutive%7CEngine+-+Liter_Display%3A1.5L%7CMake%3ABMW&hash=item1**********j",
			"itemLocation": {
				"country": "CN"
			},
			"leafCategoryIds": ["33563","35625"],
			"categories": [{
					"categoryId": "33563",
					"categoryName": "Car & Truck Calipers & Brackets"
				},
				{
					"categoryId": "35625",
					"categoryName": "Other Automotive Hand Tools"
				},
				{
					"categoryId": "6000",
					"categoryName": "eBay Motors"
				},
				{
					"categoryId": "6028",
					"categoryName": "Auto Parts & Accessories"
				},
				{
					"categoryId": "6030",
					"categoryName": "Car & Truck Parts & Accessories"
				},
				{
					"categoryId": "33559",
					"categoryName": "Car & Truck Brakes & Brake Parts"
				},
				{
					"categoryId": "34998",
					"categoryName": "Automotive Tools & Supplies"
				},
				{
					"categoryId": "43990",
					"categoryName": "Automotive Hand Tools"
				}
			],
			"additionalImages": [{
					"imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********0_2_0_1/225x225.jpg"
				},
				{
					"imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********0_3_0_1/225x225.jpg"
				},
				{
					"imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********0_4_0_1/225x225.jpg"
				},
				{
					"imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********0_5_0_1/225x225.jpg"
				},
				{
					"imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********0_6_0_1/225x225.jpg"
				},
				{
					"imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********0_7_0_1/225x225.jpg"
				},
				{
					"imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********0_8_0_1/225x225.jpg"
				},
				{
					"imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********0_9_0_1/225x225.jpg"
				},
				{
					"imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********0_10_0_1/225x225.jpg"
				},
				{
					"imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********0_11_0_1/225x225.jpg"
				}
			],
			"adultOnly": false,
      "priorityListing": false,
			"compatibilityProperties": [{
					"name": "Year",
					"localizedName": "Year",
					"value": "2018"
				},
				{
					"name": "Make",
					"localizedName": "Make",
					"value": "BMW"
				},
				{
					"name": "Model",
					"localizedName": "Model",
					"value": "318i"
				},
				{
					"name": "Trim",
					"localizedName": "Trim",
					"value": "Executive Sedan 4-Door"
				},
				{
					"name": "Engine",
					"localizedName": "Engine",
					"value": "1.5L 1499CC l3 GAS DOHC Turbocharged"
				}
			],
			"compatibilityMatch": "EXACT",
			"availableCoupons": false,
			"legacyItemId": "1**********0",
            "priorityListing": true
		},
		{
			"itemId": "v1|2**********0|0",
			"title": "Dorman H621950 Front Brake Hose",
			"image": {
				"imageUrl": "https://i.ebayimg.com/thumbs/images/g/h**********z/s-l225.jpg"
			},
			"price": {
				"value": "18.86",
				"currency": "USD"
			},
			"itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|2**********0|0",
			"seller": {
				"username": "k**********c",
				"feedbackPercentage": "99.7",
				"feedbackScore": 14216
			},
			"condition": "New",
			"conditionId": "1000",
			"thumbnailImages": [{
				"imageUrl": "https://i.ebayimg.com/00/s/M**********=/z/hZwAAOSwknJX1vXz/$_0.JPG?set_id=8**********C"
			}],
			"shippingOptions": [{
				"shippingCostType": "FIXED",
				"shippingCost": {
					"value": "0.00",
					"currency": "USD"
				}
			}],
			"buyingOptions": [
				"FIXED_PRICE"
			],
			"currentBidPrice": {
				"value": "18.86",
				"currency": "USD"
			},
			"epid": "222713632",
			"itemWebUrl": "https://www.ebay.com/itm/Dorman-H621950-Front-Brake-Hose/2**********0?fits=Year%3A2018%7CModel%3A318i%7CSubmodel%3AExecutive%7CEngine+-+Liter_Display%3A1.5L%7CMake%3ABMW&hash=item3**********z",
			"itemLocation": {
				"postalCode": "1****",
				"country": "US"
			},
			"leafCategoryIds": ["33561"],
			"categories": [{
					"categoryId": "33561",
					"categoryName": "Car & Truck Brake Hoses, Lines & Fittings"
				},
				{
					"categoryId": "6000",
					"categoryName": "eBay Motors"
				},
				{
					"categoryId": "6028",
					"categoryName": "Auto Parts & Accessories"
				},
				{
					"categoryId": "6030",
					"categoryName": "Car & Truck Parts & Accessories"
				},
				{
					"categoryId": "33559",
					"categoryName": "Car & Truck Brakes & Brake Parts"
				}
			],
			"adultOnly": false,
      "priorityListing": false,
			"compatibilityProperties": [{
					"name": "Year",
					"localizedName": "Year",
					"value": "2018"
				},
				{
					"name": "Make",
					"localizedName": "Make",
					"value": "BMW"
				},
				{
					"name": "Model",
					"localizedName": "Model",
					"value": "318i"
				},
				{
					"name": "Trim",
					"localizedName": "Trim",
					"value": "Executive Sedan 4-Door"
				},
				{
					"name": "Engine",
					"localizedName": "Engine",
					"value": "1.5L 1499CC l3 GAS DOHC Turbocharged"
				}
			],
			"compatibilityMatch": "EXACT",
			"availableCoupons": false,
			"legacyItemId": "2**********0",
            "priorityListing": true
		}
	]
}

Sample 11: Return Items Based on Auto-Corrected Keyword

This call searches for an item with a misspelled keyword.

Input

The inputs are q, auto_correct, and limit.

GEThttps://api.ebay.com/buy/browse/v1/item_summary/search?q=macbok&auto_correct=KEYWORD&limit=4

Output

If the call is successful, the items meeting the criteria for the auto-corrected keyword are returned.

{
    "href": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=macbok&limit=4&auto_correct=KEYWORD&offset=0",
    "total": 660025,
    "next": "https://api.ebay.com/buy/browse/v1/item_summary/search?q=macbok&limit=4&auto_correct=KEYWORD&offset=4",
    "limit": 4,
    "offset": 0,
    "autoCorrections": {
        "q": "macbook"
    },
    "itemSummaries": [
        {
            "itemId": "v1|1**********4|0",
            "title": "Apple Macbook Air 13.3\" Touch ID Intel i5 8GB 128GB 2019 MVFH2LL/A Space Gray",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/g/i**********~/s-l225.jpg"
            },
            "price": {
                "value": "849.00",
                "currency": "USD"
            },
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|1**********4|0",
            "seller": {
                "username": "q**********s",
                "feedbackPercentage": "99.8",
                "feedbackScore": 327804
            },
            "marketingPrice": {
                "originalPrice": {
                    "value": "1099.00",
                    "currency": "USD"
                },
                "discountPercentage": "23",
                "discountAmount": {
                    "value": "250.00",
                    "currency": "USD"
                },
                "priceTreatment": "LIST_PRICE"
            },
            "condition": "Open box",
            "conditionId": "1500",
            "thumbnailImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/N**********=/z/iJwAAOSwSK9eCra~/$_0.PNG?set_id=*"
                }
            ],
            "shippingOptions": [
                {
                    "shippingCostType": "FIXED",
                    "shippingCost": {
                        "value": "0.00",
                        "currency": "USD"
                    }
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE"
            ],
            "epid": "18032820715",
            "itemWebUrl": "https://www.ebay.com/itm/Apple-Macbook-Air-13-3-Touch-ID-Intel-i5-8GB-128GB-2019-MVFH2LL-A-Space-Gray/1**********4?hash=item2**********~",
            "itemLocation": {
                "country": "US"
            },
			"leafCategoryIds": ["111422"],
            "categories": [
                {
                    "categoryId": "111422",
					"categoryName": "Apple MacBook"
                },
                {
                    "categoryId": "58058",
					"categoryName": "Computers, Tablets & Network Hardware"
                },
                {
                    "categoryId": "175672",
					"categoryName": "Laptops & Netbooks"
                }
            ],
            "additionalImages": [
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_2_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_3_0_1/225x225.jpg"
                }
            ],
            "priorityListing": true,
            "adultOnly": false,
            "priorityListing": false,
			"availableCoupons": false,
            "priceDisplayCondition": "ONLY_SHOW_ON_REQUEST",
            "legacyItemId": "1**********4"
        },
        {
            "itemId": "v1|2**********2|0",
            "title": "Apple Silver MacBook Pro13\"  500GB HDD/ Intel i5/16GB RAM/MacOS High Sierra 2017",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/g/o**********K/s-l225.jpg"
            },
            "price": {
                "value": "399.99",
                "currency": "USD"
            },
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|2**********2|0",
            "seller": {
                "username": "g**********3",
                "feedbackPercentage": "99.5",
                "feedbackScore": 3510
            },
            "condition": "Manufacturer refurbished",
            "conditionId": "2000",
            "thumbnailImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/M**********w/z/oIsAAOSws5BaT7rK/$_0.JPG?set_id=8**********7"
                }
            ],
            "shippingOptions": [
                {
                    "shippingCostType": "FIXED",
                    "shippingCost": {
                        "value": "0.00",
                        "currency": "USD"
                    }
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE"
            ],
            "itemWebUrl": "https://www.ebay.com/itm/Apple-Silver-MacBook-Pro13-500GB-HDD-Intel-i5-16GB-RAM-MacOS-High-Sierra-2017/2**********2?hash=item3**********K",
            "itemLocation": {
                "postalCode": "1****",
                "country": "US"
            },
			"leafCategoryIds": ["111422"],
            "categories": [
                {
                    "categoryId": "111422",
					"categoryName": "Apple MacBook"
                },
                {
                    "categoryId": "58058",
					"categoryName": "Computers, Tablets & Network Hardware"
                },
                {
                    "categoryId": "175672",
					"categoryName": "Laptops & Netbooks"
                }
            ],
            "additionalImages": [
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********2_2_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********2_3_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********2_4_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********2_5_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********2_6_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********2_7_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********2_8_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********2_9_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********2_10_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********2_11_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********2_12_0_1/225x225.jpg"
                }
            ],
            "priorityListing": true,
            "adultOnly": false,
			"availableCoupons": false,
            "priorityListing": false,
            "legacyItemId": "2**********2"
        },
        {
            "itemId": "v1|1**********4|0",
            "title": "UPGRADED MACBOOK PRO 13 INCH | UPGRADED 750GB +8GB RAM | OS-2017 | 3YR WARRANTY",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/g/T**********e/s-l225.jpg"
            },
            "price": {
                "value": "399.00",
                "currency": "USD"
            },
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|1**********4|0",
            "seller": {
                "username": "m**********s",
                "feedbackPercentage": "99.6",
                "feedbackScore": 2787
            },
            "condition": "Used",
            "conditionId": "3000",
            "thumbnailImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/M**********w/z/Te8AAOSwncJePFhe/$_0.JPG?set_id=8**********7"
                }
            ],
            "shippingOptions": [
                {
                    "shippingCostType": "FIXED",
                    "shippingCost": {
                        "value": "0.00",
                        "currency": "USD"
                    }
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE"
            ],
            "itemWebUrl": "https://www.ebay.com/itm/UPGRADED-MACBOOK-PRO-13-INCH-UPGRADED-750GB-8GB-RAM-OS-2017-3YR-WARRANTY/1**********4?hash=item2**********e",
            "itemLocation": {
                "postalCode": "5****",
                "country": "US"
            },
			"leafCategoryIds": ["111422"],
            "categories": [
                {
                    "categoryId": "111422",
					"categoryName": "Apple MacBook"
                },
                {
                    "categoryId": "58058",
					"categoryName": "Computers, Tablets & Network Hardware"
                },
                {
                    "categoryId": "175672",
					"categoryName": "Laptops & Netbooks"
                }
            ],
            "additionalImages": [
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_2_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_3_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_4_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_5_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_6_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_7_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_8_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_9_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_10_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_11_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/1**********4_12_0_1/225x225.jpg"
                }
            ],
            "adultOnly": false,
			"availableCoupons": false,
            "priorityListing": false,
            "legacyItemId": "1**********4"
        },
        {
            "itemId": "v1|2**********0|0",
            "title": "Apple MacBook Air 11\" Mid 2013 1.3 GHz i5 4th Gen 4GB 128GB A1465 Grey #57y",
            "image": {
                "imageUrl": "https://i.ebayimg.com/thumbs/images/g/F**********i/s-l225.jpg"
            },
            "price": {
                "value": "251.99",
                "currency": "USD"
            },
            "itemHref": "https://api.ebay.com/buy/browse/v1/item/v1|2**********0|0",
            "seller": {
                "username": "b**********7",
                "feedbackPercentage": "100.0",
                "feedbackScore": 42
            },
            "condition": "Used",
            "conditionId": "3000",
            "thumbnailImages": [
                {
                    "imageUrl": "https://i.ebayimg.com/00/s/M**********w/z/FW0AAOSwnRxeamHi/$_0.JPG?set_id=8**********7"
                }
            ],
            "shippingOptions": [
                {
                    "shippingCostType": "FIXED",
                    "shippingCost": {
                        "value": "0.00",
                        "currency": "USD"
                    }
                }
            ],
            "buyingOptions": [
                "FIXED_PRICE",
                "BEST_OFFER"
            ],
            "itemWebUrl": "https://www.ebay.com/itm/Apple-MacBook-Air-11-Mid-2013-1-3-GHz-i5-4th-Gen-4GB-128GB-A1465-Grey-57y/2**********0?hash=item4**********i",
            "itemLocation": {
                "postalCode": "4****",
                "country": "US"
            },
			"leafCategoryIds": ["111422"],
            "categories": [
                {
                    "categoryId": "111422",
					"categoryName": "Apple MacBook"
                },
                {
                    "categoryId": "58058",
					"categoryName": "Computers, Tablets & Network Hardware"
                },
                {
                    "categoryId": "175672",
					"categoryName": "Laptops & Netbooks"
                }
            ],
            "additionalImages": [
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********0_2_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********0_3_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********0_4_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********0_5_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********0_6_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********0_7_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********0_8_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********0_9_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********0_10_0_1/225x225.jpg"
                },
                {
                    "imageUrl": "https://galleryplus.ebayimg.com/ws/web/2**********0_11_0_1/225x225.jpg"
                }
            ],
            "priorityListing": true,
            "adultOnly": false,
			"availableCoupons": false,
            "priorityListing": false,
            "legacyItemId": "2**********0"
        }
    ]
}