Skip to main content
Published: February 02 2009, 12:42:00 PMUpdated: November 28 2020, 5:16:29 PM

I need a quick guide to help me list a car on ebay motors.


1. Use GetCategories to find the category where you want to list your eBay motors item. Note that you can only list in leaf categories.

 <?xml version="1.0" encoding="utf-8"?>
<GetCategoriesRequest xmlns="urn:ebay:apis:eBLBaseComponents"> 
    <RequesterCredentials>
    <eBayAuthToken>YourTokenHere</eBayAuthToken>
  </RequesterCredentials>
  <CategorySiteID>100</CategorySiteID>
  <ViewAllNodes>false</ViewAllNodes>
  <DetailLevel>ReturnAll</DetailLevel>
</GetCategoriesRequest>

Lets say you want to list your car in category 6009.

2. Use GetCategory2CS to retrieve the AttributeSetID to be used to retrieve the item specifics. Item Specifics are optional when listing in most categories; however, some categories (such as Real Estate, US Tickets, and US eBay Motors) require Item Specifics.

 <?xml version="1.0" encoding="utf-8"?>
<GetCategory2CSRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <DetailLevel>ReturnAll</DetailLevel> 
    <RequesterCredentials>
    <eBayAuthToken>YourTokenHere</eBayAuthToken>
  </RequesterCredentials>
  <CategoryID>6009</CategoryID>
</GetCategory2CSRequest>

From the response you will see that categoryID 6009 is mapped to AttributeSetID 1137.

3. Use GetAttributesCS, GetAttributesXSL to retrieve the item specifics. The response will contain a list of all the attributes that are applicable along with related meta-data. The meta-data specifies all the possible values of each attribute, the logic for presenting the attributes to a user, and rules for validating the user's selections.

 <?xml version="1.0" encoding="utf-8"?>
<GetAttributesCSRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <DetailLevel>ReturnAll</DetailLevel> 
    <RequesterCredentials>
    <eBayAuthToken>YourTokenHere</eBayAuthToken>
  </RequesterCredentials>
  <AttributeSetID>1137</AttributeSetID>
</GetAttributesCSRequest>



4. Use the item specifics information and make the AddItem call.

 <?xml version="1.0" encoding="utf-8"?>
<AddItemRequest xmlns="urn:ebay:apis:eBLBaseComponents"> 
    <RequesterCredentials>
    <eBayAuthToken>YourTokenHere</eBayAuthToken>
  </RequesterCredentials>
  <WarningLevel>High</WarningLevel>
  <Item>
    <BuyItNowPrice currencyID="USD">10.00</BuyItNowPrice>
    <CategoryMappingAllowed>true</CategoryMappingAllowed>
    <Country>US</Country>
    <Currency>USD</Currency>
    <Description>Test - do not bid - Post-1981 Motors listing</Description>
    <ListingDuration>Days_7</ListingDuration>
    <ListingType>Chinese</ListingType>
    <Location>San Jose, CA</Location>
    <PaymentMethods>PaymentSeeDescription</PaymentMethods>
    <PaymentDetails>
      <HoursToDeposit>48</HoursToDeposit>
      <DaysToFullPayment>7</DaysToFullPayment>
    </PaymentDetails>
    <PrimaryCategory>
      <CategoryID>6009</CategoryID>
    </PrimaryCategory>
    <Quantity>1</Quantity>
    <Site>eBayMotors</Site>
    <StartPrice currencyID="USD">2.00</StartPrice>
    <Title>eBay Motors drops this title value</Title>
    <AttributeSetArray>
      <AttributeSet attributeSetID="1137">
        <Attribute attributeID="10236">
          <Value>
            <ValueLiteral>WBAHL83566DT01791</ValueLiteral>
            <ValueID>-3</ValueID>
          </Value>
        </Attribute>
        <Attribute attributeID="10719">
          <Value>
            <ValueLiteral>Black</ValueLiteral>
            <ValueID>2288</ValueID>
          </Value>
        </Attribute>
        <Attribute attributeID="10718">
          <Value>
            <ValueLiteral>8</ValueLiteral>
            <ValueID>1032</ValueID>
          </Value>
        </Attribute>
        <Attribute attributeID="85">
          <Value>
            <ValueLiteral>40596</ValueLiteral>
            <ValueID>-3</ValueID>
          </Value>
        </Attribute>
        <Attribute attributeID="10242">
          <!-- Existing Warranty; displayed as Warranty field in
               Item Specifics, value shown as "Existing" for 10721
               or as "No" for 10722. -->
          <Value>
            <!-- Vehicle has an existing warranty (specify details in Description) -->
            <ValueID>10721</ValueID>
          </Value>
        </Attribute>
        <Attribute attributeID="38">
          <Value>
            <ValueLiteral>20060000</ValueLiteral>
            <ValueID>-5</ValueID>
          </Value>
        </Attribute>
        <Attribute attributeID="10239">
          <!-- Transmission; displayed as Transmission field in Item Specifics -->
          <Value>
            <!-- Automatic -->
            <ValueID>10427</ValueID>
          </Value>
        </Attribute>
        <Attribute attributeID="10243">
          <!-- Type of vehicle title; displayed as Title field in Item Specifics -->
          <Value>
            <!-- Clear (most titles) -->
            <ValueID>10448</ValueID>
          </Value>
        </Attribute>
        <Attribute attributeID="10244">
          <Value>
            <ValueLiteral>Used</ValueLiteral>
            <ValueID>10426</ValueID>
          </Value>
        </Attribute>
        <Attribute attributeID="10246">
          <Value>
            <ValueLiteral>Test</ValueLiteral>
            <ValueID>-3</ValueID>
          </Value>
        </Attribute>
      </AttributeSet>
    </AttributeSetArray>
  </Item>
</AddItemRequest>


Note: When making these calls the Site ID in your header should be 100 since you are dealing with eBay Motors.

Additional Resources


The following topics might be a good reference -

  • Using Item Specifics in eBay Motors US Listings
  • Valid Item Specifics for Listing eBay Motors US Cars & Trucks


How well did this answer your question?
Answers others found helpful