Listing with Custom Item Specifics

This section describes how to fill in custom Item Specifics in AddItem and related calls. This section assumes the seller is listing in one category, and they are filling in their own names and values from scratch (or from their own inventory system or catalog).

Topics:

Basic Item Specifics Listing

Product Identification Using Item Specifics

Basic Item Specifics Listing

Here is the basic approach that you use to include custom Item Specifics in a listing:

  1. When the seller chooses a leaf category to list in, check your local data store to make sure the category supports custom Item Specifics.
  2. If you don't already do so, you should use GetCategoryFeatures (in combination with GetCategories) to retrieve and store information about which leaf categories support features like custom Item Specifics. See Checking Category Support for Custom Item Specifics.

  3. Provide the seller with fields for entering their own custom Item Specifics.
  4. Pass the seller's Item Specific names and values in the listing request, along with all the other fields that you would normally include in the request.

When you use AddItem, the seller can specify one value per Item Specific name in listing requests, unless GetCategorySpecifics indicates that multiple values are supported.

For example, let's assume the seller is listing a gold chain bracelet with a lobster clasp in category 110433. For the custom Item Specifics, the seller is using the following names and values from their own inventory system or catalog:

Table: Seller's Names and Values
Item Specific Name Item Specific Value
Gender Women's
Metal 14k Gold
Chain Style Figaro
Chain Length 7 in.
Clasp Lobster

The following example shows the relevant portion of an AddItem request for this listing. As with any listing, it is also a good idea to test the request by using VerifyAddItem first.

Example: Seller's Custom Item Specifics in an AddItem Request
<?xml version="1.0" encoding="utf-8"?>
<AddItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <ErrorLanguage>en_US</ErrorLanguage>
  <Item>
    <!-- more elements here -->
    <ItemSpecifics>
      <NameValueList>
        <Name>Gender</Name>
        <Value>Women's</Value>
      </NameValueList>
      <NameValueList>
        <Name>Metal</Name>
        <Value>14k Gold</Value>
      </NameValueList>
      <NameValueList>
        <Name>Chain Style</Name>
        <Value>Figaro</Value>
      </NameValueList>
      <NameValueList>
        <Name>Chain Length</Name>
        <Value>7 in.</Value>
      </NameValueList>
      <NameValueList>
        <Name>Clasp</Name>
        <Value>Lobster</Value>
      </NameValueList>
    </ItemSpecifics>
    <!-- more elements here -->
    <Title>Gold Bracelet with Lobster Clasp</Title>
    <PrimaryCategory>
      <CategoryID>110433</CategoryID>
    </PrimaryCategory>
  </Item>
  <RequesterCredentials>
    <eBayAuthToken>YOURTOKENHERE</eBayAuthToken>
  </RequesterCredentials>
</AddItemRequest>

This is an easy way to include custom Item Specifics in a listing so that the names and values the seller chooses will appear in the listing's View Item page.

To achieve more consistency with other listings on eBay, you can download popular names and values from eBay. See Listing with Recommended Item Specific Names and Values.

Product Identification Using Item Specifics

Sellers must include product identifiers when listing items in certain categories, but they are encouraged to provide product identifying information for all listings. If you're using the ItemSpecifics container to provide identifiers for a catalog-enabled category, you must comply with the following validation requirements for the ItemSpecifics.Name and ItemSpecifics.Value fields.

Valid types of product identifiers in the Name field are:

For any of these Names, the Value field must comply with the following guidelines to avoid an error condition:

If the listing has variations, set ItemSpecifics.Name to Brand, specify the brand with ItemSpecifics.Value, and use MPN or a GTIN to identify the variation in VariationSpecifics or VariationSpecificsSet.

For more information about product identifiers, see Listing for Advanced Sellers.

Copyright © 2005–2017 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.