eBay Shopping API Call Reference Version 643 Support     Knowledge Base     Forums     All Tutorials     All Code Samples Shopping API Guide Call Reference Making an API Call Tutorials Release Notes

List of All Calls Field Index Enumeration Index Type Index Deprecated Objects Errors by Number Input Output Detail Controls Samples Change History

GetSingleItem gets publicly visible details about one listing on eBay. This gives you most of the data that eBay shows to the general public on the View Item page (title, description, basic price information, and other details).

See the Input and Output sections below for a complete list of fields in this call.

You just need to know the eBay item ID (a value like 123456789012) in order to retrieve the listing. Typically, you use FindItems to find listings by keyword or by seller, then use the ItemID value from one of those items as input to GetSingleItem. If a listing ended more than 90 days ago, its title, price, and other item information are not returned.

Best Practices

GetSingleItem has been optimized for response size, speed and usability. So, it returns the most commonly used fields by default. Use the IncludeSelector field to get more data—but please note that getting more data can result in longer response times.

See Sample: Basic Call for a sample that returns the default fields. See Sample: Getting the Full Description and Item Specifics for a sample that returns more data.

Refreshing Item Data

If you're monitoring the same item over time, most of the data (such as the seller and the full text of the description) doesn't change at all, or changes rarely. A few pieces of information (like the bid count) change more often.

So, after you initially retrieve an item's details, cache the item data locally, and then use GetItemStatus from then on to more quickly update the details that tend to change. Depending on your use case, you can call GetSingleItem again occasionally to see if the seller has revised any other data in the listing.

Getting Shipping Details

If you want to see an item's shipping cost summary, specify ShippingCosts in IncludeSelector.

See Sample: Including a Shipping Cost Summary for a sample that shows how to add a listing's shipping cost summary to the default results.

Once you know the item has shipping costs, you can call GetShippingCosts with the same item ID if you need more shipping details.

If you're showing an item to a potential buyer and you know where that buyer is located, it may be helpful to check where the seller is willing to ship the item (ShipToLocations). Some sellers will ship worldwide, and others prefer to ship to certain countries or regions only.

Getting an Item from a Different eBay Site

Item IDs are unique across all eBay sites, so you normally don't need to specify a different site ID with your GetSingleItem request to get an item that was listed on another eBay site. (This is a little different from the way FindItems works.)

In fact, if you send your request to the US site and the item was listed on the eBay UK site, we'll give you the original price in Pounds (GBP), and we'll calculate the converted price in US dollars (USD) for you (based on the current exchange rate).

See Sample: Getting a Foreign Listing with Converted Prices for a sample that shows how this works.

By the way, we always return converted prices, even when no conversion takes place. So, if you're comparing the current price of different items and you don't care which site they're listed on, it is simplest to compare the ConvertedCurrentPrice values of each item.

More Tips

If you discover other useful practices, feel free to add them in the User-Contributed Notes at the bottom of this page.

If you're looking for more tips, try searching the Knowledge Base and Developer Forums.

For information about specifying affiliate parameters, see Affiliate URL Parameters and HTTP Header Values.

Related Information

See also the reference documentation for these calls:

• FindItems - Searches for items based on a query or a seller ID. If you use keywords, this call returns items that contain the keywords in the title. A maximum of 50 items is returned.
• GetItemStatus - Allows you to get the status for a group of items. Returns status information such as ListingStatus and End Time for all items that are listed in the request. Duplicated items are returned as a single item.
• GetShippingCosts - Gets shipping costs for an item.
• GetSingleItem - Gets publicly visible details about one listing. This gives you most of the data that eBay shows on the View Item page (title, description, price, and other details).

Back to top

The box below lists all fields that could be included in the call request. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also Samples.

See also the Deprecated Objects link above. Fields presented in this color are deprecated, and fields presented in this color are (or soon will be) non-operational.

<?xml version="1.0" encoding="utf-8"?>
<GetSingleItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Standard Input Fields -->
  <MessageID> string </MessageID>
  <!-- Call-specific Input Fields -->
  <IncludeSelector> string </IncludeSelector>
  <ItemID> string </ItemID>
  <VariationSKU> string </VariationSKU>
  <VariationSpecifics> NameValueListArrayType 
    <NameValueList> NameValueListType 
      <Name> string </Name>
      <Value> string </Value>
      <!-- ... more Value nodes here ... -->
    </NameValueList>
    <!-- ... more NameValueList nodes here ... -->
  </VariationSpecifics>
</GetSingleItemRequest>

Back to top

The box below lists all fields that might be returned in the response. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also Samples.

See also the Deprecated Objects link above. Fields presented in this color are deprecated, and fields presented in this color are not returned (or soon will not be returned) or are not operational (or soon will be non-operational).

