Working with Custom Item Specifics

Item Specifics are details about the item being sold. Depending on the listing category, some Item Specifics are mandatory, some are recommended, and others are custom-designed by the seller. Item Specifics can help users find your item in a search, and can help prospective buyers quickly learn about your item.

Topics:

Introduction

Retrieving a Listing's Item Specifics

Searching Against Custom Item Specifics

Pre-filling Item Specifics with Product Details

Checking Category Support for Custom Item Specifics

Listing with Custom Item Specifics

Revising and Relisting with Custom Item Specifics

Using Advanced Features of Custom Item Specifics

Introduction

Item Specifics enable you to classify items by presenting descriptive details in a structured way. For example:

That is, information like "Total Carat Weight" would be specific to jewelry listings, and information like "Type=Top-Loading" would be specific to Washer & Dryer listings.

Each Item Specific consists of a name (like "Total Carat Weight") and a value (like "3.00 carats and larger").

The figure below shows some Item Specifics for a gold bracelet listing, similar to how they might appear on eBay's View Item page.

Figure: Item Specifics on eBay's View Item Page
Item Specifics

Buyers and sellers can use Item Specifics to find and compare particular types of items more easily when searching and browsing eBay.

By using Item Specifics in listings, sellers can also benefit in these ways:

In the API, Item Specifics are name/value pairs (simple strings). A seller chooses from a list of the most popular field names and values defined by other users, and/or defines their own field names and values. In the API, you use the names and values the seller specified (as-is) when you list or display an item.

Item Specifics are not supported in all categories. This chapter includes information on how you use the API to determine the categories that do support Item Specifics.

Item specifics can be included in a listing via three mechanisms:

Copyright © 2005–2016 eBay Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.