Promoting a list with Featured First

Find the answer to your question

Advanced Search

Product

Category

Language

Format

SDK

Sort by

Sort order

Published: January 08 2009, 10:14:00 PMUpdated: November 28 2020, 5:03:56 PM

Product

Trading API

How can I list an item with Featured First (first 7day option) ?

Summary

You can prompt your listing with Featured First so that your item may be appeared on the first page of search results in the Featured Items section.

Detailed Description

To list item with a seven-day duration of Featured First, you should specify PictureDetails.GalleryDuration to Days_7 and PictureDetails.GalleryType to Featured in AddItem.

Keep in mind that :

1. Featured First only available to the following eBay sites :US (SiteID 0 ), CA, CAFR, UK, IE, DE, AT, CH, and IT.

2. PictureDetails.GalleryDuration is applicable if Item.PictureDetails.GalleryType is set to Featured

Here is the sample request:

<?xml version="1.0" encoding="utf-8"?>
<AddItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <Version>589</Version>
  <ErrorLanguage>en_US</ErrorLanguage>
  <WarningLevel>High</WarningLevel>
  <Item>
    <Country>US</Country>
    <Currency>USD</Currency>
    <Description>Fixed item description.</Description>
    <DispatchTimeMax>3</DispatchTimeMax>
    <ListingDuration>Days_30</ListingDuration>
    <ListingType>FixedPriceItem</ListingType>
    <Location>San Jose, CA</Location>
    <PaymentMethods>PayPal</PaymentMethods>
    <PayPalEmailAddress>test@aol.com</PayPalEmailAddress>
    <PrimaryCategory>
      <CategoryID>1463</CategoryID>
    </PrimaryCategory>
    <Quantity>1</Quantity>
    <StartPrice>10.0</StartPrice>
    <ShippingTermsInDescription>True</ShippingTermsInDescription>
    <Title>Fixed Price item</Title>
    <PictureDetails>
      <PictureURL><![CDATA[Image URL]]></PictureURL>
      <GalleryDuration>Days_7</GalleryDuration>
      <GalleryType><![CDATA[Featured]]></GalleryType>
    </PictureDetails>
    <ReturnPolicy>
      <ReturnsAcceptedOption>ReturnsAccepted</ReturnsAcceptedOption>
      <RefundOption>MoneyBack</RefundOption>
      <ReturnsWithinOption>Days_30</ReturnsWithinOption>
      <Description>Text description of return policy details</Description>
      <ShippingCostPaidByOption>Buyer</ShippingCostPaidByOption>
    </ReturnPolicy>
    <ShippingDetails>
      <ShippingType>Flat</ShippingType>
      <InsuranceDetails>
        <InsuranceOption>Optional</InsuranceOption>
        <InsuranceFee>3.5</InsuranceFee>
      </InsuranceDetails>
           <ShippingServiceOptions>
        <ShippingServicePriority>1</ShippingServicePriority>
        <ShippingService>UPS2ndDay</ShippingService>
        <ShippingServiceCost>5</ShippingServiceCost>
        <ShippingServiceAdditionalCost>1</ShippingServiceAdditionalCost>
        <ShippingSurcharge>1</ShippingSurcharge>
      </ShippingServiceOptions>
         </ShippingDetails>
  </Item>
  <RequesterCredentials>
    <eBayAuthToken>xxx</eBayAuthToken>
  </RequesterCredentials>
</AddItemRequest>

Additional Information

API Documentation: GalleryDuration

How well did this answer your question?

Answers others found helpful