![]() Maximum number of items in a result set: 10,000 Maximum number of items per page (limit): 200 The number of items, from the result set, returned in a single page. Sorts by price in descending order (highest price first) Sorts by price in ascending order (lowest price first) The following are examples of using the sort query parameter. If no sort parameter is submitted, the result set is sorted by " Best Match". Currently, you can only sort by price (in ascending or descending order). To sort in descending order use - before the field name. This field specifies the order and the field name to use to sort the items. buy/marketplace-insights/v1_beta/item_sales/search?q=iphone&category_ids=15724&filter=price:,priceCurrency:USD Note: To filter by price, price and priceCurrency must always be used together. The following example filters the result set by price. For details and examples for all the filters, see Buy API Field Filters. The following lists the supported filters. This field supports multiple field filters that can be used to limit/customize the result set. To use a top-level (L1) category, you must also include the q, or gtin, or epid query parameter. ![]() Partners will be given a list of categories they can use.You can use category_ids by itself or use it with any combination of the gtin, epid, and q fields, which gives you additional control over the result set.This field can have one category ID or a comma separated list of IDs.For details see Get Categories for Buy APIs. For the US marketplace, use the Category Changes page.You can use the following techniques to find a category by site: The list of eBay category IDs is not published and category IDs are not the same across all the eBay marketplaces. buy/marketplace-insights/v1_beta/item_sales/search?q=shirt&category_ids=137084 But if you also include the category ID 137084, the results will be limited to 'Men's Athletic Apparel'. For example, if you search for 'shirt' the result set will be very large. The category ID is required and is used to limit the results. Optional: Any combination of epid, gtin, or q Restriction: The * wildcard character is not allowed in this field. buy/marketplace-insights/v1_beta/item_sales/search?q=iphone, ipad&category_ids=15724 buy/marketplace-insights/v1_beta/item_sales/search?q=iphone&category_ids=15724 ipad In the following examples, the query returns items that have iphone OR ipad. If the keywords are separated by a space, it is treated as an OR.buy/marketplace-insights/v1_beta/item_sales/search?q=iphone,ipad&category_ids=15724 In the following example, the query returns items that have iphone AND ipad. If the keywords are separated by a comma, it is treated as an AND.Input Resource URI (production)Ī string consisting of one or more keywords that are used to search for items on eBay. Restrictionsįor a list of supported sites and other restrictions, see API Restrictions. For details, see URL encoding query parameter values. Query parameter values need to be URL encoded. For details see, Request headers in the Buy APIs Overview. If you are an eBay Network Partner you must use affiliateCampaignId= ePNCampaignId,affiliateReferenceId= referenceId in the header in order to be paid for selling eBay items on your site. You will want to use the X-EBAY-C-ENDUSERCTX request header with this method. ![]() For more information about Best Match, see the eBay help page Best Match. By default, the results are sorted by "Best Match". There are pagination controls ( limit and offset fields) and sort query parameters that control/sort the data that is returned. Creating aspects histograms, which enables shoppers to drill down in each refinement narrowing the search results.įor details and examples of these capabilities, see Browse API in the Buying Integration Guide.Filtering by item aspects and other refinements using the aspect_filter parameter.Retrieving the refinements (metadata) of an item, such as item aspects (color, brand), condition, category, etc.For the fields supported by this method, see the filter parameter. Filtering by the value of one or multiple fields, such as listing format, item condition, price range, location, and more. ![]() You can search by keyword, category, eBay product ID (ePID), or GTIN, or a combination of these. This method searches for sold eBay items by various URI query parameters and retrieves the sales history of the items for the last 90 days.
0 Comments
Leave a Reply. |