<?xml version="1.0" encoding="utf-8"?>
<GetSingleItemResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Standard Output Fields -->
  <Ack> AckCodeType </Ack>
  <Build> string </Build>
  <CorrelationID> string </CorrelationID>
  <Errors> ErrorType 
    <ErrorClassification> ErrorClassificationCodeType </ErrorClassification>
    <ErrorCode> token </ErrorCode>
    <ErrorParameters ParamID="string"> ErrorParameterType 
      <Value> string </Value>
    </ErrorParameters>
    <!-- ... more ErrorParameters nodes here ... -->
    <LongMessage> string </LongMessage>
    <SeverityCode> SeverityCodeType </SeverityCode>
    <ShortMessage> string </ShortMessage>
  </Errors>
  <!-- ... more Errors nodes here ... -->
  <Timestamp> dateTime </Timestamp>
  <Version> string </Version>
  <!-- Call-specific Output Fields -->
  <Item> SimpleItemType 
    <AutoPay> boolean </AutoPay>
    <BestOfferEnabled> boolean </BestOfferEnabled>
    <BidCount> int </BidCount>
    <BusinessSellerDetails> BusinessSellerDetailsType 
      <AdditionalContactInformation> string </AdditionalContactInformation>
      <Address> AddressType 
        <CityName> string </CityName>
        <CompanyName> string </CompanyName>
        <FirstName> string </FirstName>
        <LastName> string </LastName>
        <Name> string </Name>
        <Phone> string </Phone>
        <PostalCode> string </PostalCode>
        <StateOrProvince> string </StateOrProvince>
        <Street1> string </Street1>
        <Street2> string </Street2>
      </Address>
      <Email> string </Email>
      <Fax> string </Fax>
      <LegalInvoice> boolean </LegalInvoice>
      <TermsAndConditions> string </TermsAndConditions>
      <TradeRegistrationNumber> string </TradeRegistrationNumber>
      <VATDetails> VATDetailsType 
        <VATID> string </VATID>
        <VATSite> string </VATSite>
      </VATDetails>
    </BusinessSellerDetails>
    <BuyItNowAvailable> boolean </BuyItNowAvailable>
    <BuyItNowPrice currencyID="CurrencyCodeType"> AmountType (double) </BuyItNowPrice>
    <Charity> CharityType 
      <CharityID> string </CharityID>
      <CharityName> string </CharityName>
      <CharityNumber> int </CharityNumber>
      <DonationPercent> float </DonationPercent>
      <LogoURL> string </LogoURL>
      <Mission> string </Mission>
      <Status> CharityStatusCodeType </Status>
    </Charity>
    <ConvertedBuyItNowPrice currencyID="CurrencyCodeType"> AmountType (double) </ConvertedBuyItNowPrice>
    <ConvertedCurrentPrice currencyID="CurrencyCodeType"> AmountType (double) </ConvertedCurrentPrice>
    <Country> CountryCodeType </Country>
    <CurrentPrice currencyID="CurrencyCodeType"> AmountType (double) </CurrentPrice>
    <Description> string </Description>
    <EndTime> dateTime </EndTime>
    <GalleryURL> anyURI </GalleryURL>
    <HandlingTime> int </HandlingTime>
    <HighBidder> SimpleUserType 
      <FeedbackPrivate> boolean </FeedbackPrivate>
      <FeedbackRatingStar> FeedbackRatingStarCodeType </FeedbackRatingStar>
      <FeedbackScore> int </FeedbackScore>
      <UserAnonymized> boolean </UserAnonymized>
      <UserID> string </UserID>
    </HighBidder>
    <HitCount> long </HitCount>
    <IntegratedMerchantCreditCardEnabled> boolean </IntegratedMerchantCreditCardEnabled>
    <ItemID> string </ItemID>
    <ItemSpecifics> NameValueListArrayType 
      <NameValueList> NameValueListType 
        <Name> string </Name>
        <Value> string </Value>
        <!-- ... more Value nodes here ... -->
      </NameValueList>
      <!-- ... more NameValueList nodes here ... -->
    </ItemSpecifics>
    <ListingStatus> ListingStatusCodeType </ListingStatus>
    <ListingType> ListingTypeCodeType </ListingType>
    <Location> string </Location>
    <LotSize> int </LotSize>
    <MinimumToBid currencyID="CurrencyCodeType"> AmountType (double) </MinimumToBid>
    <PaymentAllowedSite> SiteCodeType </PaymentAllowedSite>
    <!-- ... more PaymentAllowedSite nodes here ... -->
    <PaymentMethods> BuyerPaymentMethodCodeType </PaymentMethods>
    <!-- ... more PaymentMethods nodes here ... -->
    <PictureURL> anyURI </PictureURL>
    <!-- ... more PictureURL nodes here ... -->
    <PostalCode> string </PostalCode>
    <PrimaryCategoryID> string </PrimaryCategoryID>
    <PrimaryCategoryIDPath> string </PrimaryCategoryIDPath>
    <PrimaryCategoryName> string </PrimaryCategoryName>
    <ProductID> ProductIDType (string) </ProductID>
    <Quantity> int </Quantity>
    <QuantitySold> int </QuantitySold>
    <ReserveMet> boolean </ReserveMet>
    <ReturnPolicy> ReturnPolicyType 
      <Description> string </Description>
      <EAN> string </EAN>
      <Refund> string </Refund>
      <ReturnsAccepted> string </ReturnsAccepted>
      <ReturnsWithin> string </ReturnsWithin>
      <ShippingCostPaidBy> string </ShippingCostPaidBy>
      <WarrantyDuration> string </WarrantyDuration>
      <WarrantyOffered> string </WarrantyOffered>
      <WarrantyType> string </WarrantyType>
    </ReturnPolicy>
    <SecondaryCategoryID> string </SecondaryCategoryID>
    <SecondaryCategoryIDPath> string </SecondaryCategoryIDPath>
    <SecondaryCategoryName> string </SecondaryCategoryName>
    <Seller> SimpleUserType 
      <FeedbackRatingStar> FeedbackRatingStarCodeType </FeedbackRatingStar>
      <FeedbackScore> int </FeedbackScore>
      <PositiveFeedbackPercent> float </PositiveFeedbackPercent>
      <UserID> string </UserID>
    </Seller>
    <ShippingCostSummary> ShippingCostSummaryType 
      <InsuranceCost currencyID="CurrencyCodeType"> AmountType (double) </InsuranceCost>
      <ListedShippingServiceCost currencyID="CurrencyCodeType"> AmountType (double) </ListedShippingServiceCost>
      <ShippingServiceCost currencyID="CurrencyCodeType"> AmountType (double) </ShippingServiceCost>
      <ShippingType> ShippingTypeCodeType </ShippingType>
    </ShippingCostSummary>
    <ShipToLocations> string </ShipToLocations>
    <!-- ... more ShipToLocations nodes here ... -->
    <Site> SiteCodeType </Site>
    <StartTime> dateTime </StartTime>
    <Storefront> StorefrontType 
      <StoreName> string </StoreName>
      <StoreURL> anyURI </StoreURL>
    </Storefront>
    <Subtitle> string </Subtitle>
    <TimeLeft> duration </TimeLeft>
    <Title> string </Title>
    <Variations> VariationsType 
      <Pictures> PicturesType 
        <VariationSpecificName> string </VariationSpecificName>
        <VariationSpecificPictureSet> VariationSpecificPictureSetType 
          <PictureURL> anyURI </PictureURL>
          <!-- ... more PictureURL nodes here ... -->
          <VariationSpecificValue> string </VariationSpecificValue>
        </VariationSpecificPictureSet>
        <!-- ... more VariationSpecificPictureSet nodes here ... -->
      </Pictures>
      <!-- ... more Pictures nodes here ... -->
      <Variation> VariationType 
        <Quantity> int </Quantity>
        <SellingStatus> SellingStatusType 
          <QuantitySold> int </QuantitySold>
        </SellingStatus>
        <SKU> string </SKU>
        <StartPrice currencyID="CurrencyCodeType"> AmountType (double) </StartPrice>
        <VariationSpecifics> NameValueListArrayType 
          <NameValueList> NameValueListType 
            <Name> string </Name>
            <Value> string </Value>
            <!-- ... more Value nodes here ... -->
          </NameValueList>
          <!-- ... more NameValueList nodes here ... -->
        </VariationSpecifics>
      </Variation>
      <!-- ... more Variation nodes here ... -->
      <VariationSpecificsSet> NameValueListArrayType 
        <NameValueList> NameValueListType 
          <Name> string </Name>
          <Value> string </Value>
          <!-- ... more Value nodes here ... -->
        </NameValueList>
        <!-- ... more NameValueList nodes here ... -->
      </VariationSpecificsSet>
    </Variations>
    <ViewItemURLForNaturalSearch> anyURI </ViewItemURLForNaturalSearch>
  </Item>
