Skip to main content
Published: February 28 2006, 1:00:00 AMUpdated: July 26 2022, 4:04:09 AM

Where can I find documentation that spells out what ListingDurations are allowed for the different types of items on each site?

The GetCategoryFeatures call should be used to get the Listing Duration Logic for each site.
It is advised that this call be made once a day for each siteid with a DetailLevel of ReturnAll.

With GetCategoryFeatures, you also have the ability of getting information about a specific feature by using the FeatureID field.

Here is an example of how to use the GetCategoryFeatures call to get the different Listing Durations for the US site with the FeatureID set to ListingDurations:

<?xml version="1.0" encoding="utf-8"?>
<GetCategoryFeaturesRequest xmlns="urn:ebay:apis:eBLBaseComponents">
<FeatureID>ListingDurations</FeatureID>
<DetailLevel>ReturnAll</DetailLevel>
<RequesterCredentials>
<eBayAuthToken>token</eBayAuthToken>
</RequesterCredentials>
</GetCategoryFeaturesRequest>

The response XML will have the following as part of the entire response:

<SiteDefaults>
<ListingDuration type="FixedPriceItem">1</ListingDuration>
<ListingDuration type="PersonalOffer">1</ListingDuration>
<ListingDuration type="StoresFixedPrice">7</ListingDuration>
<ListingDuration type="AdType">2</ListingDuration>
<ListingDuration type="Live">1</ListingDuration>
<ListingDuration type="Dutch">1</ListingDuration>
<ListingDuration type="Chinese">1</ListingDuration>
...
<FeatureDefinitions>
<ListingDurations Version="4">
<ListingDuration durationSetID="8">
<Duration>Days_3</Duration>
<Duration>Days_5</Duration>
<Duration>Days_7</Duration>
<Duration>Days_10</Duration>
<Duration>Days_30</Duration>
</ListingDuration>
<ListingDuration durationSetID="7">
<Duration>Days_30</Duration>
<Duration>GTC</Duration>
</ListingDuration>
<ListingDuration durationSetID="14">
<Duration>Days_30</Duration>
<Duration>Days_60</Duration>
<Duration>Days_90</Duration>
</ListingDuration>
<ListingDuration durationSetID="2">
<Duration>Days_30</Duration>
<Duration>Days_90</Duration>
</ListingDuration>
<ListingDuration durationSetID="1">
<Duration>Days_3</Duration>
<Duration>Days_5</Duration>
<Duration>Days_7</Duration>
<Duration>Days_10</Duration>
</ListingDuration>
</ListingDurations>
...

The response is interpreted like this:

For Chinese items you find the value of the SiteDefaults.ListingDuration node whose type xml attribute value is "Chinese". This value would be 1 as can be seen from this XML:
<ListingDuration type="Chinese">1</ListingDuration>
Now you find the ListingDuration child node of FeatureDefinitions.ListingDurations whose durationSetID xml attribute value is the same as the value we have in hand ("1" in our case).
This would point us to the following XML:
<ListingDuration durationSetID="1">
<Duration>Days_3</Duration>
<Duration>Days_5</Duration>
<Duration>Days_7</Duration>
<Duration>Days_10</Duration>
</ListingDuration>
Each Duration child node is a valid Duration. So we know that Chinese items have the following valid durations:
Days_3
Days_5
Days_7
Days_10

We follow the same steps for the different types of items indicated in the list:
<ListingDuration type="FixedPriceItem">1</ListingDuration>
<ListingDuration type="PersonalOffer">1</ListingDuration>
<ListingDuration type="StoresFixedPrice">7</ListingDuration>
<ListingDuration type="AdType">2</ListingDuration>
<ListingDuration type="Live">1</ListingDuration>
<ListingDuration type="Dutch">1</ListingDuration>
<ListingDuration type="Chinese">1</ListingDuration>

and we find the following Durations are valid for these item types:

FixedPriceItem, PersonalOffer, Live, Dutch, Chinese
Days_3
Days_5
Days_7
Days_10

StoresFixedPrice
Days_30
GTC

AdType
Days_30
Days_90

The above steps should be done for each siteid to get the valid listing durations for each type of item.

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

Got thoughts? Click the feedback button – your insights help us improve!