Skip to main content
Published: April 19 2007, 5:28:00 PMUpdated: November 28 2020, 3:37:22 PM

Should I modify an item.Description using AddToItemDescription instead ReviseItem call?

Detailed Description

    A listing description can be modified via AddToItemDescription or ReviseItem API call. 

  • AddToItemDescription
    • Making AddToItemDescription call does not change the given listing's  ReviseStatus value
    • AddToItemDescription appends text to the end of the given listing's Description. The API keeps the original description and appends a section that contains the new description along with the timestamp to the end of the Description area showing on the View Item page as below:

<?xml version="1.0" encoding="utf-8" ?>

   <AddToItemDescriptionRequestxmlns="urn:ebay:apis:eBLBaseComponents">
  <ErrorLanguage>en_US</ErrorLanguage>
  <WarningLevel>High</WarningLevel>
  <Version>505</Version>
  <ItemID>2204910727</ItemID>
  <Description> - TEXT APPENDED VIA ADDTOITEMDESCRIPTION API CALL</Description>
  <RequesterCredentials>
  <eBayAuthToken>TOKEN</eBayAuthToken>
  </RequesterCredentials>
  </AddToItemDescriptionRequest>
 
  •  ReviseItem
    • Changing Item.Description via ReviseItem API alter the given listing's ReviseStatus value from false to true
    • ReviseItem allows you to Append, Prepend or Replace an listing's description with DescriptionReviseMode property as follows.
 
 
<?xml version="1.0" encoding="utf-8" ?>
   <ReviseItemRequestxmlns="urn:ebay:apis:eBLBaseComponents">
   <Version>505</Version>
   <ErrorLanguage>en_US</ErrorLanguage>
   <WarningLevel>High</WarningLevel>
   <Item>
   <ItemID>150000461794</ItemID>
   <Description>  - TEXT APPENDED VIA REVISEITEM API CALL</Description>
  <DescriptionReviseMode>Append</DescriptionReviseMode>
  </Item>
   <RequesterCredentials>
  <eBayAuthToken>TOKEN</eBayAuthToken>
  </RequesterCredentials>
  </ReviseItemRequest>

Additional Resources

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