</GetSingleItemResponse>

Back to top

The IncludeSelector input field gives you control over which call-specific output fields may be returned from your queries. IncludeSelector accepts a set of preset values, each of which permits the return of a different set of fields. (All standard output fields are returned regardless of IncludeSelector.)

The table below details the fields that each IncludeSelector value controls. In addition, the table includes a none column that shows the fields that are not controlled by IncludeSelector settings. Note that some fields are returned only when certain conditions are met; see the associated field description for a clarification of these conditions.

Output Field	none	Description	Details	ItemSpecifics	ShippingCosts	TextDescription	Variations
Item	Y	-	-	-	-	-	-
Item.AutoPay	Y	-	-	-	-	-	-
Item.BestOfferEnabled	-	-	Y	-	-	-	-
Item.BidCount	Y	-	-	-	-	-	-
Item.BusinessSellerDetails	-	-	(Y)	-	-	-	-
Item.BusinessSellerDetails.AdditionalContactInformation	-	-	(Y)	-	-	-	-
Item.BusinessSellerDetails.Address	-	-	(Y)	-	-	-	-
Item.BusinessSellerDetails.Address.CityName	-	-	(Y)	-	-	-	-
Item.BusinessSellerDetails.Address.CompanyName	-	-	(Y)	-	-	-	-
Item.BusinessSellerDetails.Address.FirstName	-	-	(Y)	-	-	-	-
Item.BusinessSellerDetails.Address.LastName	-	-	(Y)	-	-	-	-
Item.BusinessSellerDetails.Address.Name	-	-	(Y)	-	-	-	-
Item.BusinessSellerDetails.Address.Phone	-	-	(Y)	-	-	-	-
Item.BusinessSellerDetails.Address.PostalCode	-	-	(Y)	-	-	-	-
Item.BusinessSellerDetails.Address.StateOrProvince	-	-	(Y)	-	-	-	-
Item.BusinessSellerDetails.Address.Street1	-	-	(Y)	-	-	-	-
Item.BusinessSellerDetails.Address.Street2	-	-	(Y)	-	-	-	-
Item.BusinessSellerDetails.Email	-	-	(Y)	-	-	-	-
Item.BusinessSellerDetails.Fax	-	-	(Y)	-	-	-	-
Item.BusinessSellerDetails.LegalInvoice	-	-	(Y)	-	-	-	-
Item.BusinessSellerDetails.TermsAndConditions	-	-	(Y)	-	-	-	-
Item.BusinessSellerDetails.TradeRegistrationNumber	-	-	(Y)	-	-	-	-
Item.BusinessSellerDetails.VATDetails	-	-	(Y)	-	-	-	-
Item.BusinessSellerDetails.VATDetails.VATID	-	-	(Y)	-	-	-	-
Item.BusinessSellerDetails.VATDetails.VATSite	-	-	(Y)	-	-	-	-
Item.BuyItNowAvailable	(Y)	-	-	-	-	-	-
Item.BuyItNowPrice	-	-	(Y)	-	-	-	-
Item.Charity	-	-	(Y)	-	-	-	-
Item.Charity.CharityID	-	-	(Y)	-	-	-	-
Item.Charity.CharityName	-	-	(Y)	-	-	-	-
Item.Charity.CharityNumber	-	-	(Y)	-	-	-	-
Item.Charity.DonationPercent	-	-	(Y)	-	-	-	-
Item.Charity.LogoURL	-	-	(Y)	-	-	-	-
Item.Charity.Mission	-	-	(Y)	-	-	-	-
Item.Charity.Status	-	-	(Y)	-	-	-	-
Item.ConvertedBuyItNowPrice	(Y)	-	-	-	-	-	-
Item.ConvertedCurrentPrice	Y	-	-	-	-	-	-
Item.Country	Y	-	-	-	-	-	-
Item.CurrentPrice	-	-	Y	-	-	-	-
Item.Description	-	Y	-	-	-	Y	-
Item.EndTime	Y	-	-	-	-	-	-
Item.GalleryURL	(Y)	-	-	-	-	-	-
Item.HandlingTime	-	-	(Y)	-	-	-	-
Item.HighBidder	-	-	(Y)	-	-	-	-
Item.HighBidder.FeedbackPrivate	-	-	(Y)	-	-	-	-
Item.HighBidder.FeedbackRatingStar	-	-	(Y)	-	-	-	-
Item.HighBidder.FeedbackScore	-	-	(Y)	-	-	-	-
Item.HighBidder.UserAnonymized	-	-	(Y)	-	-	-	-
Item.HighBidder.UserID	-	-	(Y)	-	-	-	-
Item.HitCount	-	-	(Y)	-	-	-	-
Item.IntegratedMerchantCreditCardEnabled	-	-	(Y)	-	-	-	-
Item.ItemID	Y	-	-	-	-	-	-
Item.ItemSpecifics	-	-	-	(Y)	-	-	-
Item.ItemSpecifics.NameValueList	-	-	-	(Y)	-	-	-
Item.ItemSpecifics.NameValueList.Name	-	-	-	(Y)	-	-	-
Item.ItemSpecifics.NameValueList.Value	-	-	-	(Y)	-	-	-
Item.ListingStatus	Y	-	-	-	-	-	-
Item.ListingType	Y	-	-	-	-	-	-
Item.Location	Y	-	-	-	-	-	-
Item.LotSize	-	-	(Y)	-	-	-	-
Item.MinimumToBid	-	-	(Y)	-	-	-	-
Item.PaymentAllowedSite	-	-	Y	-	-	-	-
Item.PaymentMethods	-	-	(Y)	-	-	-	-
Item.PictureURL	(Y)	-	-	-	-	-	-
Item.PostalCode	-	-	Y	-	-	-	-
Item.PrimaryCategoryID	Y	-	-	-	-	-	-
Item.PrimaryCategoryIDPath	-	-	Y	-	-	-	-
Item.PrimaryCategoryName	Y	-	-	-	-	-	-
Item.ProductID	-	-	(Y)	-	-	-	-
Item.Quantity	-	-	Y	-	-	-	-
Item.QuantitySold	-	-	Y	-	-	-	-
Item.ReserveMet	-	-	Y	-	-	-	-
Item.ReturnPolicy	-	-	(Y)	-	-	-	-
Item.ReturnPolicy.Description	-	-	(Y)	-	-	-	-
Item.ReturnPolicy.EAN	-	-	(Y)	-	-	-	-
Item.ReturnPolicy.Refund	-	-	(Y)	-	-	-	-
Item.ReturnPolicy.ReturnsAccepted	-	-	(Y)	-	-	-	-
Item.ReturnPolicy.ReturnsWithin	-	-	(Y)	-	-	-	-
Item.ReturnPolicy.ShippingCostPaidBy	-	-	(Y)	-	-	-	-
Item.ReturnPolicy.WarrantyDuration	-	-	(Y)	-	-	-	-
Item.ReturnPolicy.WarrantyOffered	-	-	(Y)	-	-	-	-
Item.ReturnPolicy.WarrantyType	-	-	(Y)	-	-	-	-
Item.SecondaryCategoryID	-	-	(Y)	-	-	-	-
Item.SecondaryCategoryIDPath	-	-	(Y)	-	-	-	-
Item.SecondaryCategoryName	-	-	(Y)	-	-	-	-
Item.Seller	-	-	Y	-	-	-	-
Item.Seller.FeedbackRatingStar	-	-	Y	-	-	-	-
Item.Seller.FeedbackScore	-	-	Y	-	-	-	-
Item.Seller.PositiveFeedbackPercent	-	-	Y	-	-	-	-
Item.Seller.UserID	-	-	Y	-	-	-	-
Item.ShippingCostSummary	-	-	-	-	Y	-	-
Item.ShippingCostSummary.InsuranceCost	-	-	-	-	(Y)	-	-
Item.ShippingCostSummary.ListedShippingServiceCost	-	-	-	-	(Y)	-	-
Item.ShippingCostSummary.ShippingServiceCost	-	-	-	-	(Y)	-	-
Item.ShippingCostSummary.ShippingType	-	-	-	-	Y	-	-
Item.ShipToLocations	-	-	Y	-	-	-	-
Item.Site	-	-	Y	-	-	-	-
Item.StartTime	-	-	Y	-	-	-	-
Item.Storefront	-	-	Y	-	-	-	-
Item.Storefront.StoreName	-	-	Y	-	-	-	-
Item.Storefront.StoreURL	-	-	Y	-	-	-	-
Item.Subtitle	-	-	(Y)	-	-	-	-
Item.TimeLeft	Y	-	-	-	-	-	-
Item.Title	Y	-	-	-	-	-	-
Item.Variations	-	-	-	-	-	-	(Y)
Item.Variations.Pictures	-	-	-	-	-	-	(Y)
Item.Variations.Pictures.VariationSpecificName	-	-	-	-	-	-	(Y)
Item.Variations.Pictures.VariationSpecificPictureSet	-	-	-	-	-	-	(Y)
Item.Variations.Pictures.VariationSpecificPictureSet.PictureURL	-	-	-	-	-	-	(Y)
Item.Variations.Pictures.VariationSpecificPictureSet   .VariationSpecificValue	-	-	-	-	-	-	(Y)
Item.Variations.Variation	-	-	-	-	-	-	(Y)
Item.Variations.Variation.Quantity	-	-	-	-	-	-	(Y)
Item.Variations.Variation.SellingStatus	-	-	-	-	-	-	(Y)
Item.Variations.Variation.SellingStatus.QuantitySold	-	-	-	-	-	-	(Y)
Item.Variations.Variation.SKU	-	-	-	-	-	-	(Y)
Item.Variations.Variation.StartPrice	-	-	-	-	-	-	(Y)
Item.Variations.Variation.VariationSpecifics	-	-	-	-	-	-	(Y)
Item.Variations.Variation.VariationSpecifics.NameValueList	-	-	-	-	-	-	(Y)
Item.Variations.Variation.VariationSpecifics.NameValueList.Name	-	-	-	-	-	-	(Y)
Item.Variations.Variation.VariationSpecifics.NameValueList.Value	-	-	-	-	-	-	(Y)
Item.Variations.VariationSpecificsSet	-	-	-	-	-	-	(Y)
Item.Variations.VariationSpecificsSet.NameValueList	-	-	-	-	-	-	(Y)
Item.Variations.VariationSpecificsSet.NameValueList.Name	-	-	-	-	-	-	(Y)
Item.Variations.VariationSpecificsSet.NameValueList.Value	-	-	-	-	-	-	(Y)
Item.ViewItemURLForNaturalSearch	Y	-	-	-	-	-	-

