759 Trading, Shopping, Merchant Data API Docs Now Available

Please remember to use a test environment when updating applications to use a new schema version.

To find out when a version of the API will be available, see the table at the top of the Release Notes for that API.

You can find the latest API documentation at the eBay Developer Documentation Center.

Trading

Trading Release Notes

Release Highlights

See the Trading API System Announcements for bug fixes included in this release.

Shopping

Shopping Release Notes

See the Shopping API System Announcements for bug fixes included in this release.

Merchant Data

Merchant Data Release Notes

See the Large Merchant Services API System Announcements for bug fixes included in this release.

Russell Hall
API Tech Docs

February 7, 2012 in Documentation, Shopping API, Trading API | Permalink

Item Specifics Updates in June and July for Clothing, Shoes & Accessories

(Updated June 26, 2011 -- Color will not be required, but it is strongly recommended. Note that support for ID-based attributes in these categories has been extended to July 20, 2011. Also, GetCategorySpecifics returns required custom item specifics for applicable categories as of early June 2011.)

From April through July 2011, eBay is making changes in fashion categories for fashion enthusiasts. Here’s what developers need to know to support these changes. (These changes will affect eBay US and international sites.)

No ID-Based Attributes in Clothing, Shoes & Accessories

When we enabled custom item specifics for Clothing, Shoes & Accessories in 2009, we announced that the ID-based attributes in these categories would be deprecated in about a year. Support for ID-based attributes (Item.AttributeSetArray) is ending soon (late July) in Clothing, Shoes & Accessories. Use custom item specifics (Item.ItemSpecifics) in AddItem and related calls instead.  (All areas of Clothing, Shoes & Accessories have supported the new custom item specifics format for the past year or more.)

If you still had Clothing, Shoes & Accessories listings with ID-based attributes as of April 2011, eBay converted those existing listings to custom item specifics for you. However, as the item specifics have changed since April, these conversions will no longer occur.

Category Structure Changes in Clothing, Shoes & Accessories

