eBay::API::XML::DataType::ListingDetailsType
Various details about a listing. Some of the details are calculated or derived after an item is listed. The details in this type include the start and end time and the converted (localized) prices. The details in this type also include input values applicable to the Best Offer feature. Additional details in this type include flags indicating if a seller specified fields whose values are not visible to the requesting user.
eBay::API::XML::DataType::ListingDetailsType inherits from the eBay::API::XML::BaseDataType class
If true, the item is listed in a Mature category. Users must accept the Mature Category agreement on the eBay site to retrieve items listed in Mature categories. (Users do not need to sign this agreement to be able to list items in Mature Categories.)
# Argument: 'xs:boolean'
Calls: GetBidderList Returned: Always Calls: GetItem Returned: Always Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll Calls: GetItemTransactions GetSellerTransactions Returned: Conditionally Details: DetailLevel: ReturnAll Calls: GetSellerList Returned: Conditionally Details: DetailLevel: ItemReturnDescription, ReturnAll GranularityLevel: Medium, Fine
# Returns: 'xs:boolean'
The price at which best offers are automatically accepted. Similar in use to MinimumBestOfferPrice. If a buyer submits a best offer that is above this value, the offer is automatically accepted by the seller. Applies only to items listed in categories that support the BestOfferAutoAcceptPrice feature. Best Offer must be enabled for the item, and only the seller who listed the item will see BestOfferAutoAcceptPrice in a call response. On the US eBay Motors site (site ID 100), you cannot use the API to add a minimum best offer price. For a ReviseItem call with site ID 100, prior use of a minimum best offer price on eBay.com is ignored.
Calls: AddItem ReviseItem RelistItem VerifyAddItem RequiredInput: No
# Argument: 'ns:AmountType'
Calls: GetItem Returned: Conditionally Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll Calls: GetSellerList Returned: Conditionally Details: DetailLevel: ItemReturnDescription, ReturnAll
# Returns: 'ns:AmountType'
Applicable for Real Estate auctions only. If true, buyers and sellers are expected to follow through on the sale. If false, bids for the Real Estate auction are only expressions of interest.
Indicates whether Buy It Now is available for the listing (for Chinese and Dutch auctions). As a general rule, once a Chinese auction has bids (and the high bid exceeds the reserve price, if any), the listing is no longer eligible for Buy It Now. <br><br> On some sites, the Buy It Now price for a Chinese auction may remain available for certain categories even after a bid is placed. See the "Longer Lasting Buy It Now" link below for more details and the latest list of eBay US categories that support this behavior. The eBay Spain site supports this behavior for all categories.
SeeLink: URL: http://forums.ebay.com/db1/thread.jspa?threadID=2000449591&anticache=1207252776668 Title: Longer Lasting Buy It Now
Calls: GetBidderList Returned: Conditionally Calls: GetItem Returned: Conditionally Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll
Indicates whether checkout is enabled for this item. If true, indicates that the seller elects to allow the item purchase to go through the checkout process, if the buyer chooses to do so.
SeeLink: URL: http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=Checkout Title: Checkout
Converted value of the BuyItNowPrice in the currency of the site that returned this response. For active items, refresh this value every 24 hours to pick up the current conversion rates.
Calls: GetCategoryListings Returned: Conditionally Calls: GetItemTransactions GetSellerTransactions Returned: Conditionally Details: DetailLevel: ReturnAll Calls: GetSellerList Returned: Conditionally Details: DetailLevel: ItemReturnDescription, ReturnAll GranularityLevel: Medium, Fine Calls: GetMyeBayBuying Returned: Conditionally Details: DetailLevel: none, ReturnSummary, ReturnAll Context: SecondChanceOffer Calls: GetMyeBaySelling Returned: Conditionally Details: DetailLevel: none, ReturnSummary, ReturnAll Context: ScheduledList SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList Calls: GetBidderList Returned: Always Calls: GetItem Returned: Always Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll Calls: GetSearchResults Returned: Conditionally Details: DetailLevel: ItemReturnAttributes, ItemReturnCategories, none, ReturnAll GranularityLevel: Coarse
Converted value of the ReservePrice in the currency of the site that returned this response. Only returned for listings with a reserve price when the requesting user is the listing's seller. For active items, refresh this value every 24 hours to pick up the current conversion rates. Not applicable to Fixed Price and Store Inventory listings.
Calls: GetBidderList Returned: Conditionally Calls: GetMyeBaySelling Returned: Conditionally Details: DetailLevel: none, ReturnSummary, ReturnAll Context: ScheduledList SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList Calls: GetItemTransactions GetSellerTransactions Returned: Conditionally Details: DetailLevel: ReturnAll Calls: GetSellerList Returned: Conditionally Details: DetailLevel: ItemReturnDescription, ReturnAll GranularityLevel: Fine Calls: GetItem Returned: Conditionally Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll
Converted value of the StartPrice in the currency of the site that returned this response. For active items, refresh this value every 24 hours to pick up the current conversion rates.
Calls: GetSearchResults Returned: Conditionally Details: DetailLevel: ItemReturnAttributes, ItemReturnCategories, none, ReturnAll Calls: GetItemTransactions GetSellerTransactions Returned: Conditionally Details: DetailLevel: ReturnAll Calls: GetSellerList Returned: Conditionally Details: DetailLevel: ItemReturnDescription, ReturnAll GranularityLevel: Fine Calls: GetMyeBayBuying Returned: Conditionally Details: DetailLevel: none, ReturnSummary, ReturnAll Context: BidList LostList WonList DeletedFromWonList DeletedFromLostList Calls: GetMyeBaySelling Returned: Conditionally Details: DetailLevel: none, ReturnSummary, ReturnAll Context: ScheduledList SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList BidList Calls: GetBidderList Returned: Always Calls: GetItem Returned: Always Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll
Time stamp (in GMT) when the listing is scheduled to end (calculated based on the values of StartTime and ListingDuration) or the actual end time if the item has ended. In GetSearchResults, for StoresFixedPrice items which are "Good Till Canceled," this value is 5 minutes later than the actual end time of the item. The discrepancy is intended to facilitate renewal every 30 days of such items' end times.
# Argument: 'xs:dateTime'
Calls: GetBidderList GetDispute Returned: Always Calls: GetItem Returned: Always Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll Calls: GetItemTransactions GetSellerTransactions Returned: Conditionally Details: DetailLevel: ReturnAll Calls: GetSellerList Returned: Conditionally Details: DetailLevel: none, ItemReturnDescription, ReturnAll Calls: GetBestOffers Returned: Conditionally Details: DetailLevel: none, ReturnAll Calls: GetCategoryListings GetItemsAwaitingFeedback GetMemberMessages Returned: Conditionally Calls: GetSearchResults Returned: Conditionally Details: DetailLevel: ItemReturnAttributes, ItemReturnCategories, none, ReturnAll GranularityLevel: Coarse Calls: GetMyeBayBuying Returned: Conditionally Details: DetailLevel: none, ReturnSummary, ReturnAll Context: BidList LostList SecondChanceOffer WatchList WonList DeletedFromWonList DeletedFromLostList Calls: GetMyeBaySelling Returned: Conditionally Details: DetailLevel: none, ReturnSummary, ReturnAll Context: SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList BidList Calls: GetSellerEvents Returned: Conditionally Details: DetailLevel: none, ReturnAll Calls: GetProducts Returned: Conditionally
# Returns: 'xs:dateTime'
Indicates whether the item has any publicly displayed messages. Use GetMemberMessages to retrieve public messages for the item if this flag indicates that there are any.
Calls: GetBidderList Returned: Always Calls: GetItem Returned: Always Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll Calls: GetItemTransactions GetSellerTransactions Returned: Conditionally Details: DetailLevel: ReturnAll Calls: GetSellerList Returned: Conditionally Details: DetailLevel: ItemReturnDescription, ReturnAll
If true, the seller specified a value in ReservePrice.
Calls: GetBidderList Returned: Always Calls: GetItem Returned: Always Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll Calls: GetItemTransactions GetSellerTransactions Returned: Conditionally Details: DetailLevel: ReturnAll Calls: GetSellerList Returned: Conditionally Details: DetailLevel: ItemReturnDescription, ReturnAll GranularityLevel: Medium, Fine Calls: GetMyeBayBuying Returned: Conditionally Details: DetailLevel: none, ReturnSummary, ReturnAll Context: WonList DeletedFromWonList
Indicates whether the item has any unanswered questions. Use GetMemberMessages to retrieve unanswered questions for the item if this flag indicates that there are any.
Specifies a distance (in miles) used as the radius of the area about the supplied postal code that constitutes the local market. Use GetCategoryFeatures to determine the local listing distances supported by a given site, category, and Local Market subscription level.
Calls: AddItem GetItemRecommendations RequiredInput: Conditionally
# Argument: 'xs:string'
# Returns: 'xs:string'
Specifies the message sent from the seller to the buyer when a submitted best offer is automatically declined by the seller. A best offer is automatically declined if it does not meet the minimum acceptable best offer price specified by the seller with MinimumBestOfferPrice. Applies only to items listed in categories that support the Best Offer Auto-Decline feature. Best Offer must be enabled for the item. To remove this value when revising or relisting an item, use DeletedField.
DeprecationDetails: NoOp DeprecationVersion: 547 UseInstead: Calls: AddItem GetItemRecommendations ReviseItem RelistItem VerifyAddItem RequiredInput: No
Calls: GetItem Returned: Conditionally Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll Calls: GetItemTransactions GetSellerTransactions Returned: Conditionally Details: DetailLevel: ReturnAll Calls: GetSellerList Returned: Conditionally Details: DetailLevel: ItemReturnDescription, ReturnAll
Specifies the minimum acceptable best offer price. If a buyer submits a best offer that is below this value, the offer is automatically declined by the seller. Applies only to items listed in categories that support the Best Offer Auto-Decline feature. Best Offer must be enabled for the item, and only the seller who listed the item can see this value. To remove this value when revising or relisting an item, use DeletedField.
Calls: AddItem GetItemRecommendations ReviseItem RelistItem VerifyAddItem RequiredInput: No
If true as an input or output field, the item is pay-per-lead-enabled. This field applies to the pay-per-lead feature, which is planned for availability on the US site in upcoming months.
Default: false
Indicates the new item ID for a re-listed item. When an item is re-listed, the item ID for the new (re-list) item is added to the old (expired) listing to provide buyers a means to navigate to the new listing. This value only appears when the old listing is retrieved. Output only.
# Argument: 'ns:ItemIDType'
Calls: GetBidderList Returned: Conditionally Calls: GetItem Returned: Conditionally Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll Calls: GetItemTransactions GetSellerTransactions Returned: Conditionally Details: DetailLevel: ReturnAll Calls: GetSellerList Returned: Conditionally Details: DetailLevel: ItemReturnDescription, ReturnAll
# Returns: 'ns:ItemIDType'
The item ID for the original listing from which a second chance offer is made. This value is only returned when the data for the second chance offer listing is retrieved. Output only.
Type of seller account. This value is not returned for most sites. This value is not returned for the German site (site ID 77) or eBay Motors site (site ID 100).
# Argument: 'ns:SellerBusinessCodeType'
Calls: GetSearchResults Returned: Conditionally Details: DetailLevel: ItemReturnAttributes, ItemReturnCategories, none, ReturnAll
# Returns: 'ns:SellerBusinessCodeType'
The StartTime value returned by non-search calls such as GetItem is the time stamp (in GMT) for when the item was listed. The StartTime value returned by search calls such as GetSearchResults and GetCategoryListings may vary from the value returned by GetItem. The time value is the same value in the following: The StartTime value returned by GetSearchResults, the StartTime value returned by GetCategoryListings, and the time the item became available for search on the eBay site.
Calls: GetBidderList GetDispute Returned: Always Calls: GetItem Returned: Always Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll Calls: GetCategoryListings GetMemberMessages GetProducts Returned: Conditionally Calls: GetSearchResults Returned: Conditionally Details: DetailLevel: ItemReturnAttributes, ItemReturnCategories, none, ReturnAll GranularityLevel: Coarse Calls: GetItemTransactions GetSellerTransactions Returned: Conditionally Details: DetailLevel: ReturnAll Calls: GetSellerList Returned: Conditionally Details: DetailLevel: none, ItemReturnDescription, ReturnAll Calls: GetMyeBayBuying Returned: Conditionally Details: DetailLevel: none, ReturnSummary, ReturnAll Context: BestOfferList BidList LostList WatchList WonList DeletedFromWonList DeletedFromLostList Calls: GetMyeBaySelling Returned: Conditionally Details: DetailLevel: none, ReturnSummary, ReturnAll Context: ActiveList ScheduledList SoldList UnsoldList DeletedFromSoldList DeletedFromUnsoldList BidList Calls: GetSellerEvents Returned: Conditionally Details: DetailLevel: none, ReturnAll
Indicates the item ID of the original item listing from which a Transaction Confirmation Request (TCR) was created. This value is only returned when the data for a TCR is retrieved.
Calls: GetItem Returned: Conditionally Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll Calls: GetItemTransactions GetSellerTransactions Returned: Conditionally Details: DetailLevel: ReturnAll Calls: GetSellerList Returned: Conditionally Details: DetailLevel: none, ItemReturnDescription, ReturnAll Calls: GetBidderList Returned: Conditionally
The URL of the Web page where a user can view the listing. On the US site, this is called the "View Item" page. If you enabled affiliate tracking in a search-related call (for example, if you used the AffiliateTrackingDetails container in an applicable call), ViewItemURL contains a string that includes affiliate tracking information (see the <a href="https://www.ebaypartnernetwork.com" target="_blank">eBay Partner Network</a>). For GetSearchResultsExpress, the ViewItemURL field is returned only if you specified AffiliateTrackingDetails in the request.
# Argument: 'xs:anyURI'
Calls: GetBidderList Returned: Always Calls: GetItem Returned: Always Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll Calls: GetCategoryListings GetProducts Returned: Conditionally Calls: GetMyeBayBuying Returned: Conditionally Details: DetailLevel: none, ReturnSummary, ReturnAll Context: WatchList Calls: GetSearchResults Returned: Conditionally Details: DetailLevel: ItemReturnAttributes, ItemReturnCategories, none, ReturnAll GranularityLevel: Coarse Calls: GetItemTransactions GetSellerTransactions Returned: Conditionally Details: DetailLevel: ReturnAll Calls: GetSellerList Returned: Conditionally Details: DetailLevel: ItemReturnDescription, ReturnAll
# Returns: 'xs:anyURI'
This URL takes you to the same View Item page as ViewItemURL, but this URL is optimized to support natural search. That is, this URL is designed to make items on eBay easier to find via popular Internet search engines. For example, this URL specifies the item title, and it is optimized for natural search: "_W0QQ" is like "?" (question mark), "QQ" is like "&" (ampersand), and "Z" is like "=" (equals sign). <br> <br> <span class="tablenote"><b>Note</b>: This URL may include additional query parameters that don't appear in ViewItemURL and vice versa. You should not modify the query syntax. For example, eBay won't recognize the URL if you change QQ to ?.</span>
Calls: GetSearchResults Returned: Conditionally Details: DetailLevel: ItemReturnAttributes, ItemReturnCategories, none, ReturnAll GranularityLevel: Coarse Calls: GetCategoryListings Returned: Conditionally Calls: GetBidderList Returned: Conditionally Calls: GetItem Returned: Conditionally Details: DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll Calls: GetItemTransactions GetSellerTransactions Returned: Conditionally Details: DetailLevel: ReturnAll Calls: GetSellerList Returned: Conditionally Details: DetailLevel: ItemReturnDescription, ReturnAll Calls: GetProducts Returned: Conditionally
To install eBay::API, copy and paste the appropriate command in to your terminal.
cpanm
cpanm eBay::API
CPAN shell
perl -MCPAN -e shell install eBay::API
For more information on module installation, please visit the detailed CPAN module installation guide.