Back to top

New to making API calls? Please see Making an API Call.

Note: Some item IDs, user IDs, or other data in these samples might no longer be active on eBay. If necessary, you can substitute current eBay data in your requests.

Available samples:

• Basic Call ↓ - Retrieves the default, most commonly used, set of item fields.
• Including a Shipping Cost Summary ↓ - Retrieves a listing's basic shipping costs in addition to the default set of item fields.
• Getting Item Descriptions and Item Specifics ↓ - Retrieves the full item description and Item Specifics in addition to the default set of item fields.
• Converting Prices from a Non-Local Listing ↓ - Retrieves a listing from a non-local site and converts the prices to the local currency.
• Getting All Variations in a Multi-Variation Listing ↓ - Retrieves a multi-variation listing with all available variations.

Retrieves the default, most commonly used, set of item fields.

Input

If you want to show potential buyers basic information pertaining to a listing (such as the title, a picture, current and Buy It Now prices, and the listing ending time), pass an itemID as input to GetSingleItem.

URL format (HTTP GET). See also the non-wrapped version of this URL. For results in a format other than XML, 
specify a different value for responseencoding.

http://open.api.ebay.com/shopping?callname=GetSingleItem
   &responseencoding=XML
   &appid=YourAppIDHere
   &siteid=0
   &version=515
   &ItemID=180126682091

   Here is the same input in XML format (HTTP POST). Note that this does not include standard values.

XML format (HTTP POST). Also available are the .txt version of this XML and the SOAP equivalent.

<?xml version="1.0" encoding="utf-8"?>
<GetSingleItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <ItemID>180126682091</ItemID>
</GetSingleItemRequest>

Output

When you pass just an itemID to GetSingleItem, eBay returns the default set of item fields: the listing's title, prices (in the currency of the site to which you sent the request), category, end time, and a few other fields (depending on what the seller specifeid in the listing). See Detail Control: IncludeSelector for a list of the default set of fields that eBay returns for an item listing. Retrieving only these basic fields gives you the fastest response time.

Notice that the value of BidCount is 1 in this example. If this is a Chinese auction (single-quantity, competitive-bidding listing), this would indicate that the Buy It Now option is no longer available (even though the response shows ConvertedBuyItNowPrice). If knowing the availability of Buy It Now is important to your use case, you would need to get additional details about the item to determine the listing type. See Sample: Converting Prices from a Non-Local Listing for a sample that shows ListingType.

If you think the user might want to see the item again, you should cache the results instead of making the call again later. This will help reduce the number of calls you make per day. Also, if you expect to monitor the item (for example, to get the latest bid count and price) don't call GetSingleItem again to get the updates. Use instead GetItemStatus, it's a more efficient call.

XML format. Also available are the .txt version of this XML and the SOAP equivalent.