A number of changes have been made to the Clothing, Shoes & Accessories category structure. Category structure changes eliminate redundancies, improve coverage, and meet buyers’ shopping experience expectations.  Your (or your sellers') listings falling under impacted categories may have been moved to new categories based on existing category ID and item specifics. The category structure updates were effective on April 5th. Please revise your GTC listings if you feel a different category is a better fit.

In addition to the category structure changes, we have tailored custom item specific values in Clothing, Shoes & Accessories.  The values were improved to meet sellers’ needs and to help with item specifics relevance. For example, some subcategories moved out of the Clothing, Shoes & Accessories category structure and into item specifics instead. (Some new categories are being added, as well.) 

GetCategorySpecifics identifies the available custom item specifics for leaf categories, as well as dependencies between item specifics. After the metadata changes are available in the system, see NameRecommendation.ValidationRules.MinValues to identify required item specifics, and NameRecommendation.ValidationRules.Relationship for any dependencies. GetItemRecommendations will also be updated.

Note: Although GetCategory2CS and GetAttributesCS may still return ID-based attribute data for these categories, avoid using these calls for Clothing, Shoes & Accessories. As a general rule, if GetCategoryFeatures shows that a category supports custom item specifics (ItemSpecificsEnabled) or a category has been converted from ID-based attributes to custom item specifics (AttributeConversionEnabled), you should use custom item specifics instead of ID-based attributes.

Required Item Specifics Coming in June and July in Clothing, Shoes & Accessories

Starting July 20, 2011 all new and revised listings in Clothing, Shoes & Accessories categories must include the following item specifics: Brand, Size Type, Size, and Style in the ItemSpecifics (name/value) format. Required item specifics may vary by category.

Color is not required (updated from original announcement, based on community feedback), but both Color and Shade help establish consistent color across categories. Sellers are highly encouraged to provide details on both aspects. Specifying Color will enable buyers find your items when searching for items by color.

As of the end of June 2011, eBay is giving more visibility to these refinements in Fashion categories, so we recommend that you start using custom item specifics now if you don't already.

These calls will fail for listings that are missing required item specifics:

  • AddItem and AddFixedPriceItem
  • RelistItem and RelistFixedPriceItem
  • ReviseItem and ReviseFixedPriceItem (even if your revision does not touch the item specifics)

The following cases will not be blocked for now. However, we recommend that sellers include the required item specifics in these listings in order to benefit from the new buyer experience:

  • ReviseInventoryStatus (for changing price and quantity) won't be blocked regardless of whether existing listings in Clothing, Shoes & Accessories categories have the required item specifics.
  • Good 'Til Canceled (GTC) listings that you don't revise; they will continue to renew automatically for the next several months even if they are missing required item specifics.

Early Access Info: Starting in June 2011, GetCategorySpecifics and GetItemRecommendations will identify the required item specifics for leaf categories, before they become mandated on July 20. (Alternatively, see the lookup table for developers (link below) to view the mandated item specifics).

In general, if ValidationRules.MinValues is set to 1, it means the item specific is required for that category. For Clothing, Shoes & Accessories categories, it means that the item specific will be required after July 20.

AddItem and related calls will not enforce these required item specifics in fashion categories until July 20. However, we encourage you to start using the required item specifics as early as possible.

Also note that if ValidationRules.SelectionMode is set to "SelectionOnly", it means you must choose from eBay's recommended values, instead of specifying you own custom value. (This occurs for Style, Occasion, and Color in some categories.) This requirement is already in effect. However, if your application does not yet support using SelectionOnly values in GetCategorySpecifics, you can omit the item specific entirely in the short term while you adjust your application. AddItem and related calls will not block fashion listings that omit item specifics, until July 20.

More Information On These Fashion Category Changes

Item Specifics Lookup Table (All Categories) for Developers
http://developer.ebay.com/DevZone/itemspecificslookup/

Site changes for Fashion Pages - April 2011
http://pages.ebay.com/categorychanges/CSA-2011.html

Item specifics required in Fashion categories
http://pages.ebay.com/sellerinformation/news/clothingshoesaccessories.html

Required Item Specifics Lookup Table for Sellers
http://pages.ebay.com/sellerinformation/increaseyoursales/csalookup.html

Review the category, catalog and item specific updates coming April and May
http://pages.ebay.com/sellerinformation/news/CategoryUpdatesSpring2011.html

 

June 9, 2011 in Best Practices, Business News, Categories and Item Specifics, Certified Provider, Critical Notes from Tech Support, Documentation, Product News, Seller Releases, Trading API | Permalink

721 Trading, Shopping, Merchant Data API Docs Now Available

Please remember to use a test environment when updating applications to use a new schema version.

To find out when a version of the API will be available, see the table at the top of the Release Notes for that API.

You can find the latest API documentation at the eBay Developer Documentation Center.

Trading

Trading Release Notes

Release Highlights

See the Trading API System Announcements for bug fixes included in this release.

Shopping

Shopping Release Notes

See the Shopping API System Announcements for bug fixes included in this release.

Merchant Data

Merchant Data Release Notes

Release Highlights

See the Large Merchant Services API System Announcements for bug fixes included in this release.

Bradburn Young
API Tech Docs

May 17, 2011 in Developer Education, Documentation, Merchandising API, Trading API | Permalink

Search Call Deprecations and the Java and .NET SDKs

The deprecation of GetSearchResults and GetCategoryListings will affect users of the Java and .NET SDKs. Users of current versions of these SDKs will continue to have access to the deprecated calls and types until October 11, 2011. Users who adopt newer versions of these SDKs, starting with the April 28, 2011, point release, will not have access to the deprecated types. The April 28 release will include samples that show how to access the search functions in the Finding API from the Trading SDKs.

April 18, 2011 in Developer Community, Documentation, Finding API, Trading API | Permalink

717 Trading, Shopping, Merchant Data API Docs Now Available

Please remember to use a test environment when updating applications to use a new schema version.

To find out when a version of the API will be available, see the table at the top of the Release Notes for that API.

You can find the latest API documentation at the eBay Developer Documentation Center.

Trading

Trading Release Notes

See the Trading API System Announcements for bug fixes included in this release.

Shopping

Shopping Release Notes

See the Shopping API System Announcements for bug fixes included in this release.

Merchant Data

Merchant Data Release Notes

See the Large Merchant Services API System Announcements for bug fixes included in this release.

Bradburn Young
API Tech Docs

April 18, 2011 in Developer Website, Documentation, Shopping API, Trading API | Permalink

Finding API Migration

The Developers Program launched the Finding API in July 2009. Today Finding API is successfully serving over 130 millions of requests daily. We are ready for our next critical milestone – support all developers to fully migrate to Finding API to take advantage of the eBay’s next generation search technology used to power the eBay site search ; and deprecate Trading APIs: GetSearchResults and GetCategoryListings, and Shopping APIs: FindItemsAdvanced and FindItems. These APIs will stop working after October 2011.

To better support developers’ migration, asks and needs, we have been focusing on Finding API for new and enhanced features, as well as technical support. Meanwhile the deprecation of Trading and Shopping Search APIs has started since January 2011. Although those four API calls are still working till October, developers should have noticed that the deprecated API calls and related schema have been removed from the public WSDL and XSD files. Related documentation has also been removed. These calls are also being removed from SDKs.  For adoption of newer version SDKs after April 2011, the deprecated types will no longer be accessible. A warning message will be returned by these API calls after June 2011, indicating the API is scheduled to be removed. Your application might be broken if it doesn’t follow eBay requirements for error handling. The search capabilities provided by these calls are supported in the Finding API. If you're building new search applications, start with the Finding API. If you have applications that use these calls, please migrate your item search functions to the Finding API.

 

Why Finding API?

The Finding API leverages eBay’s next generation search technology and have been designed to provide greater flexibility, better performance and scalability. Increased search relevancy and parity with the eBay site search features are some of the highlights of the new API. The latest Best Match and Fitment algorithms are available in Finding API. A series of benchmark testing has been conducted that shows on par performance of Finding API to the Shopping API (FindItemsAdvanced & FindItems); and significant improvement over the Trading API (GetSearchResults & GetCategoryListings).

The following are the functionalities and features added by Finding API for item searches:

1.       Retrieve aspect histograms and filter by aspects and/or domains – supply data by item attributes which enables eBay site alike left navigation as well as search refinement by applying constraints aligned with eBay search classification.

2.       Support new search capabilities:

  • Item Condition histogram and filters
  • Restrict searches to as many as 3 categories at a time
  • Expedited Shipping filters
  • Top-Rated Sellers Only filter
  • Returns Accepted Only filter

 

3.       Image Search API (findItemsByImage): expend eBay’s capabilities in fashion to developers for the “More Like This” functionality.

4.       Three sizes of gallery image: 140x140, 96x96, 80x80 that users can choose to use based on their application’s needs.

As our commitment to the Developer Community, we are always working continuously and diligently to enable the latest, high performance, world-class eBay search technology and features to Finding API. Enhancements to picture URL, Multi-variations, LocatedIn etc. filters and more will be released in May.

 

How to Migrate to Finding API?

The following migration guides map input and output fields for GetSearchResults in the Trading API and FindItemsAdvanced in the Shopping API to the corresponding input and output fields in findItemsAdvanced in the Finding API:

Please contact us for questions or more information on Finding API or migration.

 

 

April 7, 2011 in Affiliates, Critical Notes from Tech Support, Developer Website, Documentation, Finding API, Shopping API, Trading API | Permalink

715 Trading, Shopping, Merchant Data API Docs Now Available

Please remember to use a test environment when updating applications to use a new schema version.

To find out when a version of the API will be available, see the table at the top of the Release Notes for that API.

You can find the latest API documentation at the eBay Developer Documentation Center.

Trading

Trading Release Notes

Release Highlights

See the Trading API System Announcements for bug fixes included in this release.

Shopping

Shopping Release Notes

Release Highlights

See the Shopping API System Announcements for bug fixes included in this release.

Merchant Data

Merchant Data Release Notes

See the Large Merchant Services API System Announcements for bug fixes included in this release.

Bradburn Young
API Tech Docs

April 5, 2011 in Developer Community, Developer Website, Documentation, Shopping API, Trading API | Permalink

Item Specifics Updates for Clothing, Shoes & Accessories

(Updated June 7, 2011 -- Note that support for ID-based attributes in these categories has been extended to July 20, 2011. Also, GetCategorySpecifics returns required custom item specifics for applicable categories as of early June 2011.)

From April through July 2011, eBay is making changes in fashion categories for fashion enthusiasts. Here’s what developers need to know to support these changes. (These changes will affect eBay US and international sites.)

No ID-Based Attributes in Clothing, Shoes & Accessories

Support for ID-based attributes (Item.AttributeSetArray) is ending soon (late July) in Clothing, Shoes & Accessories. Use custom item specifics (Item.ItemSpecifics) in AddItem and related calls instead.  (All areas of Clothing, Shoes & Accessories have supported the new custom item specifics format for the past year or more.)

If you still have Clothing, Shoes & Accessories listings with ID-based attributes, eBay will convert those existing listings to custom item specifics for you.

Category Structure Changes in Clothing, Shoes & Accessories

A number of changes have been made to the Clothing, Shoes & Accessories category structure. Category structure changes will eliminate redundancies, improve coverage, and meet buyers’ shopping experience expectations.  Your (or your sellers') listings falling under impacted categories may have been moved to new categories based on existing category ID and item specifics. After the category structure updates are effective (on April 5th), please revise your listings if you feel a different category is a better fit.

In addition to the category structure changes, we are tailoring custom item specific values in Clothing, Shoes & Accessories.  The values are being improved to meet sellers’ needs and to help with item specifics relevance. For example, some subcategories are moving out of the Clothing, Shoes & Accessories category structure and into item specifics instead. (Some new categories are being added, as well.)

GetCategorySpecifics identifies the available custom item specifics for leaf categories, as well as dependencies between item specifics. After the metadata changes are available in the system, see NameRecommendation.ValidationRules.MinValues to identify required item specifics, and NameRecommendation.ValidationRules.Relationship for any dependencies. GetItemRecommendations will also be updated.

Note: Although GetCategory2CS and GetAttributesCS may still return ID-based attribute data for these categories, we recommend that you avoid using these calls for Clothing, Shoes & Accessories. As a general rule, if GetCategoryFeatures shows that a category supports custom item specifics (ItemSpecificsEnabled) or a category has been converted from ID-based attributes to custom item specifics (AttributeConversionEnabled), you should use custom item specifics instead of ID-based attributes.

Required Item Specifics Coming in June and July in Clothing, Shoes & Accessories

Starting July 20, 2011 all new and revised listings in Clothing, Shoes & Accessories categories must include the following custom item specifics: Brand, Size Type, Size, Style, and Color. Required item specifics may vary by category.

These calls will fail if listings in the above categories are missing required item specifics:

  • AddItem and AddFixedPriceItem
  • RelistItem and RelistFixedPriceItem
  • ReviseItem and ReviseFixedPriceItem (even if your revision does not touch the item specifics)

The following cases will not be blocked for now. However, we recommend that sellers include the required item specifics in these listings in order to benefit from the new buyer experience:

  • ReviseInventoryStatus (for changing price and quantity) won't be blocked regardless of whether existing listings in Clothing, Shoes & Accessories categories have the required item specifics.
  • Good 'Til Canceled (GTC) listings that you don't revise, they will continue to renew automatically for the next several months even if they are missing required item specifics.

Early Access Info: Starting in June 2011, GetCategorySpecifics and GetItemRecommendations will identify the required custom item specifics for leaf categories, before they become mandated on July 20. (Alternatively, see the lookup table for developers (link below) to view the mandated item specifics).

In general, if ValidationRules.MinValues is set to 1, it means the item specific is required for that category. For Clothing, Shoes & Accessories categories, it means that the item specific will be required after July 20.

AddItem and related calls will not enforce these required item specifics in fashion categories until July 20. However, we encourage you to start using the required item specifics as early as possible.

More Information On These Fashion Category Changes

Site changes for Fashion Pages - April 2011
http://pages.ebay.com/categorychanges/CSA-2011.html

Item specifics required in Fashion categories
http://pages.ebay.com/sellerinformation/news/clothingshoesaccessories.html

Required Item Specifics Lookup Table for Sellers
http://pages.ebay.com/sellerinformation/increaseyoursales/csalookup.html

Review the category, catalog and item specific updates coming April and May
http://pages.ebay.com/sellerinformation/news/CategoryUpdatesSpring2011.html

Item Specifics Lookup Table (All Categories) for Developers
http://developer.ebay.com/DevZone/itemspecificslookup/

 

April 4, 2011 in Best Practices, Categories and Item Specifics, Large Merchant Services, Product News, Seller Releases, Trading API | Permalink

Motors Parts & Accessories: Required Return Policy, Handling Time, Item Condition

Beginning May 9, 2011, AddItem, AddFixedPriceItem, RelistItem, and RelistFixedPriceItem must include ReturnPolicy, DispatchTimeMax (handling time), and ConditionID for all US eBay (site 100) Motors Parts & Accessories items that are newly listed or relisted.

We encourage you to also start adding this information to existing Good 'Til Cancelled (GTC) listings, which will require these changes in early 2012.

In GetCategoryFeatures, see ReturnPolicyEnabled, HandlingTimeEnabled, ConditionEnabled (and ConditionValues) to determine which categories require these fields. For a list of the handling time values allowed for each site, use DispatchTimeMaxDetails in GeteBayDetails.

For general information about these changes, see this 2011 Spring Seller Update:

Return policy, handling time and item condition required for all new listings and relistings
http://pages.ebay.com/sellerinformation/news/motorspaupdate.html

Also, as previously announced in the Trading API release notes, Parts & Accessories categories on the US eBay Motors site support the ability to allow buyers to return Parts & Accessories items within 60 days, and the ability for the seller to choose whether the seller or buyer pays return shipping costs.

Return Policy Updates for Motors Parts & Accessories (API Release Notes)
http://developer.ebay.com/DevZone/XML/docs/WebHelp/ReleaseNotes.html#709RtrnPlcyMtrsPnA

 

April 3, 2011 in Best Practices, eBay Motors, Product News, Seller Releases, Trading API | Permalink

713 Trading, Shopping, Merchant Data API Docs Now Available

Please remember to use a test environment when updating applications to use a new schema version.

To find out when a version of the API will be available, see the table at the top of the Release Notes for that API.

You can find the latest API documentation at the eBay Developer Documentation Center.

Trading

Trading Release Notes

Release Highlights

See the Trading API System Announcements for bug fixes included in this release.

Shopping

Shopping Release Notes

See the Shopping API System Announcements for bug fixes included in this release.

Merchant Data

Merchant Data Release Notes

See the Large Merchant Services API System Announcements for bug fixes included in this release.

Bradburn Young
API Tech Docs

March 21, 2011 in Developer Community, Documentation, Large Merchant Services, Shopping API, Trading API | Permalink