eBay Browse API
The eBay Browse API enables buyers to search and browse the eBay catalog, retrieve item details, and discover items by aspect or category.
OpenAPI Specification
openapi: 3.0.0
info:
title: eBay Browse API
description: The Browse API has the following resources:<ul><li><b>item_summary:</b><br>Allows shoppers to search for specific items by keyword, GTIN, category, charity, product, image <a href="/api-docs/static/versioning.html#experimental" target="_blank"><img src="/cms/img/docs/experimental-icon.svg" class="legend-icon experimental-icon" alt="Experimental Method" title="Experimental Method" />(Experimental Method)</a>, or item aspects and refine the results by using filters, such as aspects, compatibility, and fields values, or UI parameters.</li><li><b>item:</b><br>Allows shoppers to retrieve the details of a specific item or all items in an item group, which is an item with variations such as color and size and check if a product is compatible with the specified item, such as if a specific car is compatible with a specific part.<br><br>This resource also provides a bridge between the eBay legacy APIs, such as the <a href="/api-docs/user-guides/static/finding-user-guide-landing.html" target="_blank">Finding</b>, and the RESTful APIs, which use different formats for the item IDs.</li></ul>The <b>item_summary</b>, <b>search_by_image</b>, and <b>item</b> resource calls require an <a href="/api-docs/static/oauth-client-credentials-grant.html" target="_blank">Application access token</a>.
contact:
name: eBay Inc,
license:
name: eBay API License Agreement
url: https://go.developer.ebay.com/api-license-agreement
version: v1.19.7
servers:
- url: https://api.ebay.com{basePath}
description: Production
variables:
basePath:
default: /buy/browse/v1
paths:
/item_summary/search:
get:
tags:
- Item_summary
description: 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.<br><br><span class="tablenote"><b>Note:</b> Only listings where <code>FIXED_PRICE</code> (Buy It Now) is a buying option are returned by default. To retrieve listings that do not have <code>FIXED_PRICE</code> as a buying option, the <code>buyingOptions</code> filter can be used to retrieve those listings.<br><br>Note that an auction listing enabled with the <i>Buy it Now</i> feature will initially show <code>AUCTION</code> and <code>FIXED_PRICE</code> as buying options, but if/when that auction listing receives a qualifying bid, only <code>AUCTION</code> remains as a buying option. If this happens, the <code>buyingOptions</code> filter would need to be used to retrieve that auction listing.</span><br>This method also supports the following:<ul><li>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 <a href="#uri.filter">filter</a> parameter.</li><li>Retrieving the refinements (metadata) of an item, such as item aspects (color, brand) condition, category, etc. using the <a href="#uri.fieldgroups">fieldgroups</a> parameter.</li><li>Filtering by item aspects and other refinements using the <a href="#uri.aspect_filter">aspect_filter</a> parameter.</li><li>Filtering for items that are compatible with a specific product, using the <a href="#uri.compatibility_filter">compatibility_filter</a> parameter.</li><li>Creating aspects histograms, which enables shoppers to drill down in each refinement narrowing the search results.</li></ul>For additional information and examples of these capabilities, refer to <a href="/api-docs/buy/static/api-browse.html" target="_blank">Browse API</a> in the Buying Integration Guide.</br><h3>Pagination and sort controls</h3>There are pagination controls (<b>limit</b> and <b>offset</b> fields) and <b>sort</b> query parameters that control/sort the data that are returned. By default, results are sorted by <i>Best Match</i>. For more information about Best Match, refer to <a href="https://pages.ebay.com/help/sell/searchstanding.html " target="_blank">Best Match</a>.</br><h3>Restrictions</h3>This method can return a maximum of 10,000 items. For a list of supported sites and other restrictions, refer to <a href="/api-docs/buy/browse/overview.html#API">API Restrictions</a>.<br><br><span class="tablenote"><b>eBay Partner Network:</b> In order to receive a commission for your sales, you must use the URL returned in the <code>itemAffiliateWebUrl</code> field to forward your buyer to the ebay.com site.</span>
operationId: search
parameters:
- name: aspect_filter
in: query
description: 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.<br><br><span class="tablenote"><b>Note:</b> The category ID must be specified <i>twice</i>:<ul><li>Once as a URI parameter in the <code>category_ids</code> field</li><li>Once as part of the <code>aspect_filter</code> field</li></ul>These two values <b>must</b> be the same.</span><br>For example, to return items for a woman's red shirt, issue the following request:<br><pre>/buy/browse/v1/item_summary/search?q=shirt&category_ids=15724&aspect_filter=categoryId:15724,Color:{Red}</pre>To get a list of the aspect pairs and the category, which is returned in the <code>dominantCategoryId</code> field, set <code>fieldgroups</code> to <code>ASPECT_REFINEMENTS</code> as illustrated here:<pre>/buy/browse/v1/item_summary/search?q=shirt&fieldgroups=ASPECT_REFINEMENTS</pre><span class="tablenote"><b> Note:</b> 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.<br><br>The following example illustrates the correct format for entering two brand names as aspect filter values, one of which contains a pipe symbol:<pre>/buy/browse/v1/item_summary/search?limit=50&category_ids=3034&filter=buyingOptions:{AUCTION|FIXED_PRICE}&aspect_filter=categoryId:3034,Brand:{Bed\|Stü|Nike}</pre></span> For implementation help, refer to eBay API documentation at https://developer.ebay.com/api-docs/buy/browse/types/gct:AspectFilter
required: false
schema:
type: string
- name: auto_correct
in: query
description: A query parameter that enables auto correction.<br><br>A sample is shown below:<pre>/buy/browse/v1/item_summary/search?auto_correct=KEYWORD</pre><span class="tablenote"><b>Note:</b> Auto correction is currently supported in the following marketplaces:<ul><li>United States</li><li>Austria</li><li>Australia</li><li>Canada</li><li>Switzerland</li><li>Germany</li><li>Spain</li><li>France</li><li>United Kingdom</li><li>Ireland</li><li>Italy</li></ul></span><br><b>Valid Values:</b> <code>KEYWORD</code>
required: false
schema:
type: string
- name: category_ids
in: query
description: <a name="category_ids"></a>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:<pre>/buy/browse/v1/item_summary/search?category_ids=29792</pre><pre>/buy/browse/v1/item_summary/search?category_ids=267,29792</pre><span class="tablenote"><b>Note:</b> Currently, you can pass in only one category ID per request.</span><br>To refine the set of information that is returned, <code>category_ids</code> may be combined with <b>EITHER</b>:<ul><li><code>epid</code> and/or <code>gtin</code> values</li><li><code>q</code> keywords</li></ul>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 <b>Toys & Hobbies</b> category ID as illustrated here:<pre>/buy/browse/v1/item_summary/search?q=phone&category_ids=220</pre>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:<ul><li>Visiting the <a href="https://pages.ebay.com/sellerinformation/news/categorychanges.html " target="_blank">Category Changes page</a></li><li>Using the Taxonomy API. Refer to <a href="/api-docs/buy/buy-categories.html" target="_blank">Get Categories for Buy APIs</a> for complete information.</li><li>Issuing the following call to retrieve the <code>dominantCategoryId</code> for an item:<pre>/buy/browse/v1/item_summary/search?q=<i> keyword</i>&fieldgroups=ASPECT_REFINEMENTS</pre></li></ul><span class="tablenote"><b>Note:</b> If a top-level (L1) category is specified, you <b>must</b> also include a <code>q</code> query parameter.</span>
required: false
schema:
type: string
- name: charity_ids
in: query
description: 'The charity ID filters results to return only those items associated with the specified charity.<br><br><span class="tablenote"><b>Note:</b> <code>charity_ids</code> is only supported by the US and UK marketplaces.</span><br>Charity ID is a charity''s unique identification number:<ul><li>In the US, this is the <b>Employer Identification Number (EIN)</b>.</li><li>In the UK, this is the Charity Registration Number (CRN), commonly called <b>Charity Number</b>.</li></ul><br><code>charity_ids</code> may be retrieved/determined as follows:<ul><li>Search for a supported charity using the Charity API''s <a href="/api-docs/commerce/charity/resources/charity_org/methods/getCharityOrgs " target="_blank">getCharityOrgs</a> method.<br><br><div class="msgbox_important"><p class="msgbox_importantInDiv" data-mc-autonum="<b><span style="color: #dd1e31;" class="mcFormatColor">Important! </span></b>"><span class="autonumber"><span><b><span style="color: #dd1e31;" class="mcFormatColor">Important!</span></b></span></span> The value to be passed in as <code>charity_ids</code> is that returned in the <code>registrationId</code> field.</p></div></li><li>Search for a supported charity by visiting <a href="https://charity.ebay.com/search " target="_blank">Charity Search</a>. 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.<br><br>For example, the charity ID for <a href="https://charity.ebay.com/charity/American-Red-Cross/3843 " target="_blank">American Red Cross</a>, is <code>530196605</code>.</li></ul>Up to 20 comma-separated <code>charity_ids</code> may be specified in each query. Additionally, <code>charity_ids</code> may be combined with <code>category_ids</code> and/or <code>q</code> keyword values to further filter returned results.<br><br>A sample query using <code>charity_ids</code> is:<br><pre>/buy/browse/v1/item_summary/search?charity_ids=13-1788491,300108469</pre>'
required: false
schema:
type: string
- name: compatibility_filter
in: query
description: '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.<br><br><span class="tablenote"><b>Note:</b> The only products supported are cars, trucks, and motorcycles.</span><br>For example, if the keyword is <code>brakes</code> and <code>compatibility-filter=Year:2018;Make:BMW</code>, the items returned are items with <b>brakes</b>, <b>2018</b>, or <b>BMW</b> in the title.<br><br>The service uses the product attributes to determine whether the item is compatible. The service returns the attributes that are compatible and the <a href="/api-docs/buy/browse/resources/item_summary/methods/search#response.itemSummaries.compatibilityMatch">CompatibilityMatchEnum</a> value that indicates how well the item matches the attributes.<br><br><div class="msgbox_tip"><p class="msgbox_tipInDiv" data-mc-autonum="<b><span style="color: #478415;" class="mcFormatColor">Tip: </span></b>"><span class="autonumber"><span><b><span style="color: #478415;" class="mcFormatColor">Tip:</span></b></span></span> Refer to the <a href="/api-docs/buy/browse/resources/item_summary/methods/search#s0-1-21-6-7-7-6-ReturnItemsthatareCompatiblewiththeKeywordandVehicle-9" target="_blank">Samples</a> section for a detailed example.</p></div><br><b>Best Practice:</b> Submit all of the <a href="/api-docs/buy/static/api-browse.html#product-attributes" target="_blank">product attributes</a> for the specific product.<br><br>To find the attributes and values for a specific marketplace, use the <a href="/api-docs/commerce/taxonomy/resources/category_tree/methods/getCompatibilityProperties" target="_blank">getCompatibilityProperties</a> method in the <a href="/api-docs/commerce/taxonomy/resources/methods" target="_blank">Taxonomy API</a>.<br><br>For more information, refer to <a href="/api-docs/buy/static/api-browse.html#Check" target="_blank">Check compatibility</a> in the Buying Integration Guide.<br><br><span class="tablenote"><b>Note:</b> Testing in Sandbox is only supported using mock data. Refer to <a href="/api-docs/buy/static/api-browse.html#sbox-test" target="_blank">Testing search in the Sandbox</a> for details.</span><br><b>Required:</b><ul><li><code>q</code> (keyword)</li><li>One parts-compatibility-supported category ID (such as <code>33559</code> Brakes)</li><li>At least one <a href="/api-docs/buy/static/api-browse.html#product-attributes" target="_blank">vehicle attribute</a> name/value pair</li></ul> For implementation help, refer to eBay API documentation at https://developer.ebay.com/api-docs/buy/browse/types/gct:CompatibilityFilter'
required: false
schema:
type: string
- name: epid
in: query
description: 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.<br><br>Use the <a href="/api-docs/commerce/catalog/resources/product_summary/methods/search" target="_blank">product_summary/search</a> method in the <a href="/api-docs/commerce/catalog/overview.html" target="_blank">Catalog</a> API to search for the ePID of the product.<br><br>For example:<pre>/buy/browse/v1/item_summary/search?epid=15032</pre><span class="tablenote"><b>Note:</b> When constructing a query, <code>epid</code> may be combined with a <code>gtin</code> value. However, <i>do not</i> specify keywords using the <code>q</code> parameter — keywords cannot be used in conjunction with an <code>epid</code>.</span>
required: false
schema:
type: string
- name: fieldgroups
in: query
description: A comma-separated list of values that controls what is returned in the response. The default is <code>MATCHING_ITEMS</code>, 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.<br><br><b>Valid Values:</b><ul><li><code>ASPECT_REFINEMENTS</code><br>This field group adds the <a href="#response.refinement.aspectDistributions">aspectDistributions</a> container to the response.<br><br><span class="tablenote"><b>Note:</b> Information returned by <code>ASPECT_REFINEMENTS</code> is category specific.</span></li><li><code>BUYING_OPTION_REFINEMENTS</code><br>This field group adds the <a href="#response.refinement.buyingOptionDistributions">buyingOptionDistributions</a> container to the response.</li><li><code>CATEGORY_REFINEMENTS</code><br>This field group adds the <a href="#response.refinement.categoryDistributions">categoryDistributions</a> container to the response.</li><li><code>CONDITION_REFINEMENTS</code><br>This field group adds the <a href="#response.refinement.conditionDistributions">conditionDistributions</a> containers, such as <code>NEW</code>, <code>USED</code>, etc., to the response. Within these groups are multiple states of the condition.<br><br>For example, <code>NEW</code> can be <i>New without tag</i>, <i>New in box</i>, <i>New without box</i>, etc.</li><li><code>EXTENDED</code><br>This field group adds the following fields to the response:<ul><li><a href="/api-docs/buy/browse/resources/item_summary/methods/search#response.itemSummaries.shortDescription">shortDescription</a></li><li><a href="/api-docs/buy/browse/resources/item_summary/methods/search#response.itemSummaries.itemLocation.city">itemLocation.city</a></li></ul></li><li><code>MATCHING_ITEMS</code> (<b>default value</b>)<br>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.</li><li><code>FULL</code><br>This field group returns all refinement containers and all matching items.</li></ul><b>Default:</b> <code>MATCHING_ITEMS</code>
required: false
schema:
type: string
- name: filter
in: query
description: 'An array of field filters that can be used to limit/customize the result set.<br><br>Refer to <a href="/api-docs/buy/static/ref-buy-browse-filters.html" target="_blank">Buy API Field Filters</a> for additional information and examples of all supported filters.<br><br>For example, to filter shirts based on a specific range of prices, include the filter illustrated here: <pre>/buy/browse/v1/item_summary/search?q=shirt&filter=price:[10..50]</pre>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: <pre>/buy/browse/v1/item_summary/search?q=shirt&filter=price:[10..50],sellers:{rpseller|bigSal}</pre> For implementation help, refer to eBay API documentation at https://developer.ebay.com/api-docs/buy/browse/types/cos:FilterField'
required: false
schema:
type: string
- name: gtin
in: query
description: This field lets you search by the Global Trade Item Number of an item as defined by <a href="https://www.gtin.info " target="_blank">https://www.gtin.info</a>.<br><br>For example:<br><pre>/buy/browse/v1/item_summary/search?gtin=099482432621</pre><span class="tablenote"><b>Note:</b> You can search only by UPC (Universal Product Code). To search using another GTIN format, you must search by keyword.</span><span class="tablenote"><b>Note:</b> When constructing a query, <code>gtin</code> may be combined with an <code>epid</code> value. However, <i>do not</i> specify keywords using the <code>q</code> parameter — keywords cannot be used in conjunction with <code>gtin</code>.</span>
required: false
schema:
type: string
- name: limit
in: query
description: The number of items from the result set returned in a single page.<br><br><span class="tablenote"><b>Note:</b> If a value is set in the <code>limit</code> field, the value of <code>offset</code> must be either zero or a multiple of the <code>limit</code> value. An error is returned for invalid <code>offset</code> values.</span><br><span class="tablenote"><b>Note:</b> This method can return a maximum of 10,000 items in one results set.</span><br><b>Min:</b> 1<br><br><b>Max:</b> 200<br><br><b>Default:</b> 50
required: false
schema:
type: string
- name: offset
in: query
description: 'Specifies the number of items to skip in the result set. This is used with the <code>limit</code> field to control the pagination of the output.<br><br>For example:<ul><li>If <code>offset</code> is 0 and <code>limit</code> is 10, the method will retrieve items 1-10 from the list of items returned</li><li>If <code>offset</code> is 10 and <code>limit</code> is 10, the method will retrieve items 11-20 from the list of items returned.</li></ul><span class="tablenote"><b>Note:</b> The value of <code>offset</code> must be either zero or a multiple of the value set in the <code>limit</code> field. An error is returned for invalid <code>offset</code> values.</span><br><span class="tablenote"><b>Note:</b> This method can return a maximum of 10,000 items in one results set.</span><br><b>Min</b>: 0<br><br><b>Max:</b> 9,999<br><br><b>Default:</b> 0'
required: false
schema:
type: string
- name: q
in: query
description: A string consisting of one or more keywords used to search for items on eBay.<br><br><span class="tablenote"><b>Note:</b> The <code>*</code> wildcard character is <b>not</b> allowed in this field.</span><br>When providing two or more keywords in a single query, the string is processed as follows:<ul><li>When successive keywords are separated by a space, the list of keywords is processed as an <code>AND</code> request. For example, to retrieve items that include <b>both</b> of the keywords <b>iphone</b> AND <b>ipad</b>, submit the following query:<br><pre>/buy/browse/v1/item_summary/search?q=iphone ipad</pre></li><li>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 <code>OR</code> request. For example, to retrieve items that include <b>iphone</b> OR <b>ipad</b>, submit one of the following queries:<br><pre>/buy/browse/v1/item_summary/search?q=(iphone, ipad)</pre><pre>/buy/browse/v1/item_summary/search?q=%28iphone%2c%20ipad%29</pre></li></ul><br><span class="tablenote"><b>Note:</b> When specifying keywords using the <code>q</code> parameter, <i>do not include</i> an <code>epid</code> or <code>gtin</code> parameter value as neither can be used in conjuction with a keyword search.</span>
required: false
schema:
type: string
- name: sort
in: query
description: 'Specifies the criteria on which returned items are to be sorted.<br><br>Items can be sorted in ascending order based on:<ul><li>Price (<code>sort=price</code>)<br>Returned items are sorted based on their total cost (i.e., <i>price + shipping cost</i>).<br><br>Items with the lowest combined price are shown first.<br><br>When sorting by price, it is highly recommended that:<ul><li>The <code>X-EBAY-C-ENDUSERCTX</code> request header is used, <b>and</b></li><li>The <code>contextualLocation</code> parameter specifies the delivery country and postal code.<br><br>These values must be <i>URL-encoded</i>.</li></ul>Refer to the following example:<pre>X-EBAY-C-ENDUSERCTX: contextualLocation=country%3DUS%2Czip%3D19406</pre><b>Descending price order</b><br>To sort items from <i>highest price</i> to <i>lowest price</i> insert a minus sign (-) before <code>price</code> as the search criterion:<pre>sort=-price</pre></li><li>Distance (<code>sort=distance</code>)<br>Returned items are sorted based on their distance from the buyer''s location.<br><br>Items that are closest to the buyer are listed first.<br><br><div class="msgbox_important"><p class="msgbox_importantInDiv" data-mc-autonum="<b><span style="color: #dd1e31;" class="mcFormatColor">Important! </span></b>"><span class="autonumber"><span><b><span style="color: #dd1e31;" class="mcFormatColor">Important!</span></b></span></span> When sorting by distance, all required <a href="/api-docs/buy/static/ref-buy-browse-filters.html#pickupCountry" target="_blank">pickup filters</a> must be included in the request.</p></div></li><li>Date<br>Items can be sorted by date based on:<ul><li>Listing date (<code>sort=newlyListed</code>)<br>Returned items are sorted based on their listing date.<br><br>Newly listed items are shown first.</li><li>End date (<code>sort=endingSoonest</code>)<br>Returned items are sorted based on the date/time on which their listing is scheduled to end.<br><br>Items that are closest to their scheduled ending date/time are shown first.</li></ul>If no sort parameter is submitted, the result set is sorted by "Best Match". Refer to <a href="https://www.ebay.com/help/selling/listings/listing-tips/optimising-listings-best-match?id=4166 " target="_blank">Optimizing your listings for Best Match</a> for additional information. For implementation help, refer to eBay API documentation at https://developer.ebay.com/api-docs/buy/browse/types/cos:SortField'
required: false
schema:
type: string
- name: X-EBAY-C-ENDUSERCTX
in: header
description: This header is required to support revenue sharing for eBay Partner Network and to improve the accuracy of shipping and delivery time estimations.<br><br>For additional information, refer to <a href="/api-docs/buy/static/api-browse.html#Headers" target="_blank ">Use request headers</a> in the <a href="/api-docs/buy/static/buying-ig-landing.html" target="_blank">Buying Integration Guide</a>.
required: false
schema:
type: string
- name: X-EBAY-C-MARKETPLACE-ID
in: header
description: This header identifies the seller's eBay marketplace. It is required for all marketplaces outside of the US.<br><br><span class="tablenote"><b>Note:</b> If a marketplace ID value is not provided, the default value of <code>EBAY_US</code> is used.</span><br>See <a href="/api-docs/buy/browse/types/ba:MarketplaceIdEnum" target="_blank">MarketplaceIdEnum</a> for supported values.
required: false
schema:
type: string
- name: Accept-Language
in: header
description: This header is used to indicate the natural language and locale preferred by the user for the response.<br><br>This header is required when targeting a specific locale of a marketplace that supports multiple locales. For example:<ul><li>When targeting the French locale of the Belgium marketplace, it is required to pass in <code>fr-BE</code> to specify this. If this locale is not specified, the language will default to Dutch.</li><li>When targeting the French locale of the Canadian marketplace, it is required to pass in <code>fr-CA</code> to specify this. If this locale is not specified, the language will default to English.</li></ul>
required: false
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/SearchPagedCollection'
x-response-codes:
errors:
'12002':
domain: API_BROWSE
category: REQUEST
description: The {filterName} value is invalid. For the valid values, refer to the API call documentation.
'12003':
domain: API_BROWSE
category: REQUEST
description: A seller 'username' provided in the request filters is invalid.
'12008':
domain: API_BROWSE
category: REQUEST
description: The 'sort' value is invalid. For the valid values, refer to the API call documentation.
'12009':
domain: API_BROWSE
category: REQUEST
description: The 'category_ids' query parameter is invalid.
'12010':
domain: API_BROWSE
category: REQUEST
description: There are four filters required for local pickup. 'pickupPostalCode','pickupCountry','pickupRadiusUnit','pickupRadius'. One or more is missing or invalid.
'12011':
domain: API_BROWSE
category: REQUEST
description: '''deliveryCountry'' is a mandatory filter to provide a delivery location. ''deliveryPostalCode'' is optional.'
'12012':
domain: API_BROWSE
category: REQUEST
description: A valid 'price' filter and a valid 'priceCurrency' filter is necessary to filter based on price.
'12014':
domain: API_BROWSE
category: BUSINESS
description: 'The ''sellerAccountTypes'' filter is not supported for the marketplace {marketplaceId}. Valid marketplaces are: {validMarketplaces}'
'12015':
domain: API_BROWSE
category: REQUEST
description: The postal code filter value is invalid for the specified country and this filter was ignored.
'12016':
domain: API_BROWSE
category: REQUEST
description: The 'fieldgroups' value {fieldgroups} is invalid. For the valid values, refer to the API call reference documentation
'12017':
domain: API_BROWSE
category: REQUEST
description: The 'aspect_filter' query parameter must include a categoryId. For information, see the API call reference documentation.
'12018':
domain: API_BROWSE
category: REQUEST
description: The {aspectFilter} aspect_filter value is invalid. For information, see the API call reference documentation.
'12021':
domain: API_BROWSE
category: REQUEST
description: The 'epid' value {epid} is invalid. For information, see the API call reference documentation.
'12022':
domain: API_BROWSE
category: REQUEST
description: The 'gtin' value {gtin} is invalid. For information, see the API call reference documentation.
'12024':
domain: API_BROWSE
category: REQUEST
description: The 'charity_ids' value {charity_id} is invalid. For more information see the API call reference documentation.
'12502':
domain: API_BROWSE
category: REQUEST
description: The {compatibilityFilter} compatibility_filter is invalid. For information, see the API call reference documentation.
'12511':
domain: API_BROWSE
category: REQUEST
description: Either 'deliveryCountry' or 'deliveryPostalCode' is invalid, hence 'guaranteedDeliveryInDays' filter was ignored.
'400':
description: Bad Request
x-response-codes:
errors:
'12001':
domain: API_BROWSE
category: REQUEST
description: The call must have a valid 'q', 'category_ids', 'epid' or 'gtin' query parameter.
'12004':
domain: API_BROWSE
category: REQUEST
description: The 'offset' value cannot be negative.
'12005':
domain: API_BROWSE
category: REQUEST
description: The 'offset' value must be an integer.
'12006':
domain: API_BROWSE
category: REQUEST
description: The 'limit' value should be between 1 and 200 (inclusive).
'12007':
domain: API_BROWSE
category: REQUEST
description: The 'limit' value must be an integer value.
'12023':
domain: API_BROWSE
category: REQUEST
description: 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':
domain: API_BROWSE
category: REQUEST
description: The 'charity_ids' field has exceeded the maximum limit of 20.
'12026':
domain: API_BROWSE
category: REQUEST
description: 'The ''charity_ids'' field is not supported for the marketplace {marketplaceId}. Valid marketplaces are: {validMarketplaces}.'
'12027':
domain: API_BROWSE
category: REQUEST
description: The 'auto_correct' value is invalid. For the valid values, refer to the API call documentation.
'12028':
domain: API_BROWSE
category: REQUEST
# --- truncated at 32 KB (262 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/ebay/refs/heads/main/openapi/ebay-browse-openapi-original.yml