<?xml version="1.0" encoding="UTF-8"?>
  <GetSingleItemResponse xmlns="urn:ebay:apis:eBLBaseComponents">
   <Timestamp>2007-06-07T15:55:58.261Z</Timestamp>
   <Ack>Success</Ack>
   <Build>e515_core_APILW_4756831_R1</Build>
   <Version>515</Version>
   <Item>
    <ItemID>180126682091</ItemID>
    <ConvertedBuyItNowPrice currencyID="USD">12.88</ConvertedBuyItNowPrice>
    <EndTime>2007-06-12T18:51:06.000Z</EndTime>
    <ViewItemURLForNaturalSearch>http://cgi.ebay.com/EMMA-WATSON-entertainment-weekly-HARRY-POTTER-phoenix_W0QQitemZ180126682091QQcategoryZ29798QQcmdZViewItem</ViewItemURLForNaturalSearch>
    <Location>NEW JERSEY</Location>
    <GalleryURL>http://thumbs.ebaystatic.com/pict/180126682091.jpg</GalleryURL>
    <PictureURL>http://imagehost.vendio.com/bin/imageserver.x/00000000/jackensack/.mids/EWEMMAMARCH2007A.jpg</PictureURL>
    <PrimaryCategoryID>29798</PrimaryCategoryID>
    <PrimaryCategoryName>Collectibles:Fantasy, Mythical & Magic:Harry Potter:Other Items</PrimaryCategoryName>
    <BidCount>1</BidCount>
    <ConvertedCurrentPrice currencyID="USD">0.88</ConvertedCurrentPrice>
    <ListingStatus>Active</ListingStatus>
    <TimeLeft>P5DT2H55M8S</TimeLeft>
    <Title>EMMA WATSON entertainment weekly HARRY POTTER phoenix</Title>
   </Item>
  </GetSingleItemResponse>

Back to list of samples

Retrieves a listing's basic shipping costs in addition to the default set of item fields.

Input

A seller can offer one or more shipping options to potential buyers. Some sellers will offer flat shipping while others will give users a range of options at different prices. The seller will usually show the lowest-cost shipping option first.

GetSingleItem can return the shipping and, if it exists, the insurance cost of the seller's first shipping option. To retrieve this information, pass the itemID and specify an IncludeSelector of ShippingCosts to the call.

URL format (HTTP GET). See also the non-wrapped version of this URL. For results in a format other than XML, 
specify a different value for responseencoding.

http://open.api.ebay.com/shopping?callname=GetSingleItem
   &responseencoding=XML
   &appid=YourAppIDHere
   &siteid=0
   &version=515
   &ItemID=180126682091
   &IncludeSelector=ShippingCosts

   Here is the same input in XML format (HTTP POST). Note that this does not include standard values.

XML format (HTTP POST). Also available are the .txt version of this XML and the SOAP equivalent.

<?xml version="1.0" encoding="utf-8"?>
<GetSingleItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <ItemID>180126682091</ItemID>
  <IncludeSelector>ShippingCosts</IncludeSelector>
</GetSingleItemRequest>

Output

The response from this sample gets the listing's defuault set of fields as well as the shipping cost information. Note that retrieving shipping costs can increase the call's response time.

