You can find links to the Finding API documentation in the top navigation bar. Information about the schema location is in the Schema Location section of the "Making an API Call" topic.
Are you just getting started with the Finding API? The following describes how to join the eBay Developers Program:
| Version | Release Date |
|---|---|
| 1.2.0 | 2010-01-20 |
| 1.1.0 | 2009-11-11 |
| 1.0.1 | 2009-09-29 |
| 1.0.0 (documentation updates) | 2009-09-10 |
| 1.0.0 | 2009-06-24 |
This section includes configuration information where specific setup steps are needed.
As of January 15, 2010, eBay evaluates the CONTENT-TYPE header against the request payload format. If the CONTENT-TYPE value is incorrect for the payload, the request will fail. Previously, eBay did not validate the CONTENT-TYPE header in requests.
This HTTP header is optional. If you do not submit the CONTENT-TYPE header with your request, eBay will determine the content type from the payload.
The following table lists the correct CONTENT-TYPE header values for HTTP POST request formats:
| Request Payload Format | CONTENT-TYPE Value |
|---|---|
| XML | text/xml |
| SOAP11 | text/xml (together with the SOAPAction header, for which the value can be anything) |
| SOAP12 | application/soap+xml |
See Making An API Call for more information about the call format for the Finding API.
Index of Changed Calls - 1.2.0
Documentation Changes and Errata - 1.2.0
For a current list of known issues, see eBay Shopping, Finding and Merchandising API Production System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.
Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.
| Name | Part of Schema | Type of Change |
|---|---|---|
GetVersionRequest |
Complex type | New |
GetVersionResponse |
Complex type | New |
searchResult.item.compatibility |
Element | New |
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1.2.0.
Parts compatibility is an eBay feature that uses structured data to associate assemblies (compatible applications) with parts and accessories listed on eBay. Starting in March 2010, parts compatibility will be supported in limited Parts & Accessories categories for eBay Motors in the Production environment. For these categories, a compatible application will always be a vehicle, which is a specific combination of make, model, and year. Optionally, trim and engine data may also be specifed for a compatible application. For example, parts compatibility enables sellers to specify accurately and comprehensively the vehicles on which a side mirror or a rim fit. Parts compatibility improves search relevancy and frees up item titles and descriptions for more useful descriptions of the part.
Parts compatibility can be specified by application or by specification. With parts compatibility by application, the seller specifies the application (e.g., year, make, and model of a specific vehicle) with which the part or accessory is compatible. With parts compatibility by specification, the seller specifies the dimensions and characteristics of the part or accessory (e.g., Section Width, Aspect Ratio, Rim Diammeter, Load Index, and Speed Rating values for a tire).
When parts compatibility (sometimes called fitment) data is available for items, keywords queries in the Finding API will search this structured data, in addition to other listing information.
To search for items listed with compatibility information by application, include vehicle details, such as make and model (e.g., Honda Accord), in the keywords in addition to terms for the part or accessory. When there are matches, and the item was listed with compatibility information by application, the compatibility field in the response returns terms from the query that match values in one of the item's compatible applications (vehicles). If the query matches more than one compatible application for an item, the compatibility field returns "Two or more of your vehicles" to indicate multiple matches.
For example, if the query contains "Honda Accord" and a matching item has a 2007 Honda Accord (any trim or engine) specified as a compatible application, the compatibility field will return the matching terms from the query (i.e., Honda Accord).
To search for items listed with compatibility information by specification, include the part specifications, such as a tire's section width and aspect ratio (e.g., 225 45), in the keywords in addition to other terms for the part or accessory. The compatibility field is not returned for items listed with compatibility by specification.
The getVersion call was added with this release. This simple call can be used to monitor the service for availability. This call has no input parameters and the response contains only the standard output fields.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1.2.0 and Changed Functionality - 1.2.0.
None for this release.
Index of Changed Calls - 1.1.0
Documentation Changes and Errata - 1.1.0
For a current list of known issues, see eBay Shopping, Finding and Merchandising API Production System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.
Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.
| Name | Part of Schema | Type of Change |
|---|---|---|
searchResult.item.galleryPlusPictureURL |
Element | New |
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1.1.0.
The search calls now return galleryPlusPictureURL for matching items that have been upgraded to use the Gallery Plus feature. Gallery Plus images are larger than standard gallery images. In site search results, you can view the Gallery Plus image by hovering over or clicking the Enlarge link or magifying glass icon.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1.1.0 and Changed Functionality - 1.1.0.
The documentation for the SellerBusinessType item filter has been updated to list the correct filter value, Business, for sellers registered as a business on eBay.
The documentation for the Condition item filter has been updated to include the filter value, Unspecified, for restricting search results to listings for which item condition was not specified.
Index of Changed Calls - 1.0.1
Documentation Changes and Errata - 1.0.1
For a current list of known issues, see eBay Shopping, Finding and Merchandising API Production System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.
Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.
| Name | Part of Schema | Type of Change |
|---|---|---|
searchResult.item.sellerInfo.topRatedSeller |
Element | New |
itemFilter.name.TopRatedSellerOnly |
Enum | New |
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1.0.1.
With the launch of the Top-rated Sellers program, buyers can find items listed by the highest quality sellers on eBay based on the feedback of other buyers. The sellerInfo node in the search results (searchResult.item.sellerInfo) for the "findItems" calls now includes the topRatedSeller field to indicate (true or false) whether the seller of an item qualifies as an eBay Top-rated Seller. Additionally, a new TopRatedSellerOnly item filter has been added to limit search results to items listed by Top-rated Sellers only.
Note the following site restrictions:
Top-rated sellers consistently receive highest buyers' ratings, ship items quickly, and have earned a track record of excellent service. eBay regularly reviews the performance of these sellers to confirm they continue to meet the program's requirements. See the Top-rated Sellers page on the eBay site for more information.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1.0.1 and Changed Functionality - 1.0.1.
None for this release.
This is the first release of the eBay Finding API.
Note: Watch these release notes for changes.
For a current list of known issues, see eBay Shopping, Finding and Merchandising API Production System Announcements and the Knowledge Base.
These calls are included in the initial release of the eBay Finding API.
Not applicable for initial release.
An "xs:any" element has been added to the DomainFilter type in the Finding Service WSDL. This corrects a problem that caused compilation errors for .NET clients.
See the eBay Shopping, Finding and Merchandising API Production System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 1.0.0.
None for this release.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
None for this release.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1.0.0 and Changed Functionality - 1.0.0.
The documentation has been updated to indicate the conditions for which aspect histograms are returned. Aspect histograms are returned only for categories that have been mapped to domains. In most cases, just leaf categories are mapped to domains, but there are exceptions. So, if you provide a parent category as input to getHistograms or you restrict a finding call search to a parent category, you may not get an aspect histogram in the response.
The documentation has been updated to reflect the following conditions for when category histograms are returned:
The description for productId in the search results has been updated to correct inaccuracies.
Several call samples have been updated for accuracy and typographic errors.
© 2009–2010 eBay Inc. All rights reserved.
eBay and the eBay logo are registered trademarks of eBay Inc.
All other brands are the property of their respective owners.