If you determine that the item has shipping costs, you can call GetShippingCosts with the same itemID if you need more shipping details. (It's best to call GetShippingCosts only when you know there are shipping details to return.)

XML format. Also available are the .txt version of this XML and the SOAP equivalent.

<?xml version="1.0" encoding="UTF-8"?>
  <GetSingleItemResponse xmlns="urn:ebay:apis:eBLBaseComponents">
   <Timestamp>2007-06-07T16:49:04.164Z</Timestamp>
   <Ack>Success</Ack>
   <Build>e515_core_APILW_4756831_R1</Build>
   <Version>515</Version>
   <Item>
    <ItemID>180126682091</ItemID>
    <ConvertedBuyItNowPrice currencyID="USD">12.88</ConvertedBuyItNowPrice>
    <EndTime>2007-06-12T18:51:06.000Z</EndTime>
    <ViewItemURLForNaturalSearch>http://cgi.ebay.com/EMMA-WATSON-entertainment-weekly-HARRY-POTTER-phoenix_W0QQitemZ180126682091QQcategoryZ29798QQcmdZViewItem</ViewItemURLForNaturalSearch>
    <Location>NEW JERSEY</Location>
    <GalleryURL>http://thumbs.ebaystatic.com/pict/180126682091.jpg</GalleryURL>
    <PictureURL>http://imagehost.vendio.com/bin/imageserver.x/00000000/jackensack/.mids/EWEMMAMARCH2007A.jpg</PictureURL>
    <PrimaryCategoryID>29798</PrimaryCategoryID>
    <PrimaryCategoryName>Collectibles:Fantasy, Mythical & Magic:Harry Potter:Other Items</PrimaryCategoryName>
    <BidCount>1</BidCount>
    <ConvertedCurrentPrice currencyID="USD">0.88</ConvertedCurrentPrice>
    <ListingStatus>Active</ListingStatus>
    <TimeLeft>P5DT2H2M2S</TimeLeft>
    <Title>EMMA WATSON entertainment weekly HARRY POTTER phoenix</Title>
    <ShippingCostSummary>
     <ShippingServiceCost currencyID="USD">4.75</ShippingServiceCost>
     <InsuranceCost currencyID="USD">0.0</InsuranceCost>
     <ShippingType>Flat</ShippingType>
    </ShippingCostSummary>
   </Item>
  </GetSingleItemResponse>

Back to list of samples

Retrieves the full item description and Item Specifics in addition to the default set of item fields.

Input

A seller usually writes a detailed description of the item they're selling. In addition to the description, the seller might also specify various Item Specifics (or they might be pre-filled from a catalog offered by eBay). On the US site, cars & trucks, tickets, and real estate listings always have Item Specifics. Many other listings have them as well. Sellers most often use Item Specifics to specify the condition of an item.

This example shows how to retrieve the listing description and Item Specifics. Pass in the itemID as usual, and specify Description,ItemSpecifics (separated by a comma) in the IncludeSelector field.

URL format (HTTP GET). See also the non-wrapped version of this URL. For results in a format other than XML, 
specify a different value for responseencoding.

http://open.api.ebay.com/shopping?callname=GetSingleItem
   &responseencoding=XML
   &appid=YourAppIDHere
   &siteid=0
   &version=515
   &ItemID=180126682091
   &IncludeSelector=Description,ItemSpecifics

   Here is the same input in XML format (HTTP POST). Note that this does not include standard values.

XML format (HTTP POST). Also available are the .txt version of this XML and the SOAP equivalent.

<?xml version="1.0" encoding="utf-8"?>
<GetSingleItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <ItemID>180126682091</ItemID>
  <IncludeSelector>Description,ItemSpecifics</IncludeSelector>
</GetSingleItemRequest>

Output

As shown in this example, descriptions often include HTML markup (and sometimes they also include JavaScript). Some sellers can also put additional pictures in their description instead of using eBay's picture options. Pictures included within the seller's description are not returned in the PictureURL field.

This response also shows the item condition (New) in the ItemSpecifics node. Some listings have other specifics as well. Because descriptions and some lists of Item Specifics can be very long, getting this data can increase the call's response time.

Note: This example shows a SIFFTAS item specific with no value. In general, you should ignore SIFFTAS item specifics, as they are not useful to users. They're for internal use at eBay.

XML format. Also available are the .txt version of this XML and the SOAP equivalent.

<?xml version="1.0" encoding="UTF-8"?>
<GetSingleItemResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2007-06-08T13:33:32.871Z</Timestamp>
  <Ack>Success</Ack>
  <Build>e515_core_APILW_4756831_R1</Build>
  <Version>515</Version>
  <Item>
    <Description>

<!-- Partial sample of the Description field.
See the .txt version of this response for the full description. -->

&lt;table width=100% border=0 cellspacing=0 cellpadding=0&gt;
&lt;tr&gt;&lt;td width=21&gt;&lt;img src=&quot;http://imagehost.vendio.com/my/templates/Themes/Standard/Standard%2001/corner_tl.gif&quot; width=21 height=25&gt;&lt;/td&gt;
&lt;td width=100% background=&quot;http://imagehost.vendio.com/my/templates/Themes/Standard/Standard%2001/expander.gif&quot;&gt;&amp;nbsp;&lt;/td&gt;
&lt;td background=&quot;http://imagehost.vendio.com/my/templates/Themes/Standard/Standard%2001/expander.gif&quot; width=24&gt;&lt;img src=&quot;http://imagehost.vendio.com/my/templates/Themes/Standard/Standard%2001/corner_tr.gif&quot; width=24 height=25&gt;&lt;/td&gt;
&lt;/tr&gt;&lt;tr&gt;&lt;td width=21 background=&quot;http://imagehost.vendio.com/my/templates/Themes/Standard/Standard%2001/st_top_menu_l.gif&quot; valign=top&gt;&lt;img src=&quot;http://imagehost.vendio.com/my/templates/Themes/Standard/Standard%2001/space_tl.gif&quot; width=21 height=13&gt;&lt;/td&gt;
&lt;td bgcolor=#687498 width=100%&gt;

<!-- More HTML and JavaScript here.
See the .txt version of this response for the full description. -->

    </Description>
    <ItemID>180126682091</ItemID>
    <ConvertedBuyItNowPrice currencyID="USD">12.88</ConvertedBuyItNowPrice>
    <EndTime>2007-06-12T18:51:06.000Z</EndTime>
    <ViewItemURLForNaturalSearch>http://cgi.ebay.com/EMMA-WATSON-entertainment-weekly-HARRY-POTTER-phoenix_W0QQitemZ180126682091QQcategoryZ29798QQcmdZViewItem</ViewItemURLForNaturalSearch>
    <Location>NEW JERSEY</Location>
    <GalleryURL>http://thumbs.ebaystatic.com/pict/180126682091.jpg</GalleryURL>
    <PictureURL>http://imagehost.vendio.com/bin/imageserver.x/00000000/jackensack/.mids/EWEMMAMARCH2007A.jpg</PictureURL>
    <PrimaryCategoryID>29798</PrimaryCategoryID>
    <PrimaryCategoryName>Collectibles:Fantasy, Mythical &amp; Magic:Harry Potter:Other Items</PrimaryCategoryName>
    <BidCount>1</BidCount>
    <ConvertedCurrentPrice currencyID="USD">0.88</ConvertedCurrentPrice>
    <ListingStatus>Active</ListingStatus>
    <TimeLeft>P4DT5H17M34S</TimeLeft>
    <Title>EMMA WATSON entertainment weekly HARRY POTTER phoenix</Title>
    <ItemSpecifics>
      <NameValueList>
        <Name>SIFFTAS Group Pseudo Attribute</Name>
        <Value></Value>
      </NameValueList>
      <NameValueList>
        <Name>Condition</Name>
        <Value>New</Value>
      </NameValueList>
    </ItemSpecifics>
  </Item>
</GetSingleItemResponse>

Back to list of samples

Retrieves a listing from a non-local site and converts the prices to the local currency.

Input

When searching for items on eBay, you sometimes find items that are listed on an international eBay site, but the seller is willing to ship to different countries. To support this, eBay can return the listing's price data converted into the currency of the site you're using, as well as showing the price in the listing's original currency.

This example retrieves an item listed on the US site from the eBay Germany site. By specifying siteid=77 in the URL, the German site becomes the "local" site, and the US site (where the item is listed) becomes the "foreign" site.

Pass in the itemID as usual, and specify Details in the IncludeSelector field. This causes eBay to included prices in their original currency, as well as providing other item details.

URL format (HTTP GET). See also the non-wrapped version of this URL. For results in a format other than XML, 
specify a different value for responseencoding.

http://open.api.ebay.com/shopping?callname=GetSingleItem
   &responseencoding=XML
   &appid=YourAppID
   &siteid=77
   &version=515
   &ItemID=280351167497
   &IncludeSelector=Details

   Here is the same input in XML format (HTTP POST). Note that this does not include standard values.

XML format (HTTP POST). Also available are the .txt version of this XML and the SOAP equivalent.

<?xml version="1.0" encoding="utf-8"?>
<GetSingleItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <ItemID>280351167497</ItemID>
  <IncludeSelector>Details</IncludeSelector>
</GetSingleItemRequest>

Output

The eBay response shows the original price (CurrentPrice) in US Dollars and the converted price (ConvertedCurrentPrice) in Euros. The response also shows values for BuyItNowPrice and ConveretedBuyItNowPrice, indicating that the item was listed with the Buy It Now feature.

Because the query specified the Details IncludeSelector, the result has detailed information about the listing, such as the listing type (a Chinese auction, which means it's a single-quantity, auction-style listing), information about the high bidder (anonymized as a***o, per eBay policy) and various other listing details. Note that using an IncludeSelector can increase the call's response time.

XML format. Also available are the .txt version of this XML and the SOAP equivalent.

<?xml version="1.0" encoding="utf-8"?>
<GetSingleItemResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2009-06-05T21:22:13.130Z</Timestamp>
  <Ack>Success</Ack>
  <Build>e619__Bundled_9067380_R1</Build>
  <Version>619</Version>
  <Item>
    <BestOfferEnabled>false</BestOfferEnabled>
    <BuyItNowPrice currencyID="USD">1000.0</BuyItNowPrice>
    <ItemID>280351167497</ItemID>
    <BuyItNowAvailable>true</BuyItNowAvailable>
    <ConvertedBuyItNowPrice currencyID="EUR">704.8</ConvertedBuyItNowPrice>
    <EndTime>2009-06-07T02:05:22.000Z</EndTime>
    <StartTime>2009-05-28T02:05:22.000Z</StartTime>
    <ViewItemURLForNaturalSearch>http://cgi.ebay.de/US-Fender-Highway-1
        -pro-painted-Sea-Foam-Green-Nitro_W0QQitemZ280351167497
        QQcategoryZ64400QQcmdZViewItem</ViewItemURLForNaturalSearch>
    <ListingType>Chinese</ListingType>
    <Location>Phoenix, Arizona</Location>
    <PaymentMethods>PayPal</PaymentMethods>
    <GalleryURL>http://thumbs3.ebaystatic.com/pict/978080_1.jpg</GalleryURL>
    <PictureURL>http://i.ebayimg.com/04/!BTQ)2u!BGk~$(KGrHgoH-
        EQEjlLluvvMBKHe69g9dQ~~_1.JPG?set_id=880000500F</PictureURL>
    <PostalCode>85064</PostalCode>
    <PrimaryCategoryID>64400</PrimaryCategoryID>
    <PrimaryCategoryName>Musical Instruments:Guitar:Bass:Right-Handed:
        Fender:Jazz</PrimaryCategoryName>
    <Quantity>1</Quantity>
    <Seller>
      <UserID>johnnywadd1</UserID>
      <FeedbackRatingStar>Purple</FeedbackRatingStar>
      <FeedbackScore>862</FeedbackScore>
      <PositiveFeedbackPercent>100.0</PositiveFeedbackPercent>
    </Seller>
    <BidCount>3</BidCount>
    <ConvertedCurrentPrice currencyID="EUR">430.63</ConvertedCurrentPrice>
    <CurrentPrice currencyID="USD">611.0</CurrentPrice>
    <HighBidder>
      <UserID>a***o</UserID>
      <FeedbackPrivate>false</FeedbackPrivate>
      <FeedbackRatingStar>Yellow</FeedbackRatingStar>
      <FeedbackScore>11</FeedbackScore>
    </HighBidder>
    <ListingStatus>Active</ListingStatus>
    <QuantitySold>0</QuantitySold>
    <ReserveMet>false</ReserveMet>
    <ShipToLocations>Worldwide</ShipToLocations>
    <Site>US</Site>
    <TimeLeft>P1DT4H43M9S</TimeLeft>
    <Title>US Fender Highway 1, pro painted Sea Foam Green Nitro</Title>
    <HitCount>798</HitCount>
    <Subtitle>Nordstrand NPJ4SV pick ups, Gotoh 28:1 Vintage Tuners</Subtitle>
    <PrimaryCategoryIDPath>619:3858:38078:160931:64399:64400</PrimaryCategoryIDPath>
    <Storefront>
      <StoreURL>http://stores.ebay.de/id=0</StoreURL>
      <StoreName>
      </StoreName>
    </Storefront>
    <Country>US</Country>
    <MinimumToBid currencyID="USD">621.0</MinimumToBid>
    <AutoPay>true</AutoPay>
    <PaymentAllowedSite>CanadaFrench</PaymentAllowedSite>
    <PaymentAllowedSite>Spain</PaymentAllowedSite>
    <PaymentAllowedSite>Canada</PaymentAllowedSite>
    <PaymentAllowedSite>US</PaymentAllowedSite>
    <IntegratedMerchantCreditCardEnabled>false</IntegratedMerchantCreditCardEnabled>
  </Item>
</GetSingleItemResponse>

Back to list of samples

Retrieves a multi-variation listing with all available variations.

Description

User bountifulbuyer has searched for and found a listing with women's Polo tops. She has determined that this is a multi-variation listing and she wants to see all the available tops within the listing.

Input

The key inputs for this call scenario are the ItemID, which she obtained from a search call response, and IncludSelector, which she sets to Variations and ItemSpecifics to make sure she sees all the available variations and gets any shared specifics, such as Brand.

URL format (HTTP GET). See also the non-wrapped version of this URL. For results in a format other than XML, 
specify a different value for responseencoding.

http://open.api.ebay.com/shopping?callname=GetSingleItem
   &responseencoding=XML
   &appid=YourAppIDHere
   &siteid=0
   &version=615
   &ItemID=350001227490
   &IncludeSelector=Variations,ItemSpecifics

   Here is the same input in XML format (HTTP POST). Note that this does not include standard values.

XML format (HTTP POST). Also available is the .txt version of this XML.

<?xml version="1.0" encoding="utf-8"?>
<GetSingleItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <ItemID>350001227490</ItemID>
  <IncludeSelector>Variations,ItemSpecifics</IncludeSelector>
</GetSingleItemRequest>

Output

The response includes all the basic details of the listing and all the available variations. The important fields for bountifulbuyer are the Variation fields, which help her decide which variation she wants to purchase, the quantity of items available in that variation, and the variation's price.

Note that the item-level fixed price (Item.ConvertedCurrentPrice) is the value of the lowest-priced variation that is still available for sale.

Note that the sample output displays only a few variations (to keep the sample shorter). In practice, the response could be much larger--a single listing can contain up to 120 variations (as of the time of this writing).

XML format. Also available is the .txt version of this XML.

<?xml version="1.0" encoding="utf-8"?>
<GetSingleItemResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2009-05-04T01:05:11.834Z</Timestamp>
  <Ack>Success</Ack>
  <Build>e615__Bundled_8552129_R1</Build>
  <Version>615</Version>
  <Item>
    <ItemID>350001227490</ItemID>
    <EndTime>2009-06-03T00:00:09.000Z</EndTime>
    <ViewItemURLForNaturalSearch>http://cgi.ebay.com/New-Ralph-Lauren-Polo-shirt-Pink-Black-Blue-Yellow_W0QQitemZ350001227490QQcategoryZ37565QQvarZ510000002745QQcmdZViewItem</ViewItemURLForNaturalSearch>
    <ListingType>FixedPriceItem</ListingType>
    <Location>San Jose, California</Location>
    <PictureURL>http://i12.ebayimg.com/03/i/04/8a/5f/a1_1_sbl.JPG</PictureURL>
    <PictureURL>http://i22.ebayimg.com/01/i/04/8e/53/69_1_sbl.JPG</PictureURL>
    <PictureURL>http://i4.ebayimg.ebay.com/01/i/000/77/3c/d88f_1_sbl.JPG</PictureURL>
    <PrimaryCategoryID>37565</PrimaryCategoryID>
    <PrimaryCategoryName>Everything Else:Test Auctions:Attributes:Attributes7</PrimaryCategoryName>
    <BidCount>0</BidCount>
    <ConvertedCurrentPrice currencyID="USD">17.99</ConvertedCurrentPrice>
    <ListingStatus>Active</ListingStatus>
    <TimeLeft>P29DT22H54M40S</TimeLeft>
    <Title>New Ralph Lauren Polo shirt Pink Black Blue Yellow</Title>
    <ItemSpecifics>
      <NameValueList>
        <Name>Occasion</Name>
        <Value>Casual</Value>
      </NameValueList>
      <NameValueList>
        <Name>Brand</Name>
        <Value>Ralph Lauren</Value>
      </NameValueList>
      <NameValueList>
        <Name>Style</Name>
        <Value>Polo Shirt</Value>
      </NameValueList>
      <NameValueList>
        <Name>Sleeve Style</Name>
        <Value>Short Sleeve</Value>
      </NameValueList>
    </ItemSpecifics>
    <Country>US</Country>
    <AutoPay>false</AutoPay>
    <Variations>
      <Variation>
        <SKU>RLauren_Wom_TShirt_Pnk_S</SKU>
        <StartPrice currencyID="USD">17.99</StartPrice>
        <Quantity>4</Quantity>
        <VariationSpecifics>
          <NameValueList>
            <Name>Color</Name>
            <Value>Pink</Value>
          </NameValueList>
          <NameValueList>
            <Name>Size</Name>
            <Value>S</Value>
          </NameValueList>
        </VariationSpecifics>
        <SellingStatus>
          <QuantitySold>0</QuantitySold>
        </SellingStatus>
      </Variation>
      <Variation>
        <SKU>RLauren_Wom_TShirt_Pnk_M</SKU>
        <StartPrice currencyID="USD">17.99</StartPrice>
        <Quantity>8</Quantity>
        <VariationSpecifics>
          <NameValueList>
            <Name>Color</Name>
            <Value>Pink</Value>
          </NameValueList>
          <NameValueList>
            <Name>Size</Name>
            <Value>M</Value>
          </NameValueList>
        </VariationSpecifics>
        <SellingStatus>
          <QuantitySold>0</QuantitySold>
        </SellingStatus>
      </Variation>
      <Variation>
        <SKU>RLauren_Wom_TShirt_Blk_S</SKU>
        <StartPrice currencyID="USD">20.0</StartPrice>
        <Quantity>10</Quantity>
        <VariationSpecifics>
          <NameValueList>
            <Name>Color</Name>
            <Value>Black</Value>
          </NameValueList>
          <NameValueList>
            <Name>Size</Name>
            <Value>S</Value>
          </NameValueList>
        </VariationSpecifics>
        <SellingStatus>
          <QuantitySold>0</QuantitySold>
        </SellingStatus>
      </Variation>
      <Variation>
        <SKU>RLauren_Wom_TShirt_Blk_M</SKU>
        <StartPrice currencyID="USD">20.0</StartPrice>
        <Quantity>10</Quantity>
        <VariationSpecifics>
          <NameValueList>
            <Name>Color</Name>
            <Value>Black</Value>
          </NameValueList>
          <NameValueList>
            <Name>Size</Name>
            <Value>M</Value>
          </NameValueList>
        </VariationSpecifics>
        <SellingStatus>
          <QuantitySold>0</QuantitySold>
        </SellingStatus>
      </Variation>
      <Variation>
        <SKU>RLauren_Wom_TShirt_Blu_S</SKU>
        <StartPrice currencyID="USD">20.0</StartPrice>
        <Quantity>10</Quantity>
        <VariationSpecifics>
          <NameValueList>
            <Name>Color</Name>
            <Value>Blue</Value>
          </NameValueList>
          <NameValueList>
            <Name>Size</Name>
            <Value>S</Value>
          </NameValueList>
        </VariationSpecifics>
        <SellingStatus>
          <QuantitySold>0</QuantitySold>
        </SellingStatus>
      </Variation>
      <Variation>
        <SKU>RLauren_Wom_TShirt_Blu_M</SKU>
        <StartPrice currencyID="USD">20.0</StartPrice>
        <Quantity>10</Quantity>
        <VariationSpecifics>
          <NameValueList>
            <Name>Color</Name>
            <Value>Blue</Value>
          </NameValueList>
          <NameValueList>
            <Name>Size</Name>
            <Value>M</Value>
          </NameValueList>
        </VariationSpecifics>
        <SellingStatus>
          <QuantitySold>0</QuantitySold>
        </SellingStatus>
      </Variation>
      <Pictures>
        <VariationSpecificName>Color</VariationSpecificName>
        <VariationSpecificPictureSet>
          <VariationSpecificValue>Pink</VariationSpecificValue>
          <PictureURL>http://i12.ebayimg.com/03/i/04/8a/5f/a1_1_sbl.JPG</PictureURL>
          <PictureURL>http://i12.ebayimg.com/03/i/04/8a/5f/a1_1_sb2.JPG</PictureURL>
        </VariationSpecificPictureSet>
        <VariationSpecificPictureSet>
          <VariationSpecificValue>Blue</VariationSpecificValue>
          <PictureURL>http://i22.ebayimg.com/01/i/04/8e/53/69_1_sbl.JPG</PictureURL>
          <PictureURL>http://i22.ebayimg.com/01/i/04/8e/53/69_1_sb2.JPG</PictureURL>
          <PictureURL>http://i22.ebayimg.com/01/i/04/8e/53/69_1_sb3.JPG</PictureURL>
        </VariationSpecificPictureSet>
        <VariationSpecificPictureSet>
          <VariationSpecificValue>Black</VariationSpecificValue>
          <PictureURL>http://i4.ebayimg.ebay.com/01/i/000/77/3c/d88f_1_sbl.JPG</PictureURL>
        </VariationSpecificPictureSet>
        <VariationSpecificPictureSet>
          <VariationSpecificValue>Yellow</VariationSpecificValue>
          <PictureURL>http://i4.ebayimg.ebay.com/01/i/000/77/3c/d89f_1_sbl.JPG</PictureURL>
        </VariationSpecificPictureSet>
      </Pictures>
      <VariationSpecificsSet>
        <NameValueList>
          <Name>Size</Name>
          <Value>XS</Value>
          <Value>S</Value>
          <Value>M</Value>
          <Value>L</Value>
          <Value>XL</Value>
        </NameValueList>
        <NameValueList>
          <Name>Color</Name>
          <Value>Black</Value>
          <Value>Pink</Value>
          <Value>Yellow</Value>
          <Value>Blue</Value>
        </NameValueList>
      </VariationSpecificsSet>
    </Variations>
  </Item>
</GetSingleItemResponse>

Back to list of samples

Back to top

This document was generated with a customized version of the apireferencedocs tool.

© 2006–2009 eBay, Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.