FindHalfProducts

FindHalfProducts searches for Half.com stock catalog information for products, such as a particular CD or a particular book. Half.com products include this stock information in the product page.

Note: A product is not the same as an item. A product is essentially a stock description from a catalog. An item is something that a seller has listed.

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

This call is designed to be useful to applications that support shopping comparisons or basic supply and demand data. It returns basic product information, such as the title, stock photo (if any), and Item Specifics. Item Specifics are well-known aspects of products in the same domain or category. For example, a book's item specifics might include a field like Publication Year=2007, and a field like Binding=Hardcover. But a video game's item specifics would be different from a book's, with fields like Rating=E - Everyone and Platform=Sony PlayStation 2.

To use this call, you typically start by passing in keywords (such as a book title) in QueryKeywords, and Half.com finds products with matching words in the product title, description, and/or Item Specifics.

To get more information about one of the products (such as the Half.com listings that use the product's stock information), take the product's ID from the response and pass it back into FindHalfProducts in ProductID.

For each product of interest, you can retrieve up 30 items on Half.com (if any) that were listed with the product's stock information. Up to five responses per Condition (eg Brand New, Like New), for the six conditions, will be returned

A product can have several kinds of product IDs. In most cases, you use the product's reference ID for searching. This is an ID that doesn't usually change. However, in media categories (Books, Music, DVDs & Movies, and Video Games) only, you can use an industry-standard ISBN, EAN, or UPC value instead of the reference ID.

Note: As catalog queries can take longer than item queries, FindHalfProducts can be slower than non-Half.com Shopping call FindItemsAdvanced. Also, due to the way product data is cached, you may get a faster response when you run the same query a second time.

Best Practices

FindHalfProducts 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.

More Tips

You can specify up to 10 ProductIDs of the same type by separating them with commas. Be aware that if you use multiple ProductIDs with IncludeSelector equal to Items, your response will be returned as if you did not use IncludeSelector. IncludeSelector Items only returns if you specifiy a single ProductID. See the FindHalfProducts Detail Controls for which fields will be returned.

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.



Back to top

Input Output Detail Controls Samples Change History User Notes
FindHalfProducts Input

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"?>
<FindHalfProductsRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Standard Input Fields -->
  <MessageID> string </MessageID>
  <!-- Call-specific Input Fields -->
  <AvailableItemsOnly> boolean </AvailableItemsOnly>
  <DomainName> string </DomainName>
  <!-- ... more DomainName nodes here ... -->
  <IncludeSelector> string </IncludeSelector>
  <MaxEntries> int </MaxEntries>
  <PageNumber> int </PageNumber>
  <ProductID type="ProductIDCodeType"> ProductIDType (string) </ProductID>
  <ProductSort> ProductSortCodeType </ProductSort>
  <QueryKeywords> string </QueryKeywords>
  <SellerID> string </SellerID>
  <SortOrder> SortOrderCodeType </SortOrder>
</FindHalfProductsRequest>
Argument Type Reqd? Meaning
Standard Input Fields   [Jump to call-specific fields]
MessageID string Optional If you pass a value in MessageID in a request, we'll return the same value in CorrelationID in the response. If you're making a lot of calls, you can use this for tracking that a response is returned for every request and to match particular responses to particular requests. (In this case, specify a different value for each request.) You can specify any value that is useful to you.
Call-specific Input Fields
AvailableItemsOnly boolean Optional If true, only retrieve data for products that have been used to pre-fill active listings on the Half.com site. If false, retrieve all products that match the query. This is useful when you use QueryKeywords and you only want to find products that have associated items (that is, where ItemArray would not be empty).

By default, AvailableItemsOnly does not retrieve an ItemArray; it only controls which products are returned (or counted). When you use QueryKeywords in your request, only products are returned, ItemArray is never returned. To retrieve an ItemArray, use a ProductID in your request instead of a QueryKeyword and specify Items in the IncludeSelector field.
Default: false.
DomainName string
(repeatable)		 Optional A domain to search in. This is like searching a section of a catalog. If not specified, the product search is conducted across all domains. DomainName is an unbounded field. If you are using a URL, and you want to specify multiple values, use an index value (not a comma). For example, to specify DomainName=Textbooks,Education, specify DomainName(0)=Textbooks,%20Education. To determine valid domain names, first use this call with QueryKeywords. Domain names are returned for each product (and summarized in the domain histogram, if you specify DomainHistogram in IncludeSelector).

A domain is a named grouping of categories whose items share common product characteristics. For example, all bound books have a binding or format (e.g., Hardcover), but audiobooks don't. So audiobooks would have their own domain. To limit your search to audiobooks, you would specify Audiobooks as the domain.

Only useful when QueryKeywords is specified. If you use this with ProductID, AND logic is applied. In this case, if you specify an ID that doesn't match the domain (as Half.com has defined it), no matching product will be found. Therefore, we recommend that you only use DomainName with QueryKeywords.
IncludeSelector string Optional Defines standard subsets of fields to return within the response.

If you don't specify this field, the call returns a default set of fields, focusing on product details only (see the "Detail Controls" link below). If you specify this field, the additional fields you retrieve can affect the call's response time (performance).

Applicable values:

•   Items

Include a brief set of item fields in the response. Only applicable when you are searching by ProductID. Not applicable with QueryKeywords.

•   DomainHistogram

Include the DomainHistogram in the response. The histogram lists the number of matching products found and the domains in which they were found. (A domain is like a high-level category.) When many matching products are found, you may see significantly slower response times when you include the histogram.



Use a comma to specify multiple values. (In this case, the results are cumulative.) See "FindHalfProducts Samples" for an example of how to use this field.

See "Detail Controls" for a complete list of fields that can be returned for each selector.
MaxEntries int Optional Specifies the maximum number of products to return per page in a single call. This is mostly only useful with QueryKeywords. (When you use ProductID, Half.com usually only returns one product, and up to 30 items for that product.)
Min: 1. Max: 20. Default: 1.
PageNumber int Optional Specifies which page of data to return in the current call. Specify a positive value equal to or lower than the number of pages available (which you determine by examining the results of your initial request). Use this only when specifying QueryKeywords.
Min: 1. Max: 2000. Default: 1.
ProductID ProductIDType (string) Conditional Use this to retrieve product details for one specific product. Specify the ID as a string, and use the type attribute to indicate the nature of the ID you are specifying.

In general, you can request up to 10 IDs of the same type by separating them with commas, as in the following: 014633155310,014633145496. However, if you specify a ProductID type of Reference (which specifies a global reference ID for an eBay catalog product), only one ID in ProductID can be used.

The request requires either QueryKeywords or ProductID, but these fields cannot be used together.
ItemCount is only returned when ProductID is used in the request and the IncludeSelector is set to Items or Details.
Max length: 4000.
ProductID
  [ attribute type ]		 ProductIDCodeType Conditional The nature of identifier being used. For FindHalfProducts, FindProducts, FindItemsAdvanced, and FindReviewsAndGuides, only Reference, ISBN, UPC, and EAN are supported. Required when ProductID is specified.

For a list of possible enumeration values, see ProductIDCodeType.
ProductSort ProductSortCodeType Optional Sorts the list of products returned. This is mostly only useful with QueryKeywords. (When you use ProductID, Half.com usually only returns one product.)
Default: Popularity.

Applicable values:

•   CustomCode

(in) Reserved for values that are not available in the version of the schema you are using. If eBay adds a new value to this code type as of a newer version, we return CustomCode instead when you specify a lower request version.

•   ItemCount

(in) Sort by the number of active items listed with this product.

•   Popularity

(in) Sort by product popularity (as determined by eBay). (This is the default sort order.)

•   Rating

(in) Sort by average rating.

•   ReviewCount

(in) Sort by the number of reviews on eBay.

•   Title

(in) Sort by the product title.
QueryKeywords string Conditional One or more keywords to search for. When you use a keyword search, Half.com searches the product catalogs for matching words in the product title, description, and/or Item Specifics, and it returns a list of matching products, with no items. To retrieve items, use ProductID instead. (If you don't already have a product ID, you can get product IDs from the response after conducting a keyword search.)

If specified, you must pass in at least 3 alphanumeric characters.

The words "and" and "or" are treated like any other word. Only use "and", "or", or "the" if you are searching for products containing these words. To use AND or OR logic, use Half.com's standard search string modifiers. Wildcards (+, -, or *) are also supported. Be careful when using spaces before or after modifiers and wildcards.

Some keyword queries can result in response times of 30 seconds or longer. If more than 2000 matches are found, the call fails with an error. If this kind of error occurs, refine the search by passing in more keywords and/or by using DomainName to restrict the search to certain domains (such as DVDs). If you are searching for a particular book, DVD, CD, or video game and you already know its ISBN or EAN (for a book) or UPC, consider using ProductID instead to retrieve more precise results.

The request requires either QueryKeywords or ProductID, but these fields cannot be used together.
When QueryKeywords is used in the request, ItemCount is not returned.
Max length: 350.
SellerID string Optional The ID of a specific seller. Specify this value in combination with ProductID if you want search results to be filtered so that the items returned are only items in a specific product, sold by a specific seller. To specify SellerID, use SellerID and ProductID together.
SortOrder SortOrderCodeType Optional Sorts the list of products returned.
Default: Descending.

Applicable values:

•   Ascending

(in) Sorts results in ascending (low to high) order.

•   CustomCode

(in) Placeholder value. See token.

•   Descending

(in) Sorts results in descending (high to low) order.



Back to top

Input Output Detail Controls Samples Change History User Notes
FindHalfProducts Output

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"?>
<FindHalfProductsResponse 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 -->
  <ApproximatePages> int </ApproximatePages>
  <DomainHistogram> DomainHistogramType 
    <Domain> HistogramEntryType 
      <Count> int </Count>
      <Name> string </Name>
    </Domain>
    <!-- ... more Domain nodes here ... -->
  </DomainHistogram>
  <MoreResults> boolean </MoreResults>
  <PageNumber> int </PageNumber>
  <Products> HalfProductsType 
    <Product> HalfCatalogProductType 
      <DetailsURL> anyURI </DetailsURL>
      <DisplayStockPhotos> boolean </DisplayStockPhotos>
      <DomainName> string </DomainName>
      <ItemArray> SimpleItemArrayType 
        <Item> SimpleItemType 
          <Country> CountryCodeType </Country>
          <CurrentPrice> AmountType (double) </CurrentPrice>
          <HalfItemCondition> HalfItemConditionCodeType </HalfItemCondition>
          <ItemID> string </ItemID>
          <Seller> SimpleUserType 
            <FeedbackScore> int </FeedbackScore>
          </Seller>
          <SellerComments> string </SellerComments>
          <Storefront> StorefrontType 
            <StoreName> string </StoreName>
            <StoreURL> anyURI </StoreURL>
          </Storefront>
          <ViewItemURLForNaturalSearch> anyURI </ViewItemURLForNaturalSearch>
        </Item>
        <!-- ... more Item nodes here ... -->
      </ItemArray>
      <ItemCount> int </ItemCount>
      <ItemSpecifics> NameValueListArrayType 
        <NameValueList> NameValueListType 
          <Name> string </Name>
          <Value> string </Value>
          <!-- ... more Value nodes here ... -->
        </NameValueList>
        <!-- ... more NameValueList nodes here ... -->
      </ItemSpecifics>
      <MinPrice> AmountType (double) </MinPrice>
      <ProductID> ProductIDType (string) </ProductID>
      <!-- ... more ProductID nodes here ... -->
      <ReviewCount> int </ReviewCount>
      <ShippingCostSummary> ShippingCostSummaryType 
        <ShippingServiceCost> AmountType (double) </ShippingServiceCost>
        <ShippingType> ShippingTypeCodeType </ShippingType>
      </ShippingCostSummary>
      <StockPhotoURL> anyURI </StockPhotoURL>
      <Title> string </Title>
    </Product>
    <!-- ... more Product nodes here ... -->
  </Products>
  <TotalProducts> int </TotalProducts>
</FindHalfProductsResponse>
Return Value Type Returned? Meaning
Standard Output Fields   [Jump to call-specific fields]
Ack AckCodeType Always Indicates whether the call was successfully processed by eBay.

Applicable values:

•   CustomCode

(out) Reserved for internal or future use.

•   Failure

(out) Request processing failed

•   Success

(out) Request processing succeeded

•   Warning

(out) Request processing completed with warning information being included in the response message


(Not all values in AckCodeType apply to this field.)
Build string Always This refers to the particular software build that eBay used when processing the request and generating the response. This includes the version number plus additional information. eBay Developer Support may request the build information when helping you resolve technical issues.
CorrelationID string Conditionally If you pass a value in MessageID in a request, we will return the same value in CorrelationID in the response. You can use this for tracking that a response is returned for every request and to match particular responses to particular requests. Only returned if MessageID was used.
Errors ErrorType
(repeatable)		 Conditionally A list of application-level errors or warnings (if any) that were raised when eBay processed the request.

Application-level errors occur due to problems with business-level data on the client side or on the eBay server side. For example, an error would occur if the request contains an invalid combination of fields, or it is missing a required field, or the value of the field is not recognized. An error could also occur if eBay encountered a problem in our internal business logic while processing the request.

Only returned if there were warnings or errors.
Errors.ErrorClassification ErrorClassificationCodeType Conditionally API errors are divided between two classes: system errors and request errors.

Applicable values:

•   CustomCode

(out) Reserved for internal or future use.

•   RequestError

(out) An error has occurred either as a result of a problem in the sending application or because the application's end-user has attempted to submit invalid data (or missing data). In these cases, do not retry the request. The problem must be corrected before the request can be made again. If the problem is due to something in the application (such as a missing required field), the application must be changed. If the problem is a result of end-user data, the application must alert the end-user to the problem and provide the means for the end-user to correct the data. Once the problem in the application or data is resolved, resend the request to eBay with the corrected data.

•   SystemError

(out) Indicates that an error has occurred on the eBay system side, such as a database or server down. An application can retry the request as-is a reasonable number of times (eBay recommends twice). If the error persists, contact Developer Technical Support. Once the problem has been resolved, the request may be resent in its original form.




See Errors by Number.
Errors.ErrorCode token Conditionally A unique code that identifies the particular error condition that occurred. Your application can use error codes as identifiers in your customized error-handling algorithms.

See Errors by Number.
Errors.ErrorParameters ErrorParameterType
(repeatable)		 Conditionally Some warning and error messages return one or more variables that contain contextual information about the error. This is often the field or value that triggered the error. You can usually predict where these will occur by looking at the "replaceable_value" indicators in our Errors by Number page.

See Errors by Number.
Errors.ErrorParameters
  [ attribute ParamID ]		 string Conditionally The index of the parameter in the error.
Errors.ErrorParameters.Value string Conditionally The value of the variable.
Errors.LongMessage string Conditionally A more detailed description of the condition that raised the error.

See Errors by Number.
Errors.SeverityCode SeverityCodeType Conditionally Indicates whether the error caused the request to fail.

If the request fails and the source of the problem is within the application (such as a missing required element), please change the application before you retry the request. If the problem is due to end-user input data, please alert the end-user to the problem and provide the means for them to correct the data. Once the problem in the application or data is resolved, you can attempt to re-send the request to eBay.

If the source of the problem is on eBay's side, you can retry the request as-is a reasonable number of times (eBay recommends twice). If the error persists, contact Developer Technical Support. Once the problem has been resolved, the request may be resent in its original form.

When a warning occurs, the error is returned in addition to the business data. In this case, you do not need to retry the request (as the original request was successful). However, depending on the cause or nature of the warning, you might need to contact either the end user or eBay to effect a long term solution to the problem to prevent it from reoccurring in the future.

Applicable values:

•   CustomCode

(out) Reserved for internal or future use

•   Error

(out) The request that triggered the error was not processed successfully. When a serious application-level error occurs, the error is returned instead of the business data.

•   Warning

(out) The request was processed successfully, but something occurred that may affect your application or the user. For example, eBay may have changed a value the user sent in. In this case, eBay returns a normal, successful response and also returns the warning.




See:
    Errors by Number
    Requirements for Error Handling for more information (in the eBay Trading Web Services guide)
Errors.ShortMessage string Conditionally A brief description of the condition that raised the error.

See Errors by Number.
Timestamp dateTime Always This value represents the date and time when eBay processed the request. The time zone of this value is GMT and the format is the ISO 8601 date and time format (YYYY-MM-DDTHH:MM:SS.SSSZ). See the "dateTime" type for information about this time format and converting to and from the GMT time zone.
Version string Always The release version that eBay used to process the request.

Note: This is usually the latest release version, as specified in the release notes. (eBay releases the API to international sites about a week after we release it to the US site.)

If a field in the response returns the token "CustomCode", it usually means that the field is a code type (a token or enumeration), and that in your request URL (or HTTP header) you specified a version that is older than the version in which the token was added to the call.

See eBay Versioning Strategy.
Call-specific Output Fields
ApproximatePages int Always The total number of pages that can be returned, given the same query and filters in the request. As FindHalfProducts only returns up to 2000 products, the maximum possible value is theoretically 2000 (if you were to set MaxEntries to 1 in the request).
Min: 1. Max: 2000.

IncludeSelector: DomainHistogram, Items. Also returned if IncludeSelector is not provided on input.
DomainHistogram DomainHistogramType Conditionally A histogram that lists the number of matching products found and the domains in which they were found. A domain is essentially a set of categories that share certain common features (as determined by Half.com). Each domain has its own name and ID.

IncludeSelector: DomainHistogram.
DomainHistogram.Domain HistogramEntryType
(repeatable)		 Conditionally Each histogram entry shows how many matching products were found in each matching domain. A domain is like a high-level category, or a group of categories whose items share the same basic product characteristics.

IncludeSelector: DomainHistogram.
DomainHistogram.Domain.Count int Conditionally This is the number of products found in the domain. If a product is mapped to more than one domain, it is counted separately for each domain. (For example, if the same product name appears in both Children's Books and Fiction Books, the count for both of these domains will include that product.) This means you cannot sum the product counts to determine the total number of matching products across all domains. The histogram is only intended to show the number of matching products in each individual domain.

IncludeSelector: DomainHistogram.
DomainHistogram.Domain.Name string Conditionally This is the domain name.

A product can be mapped to more than one domain. This means that even if a name appears in this histogram and the Count is greater than 1, you won't necessarily see the same name returned for each returned product (in the Product node of the response). That is, Product.DomainName only returns the most applicable domain name (as determined by eBay).

IncludeSelector: DomainHistogram.
MoreResults boolean Always If true, more pages of results are available. That is, PageNumber is less than ApproximatePages.

IncludeSelector: DomainHistogram, Items. Also returned if IncludeSelector is not provided on input.
PageNumber int Always The number of the page of data returned. If many products are found and multiple pages of results are available, use this in combination with ApproximatePages and HasMore to decide which page to retrieve next. As FindHalfProducts only returns up to 2000 products, the maximum possible value is theoretically 2000 (if you were to set EntriesPerPage to 1 in the request).
Min: 1. Max: 2000.

IncludeSelector: DomainHistogram, Items. Also returned if IncludeSelector is not provided on input.
Products HalfProductsType Always An set of Half.com catalog products. This contains stock information about a particular DVD, book, or other product. When you use QueryKeywords in the request, FindHalfProducts returns a maximum of 20 products per page. When you use ProductID in the request, FindHalfProducts usually only returns 1 product. ItemCount is only returned if you use ProductID with IncludeSelector set to Items or Details. (If more than one product matches the same ProductID, FindHalfProducts will return all of those products. As of the time of this writing, we expect this to be a rare case.)

IncludeSelector: DomainHistogram, Items. Also returned if IncludeSelector is not provided on input.
Products.Product HalfCatalogProductType
(repeatable)		 Always A set of Half.com catalog products. This contains stock information about a particular DVD, book, or other product. When you use QueryKeywords in the request, FindHalfProducts returns a maximum of 20 products per page. When you use ProductID in the request, FindHalfProducts usually only returns 1 product. ItemCount is only returned when ProductID is used in the request and the IncludeSelector is set to Items or Details. (If more than one product matches the same ProductID, FindProducts will return all of those products. As of the time of this writing, we expect this to be a rare case.)

IncludeSelector: DomainHistogram, Items. Also returned if IncludeSelector is not provided on input.
Products.Product.DetailsURL anyURI Conditionally Fully qualified URL for optional information about the product, such as a movie's description or film credits. This information is hosted through the Half.com Web site and it cannot be edited. Portions of the content are protected by copyright. Applications can include this URL as a link in product search results so that end users can view additional descriptive details about the product. This is usually always returned when Product is returned, but it may be safest to check for the existence of this field.

IncludeSelector: DomainHistogram, Items. Also returned if IncludeSelector is not provided on input.
Products.Product
  .DisplayStockPhotos 		boolean Conditionally If true, your application can attempt to display stock photos that are returned. If false, your application should not attempt to display any stock photos that are returned. This recommendation is useful for catalog data related to products like coins, where stock photos are not necessarily applicable or available. An application with a graphical user interface can use this flag to determine when to hide customized stock photo widgets. Always returned when Product is returned.

IncludeSelector: DomainHistogram, Items. Also returned if IncludeSelector is not provided on input.
Products.Product.DomainName string Conditionally The name of the domain in which the product was found. If the product is mapped to multiple domains, Half.com returns the most applicable domain (as determined by Half.com). Always returned when Product is returned.

IncludeSelector: DomainHistogram, Items. Also returned if IncludeSelector is not provided on input.
Products.Product.ItemArray SimpleItemArrayType Conditionally A list of active items that were listed with the requested product. Results are sorted by current price (lowest first), then by recent positive feedback (highest first).

Only returned when you specify Items in IncludeSelector, and the product has matching items that are currently active on Half.com.

IncludeSelector: Items.
Products.Product.ItemArray
  .Item 		SimpleItemType
(repeatable)		 Conditionally Contains data for an item listing.

IncludeSelector: Items.
Products.Product.ItemArray
  .Item.Country 		CountryCodeType Conditionally Two-letter ISO 3166 country code to indicate the country where the item is located.

Applicable values: See Country.

IncludeSelector: Items.
Products.Product.ItemArray
  .Item.CurrentPrice 		AmountType (double) Conditionally The current price of the item, in the currency of the site on which the item was listed. That is, CurrentPrice is in the original listing currency. If the item is a multi-quantity listing, this is the price of one item.

For competitive-bidding listings (Chinese and Dutch auctions), this is the current minimum bid price (if the listing has no bids) or the current high bid (if the listing has bids). (Compare to BuyItNowPrice).

For Basic Fixed-Price (FixedPriceItem), Store Inventory (StoresFixedPrice), and Ad format (AdType) listings, this is the current fixed price.

IncludeSelector: Items.
Products.Product.ItemArray
  .Item.HalfItemCondition 		HalfItemConditionCodeType Conditionally Half condition codes like brand new etc

Applicable values:

•   Acceptable

(out) Some damage to the item but integrity still intact. May be missing an accessory. (Item beaten up a bit but it works)

•   BrandNew

(out) New, unread, unused and in perfect condition.

•   CustomCode

(out) Reserved for internal or future use

•   Good

(out) Very minimal damage to the item and still includes all accessories such as dust jackets, liner notes, and cases. (You would use it yourself, but wouldn't necessarily give it as a gift)

•   LikeNew

(out) Item still in original packaging, no wear and tear, all facets of the product are intact. (Could easily be mistaken for brand new.)

•   Used

(out) Some damage to the item and visibly used.

•   VeryGood

(out) Doesn't look brand new but has no easily noticeable damage and very minimal wear and tear. (You would give it to a good friend as a gift)




IncludeSelector: Items.
Products.Product.ItemArray
  .Item.ItemID 		string Conditionally The ID that uniquely identifies the item listing. eBay generates this ID when an item is listed. This ID is unique across all eBay sites.
Max length: 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits).

IncludeSelector: Items.
Products.Product.ItemArray
  .Item.Seller 		SimpleUserType Conditionally Container for information about this listing's seller.

IncludeSelector: Items.
Products.Product.ItemArray
  .Item.Seller.FeedbackScore 		int Conditionally The aggregate feedback score of a user. A user's feedback score is the net positive feedback minus the net negative feedback left for the user. Feedback scores are a quantitative expression of the desirability of dealing with a user as a buyer or a seller in transactions. Each transaction can result in one feedback entry for a given user. (The buyer can leave feedback for the seller, and the seller can leave feedback for the buyer.) That one feedback can be positive, negative, or neutral. The aggregate feedback score of a user represents that user's overall feedback score (referred to as a "feedback rating" on the eBay site). If the user has chosen to make their feedback private, then FeedbackScore is not returned and FeedbackPrivate is returned with a value of true.

If a bidder's user information is made anonymous, the value -99 is returned.

IncludeSelector: Items.
Products.Product.ItemArray
  .Item.SellerComments 		string Conditionally Seller notes while listing items.

IncludeSelector: Items.
Products.Product.ItemArray
  .Item.Storefront 		StorefrontType Conditionally Whether the item is a storefront listing.

IncludeSelector: Items.
Products.Product.ItemArray
  .Item.Storefront.StoreName 		string Conditionally The name of the seller's eBay Store. FindProducts returns an empty value for all items at the time of this writing. FindHalfProducts returns the name of seller's Half.com Shop, which is the SellerID.
Max length: 200.

IncludeSelector: Items.
Products.Product.ItemArray
  .Item.Storefront.StoreURL 		anyURI Conditionally The URL of the seller's eBay Store page. FindProducts only returned a default URL at the time of this writing. FindHalfProducts returns the URL of the seller's Half.com Shop page.

IncludeSelector: Items.
Products.Product.ItemArray
  .Item
  .ViewItemURLForNaturalSearch 		anyURI Conditionally The URL to view this listing on eBay. 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). You shouldn't modify the query syntax in your application. For example, eBay won't recognize the URL if you change QQ to ?. In the Sandbox environment and on the Hong Kong site (site ID 201), the data returned in this field by FindItemsAdvanced is a standard ViewItem URL, rather than the ViewItem URL for natural search that generally is returned in the Production environment.

IncludeSelector: Items.
Products.Product.ItemCount int Conditionally Total number of listings on the Half.com site that use stock information from this catalog product. This value can be greater than the number of listings returned in ItemArray. ItemCount is only returned when ProductID is used in the search request and the IncludeSelector is set to Items or Details. It is not returned if you include a QueryKeyword in your request.
Min: 0.

IncludeSelector: Items.
Products.Product.ItemSpecifics NameValueListArrayType Conditionally A list of name/value pairs that are included in the product's pre-filled Item Specifics. These indicate common aspects or characteristics of the product, such as Publisher (for a book). Also see ProductID for ISBN, UPC, or EAN values, if applicable. This is usually returned. (We are not aware of any cases in which this node is not be returned. However, it may be safest to check for the existence of this node.)

IncludeSelector: DomainHistogram, Items. Also returned if IncludeSelector is not provided on input.
Products.Product.ItemSpecifics
  .NameValueList 		NameValueListType
(repeatable)		 Conditionally This list is an array of Item Specifics, which are category-specific fields that the seller added to describe the listing. The names of these fields are different for items in different categories, so they're returned in a generic name/value structure.

For example, Item Specifics for a car might include a field like Make=Toyota (where Make is returned in Name, and Toyota is returned in Value) and Model=Prius (where Model is returned in Name, and Prius is returned in Value).

For FindProducts, this can also be an Item Specific that is defined for a product. That is, Item Specifics can be returned both for items and products in FindProducts.

IncludeSelector: DomainHistogram, Items. Also returned if IncludeSelector is not provided on input.
Products.Product.ItemSpecifics
  .NameValueList.Name 		string Conditionally The name of the item specific. This field is always returned for each item specific that is returned (if any). However if the seller didn't select a value for the item specific, we suggest you don't show the name (to avoid confusing users).

For the item condition, this usually includes the word "Condition" for eBay US, UK, Australia, and India listings; and "Artikelzustand" for eBay Germany, Austria, and Switzerland listings.

The Name fields in return policy item specifics (if any) usually include the word "return", "refund", and/or "warranty" for eBay US, Canada, UK, Australia, and India listings; and "Rucknahme", "return", and/or "refund" for eBay Germany, Austria, and Switzerland listings.

Note: Ignore item specifics with SIFFTAS in the name. These are for internal use by eBay and aren't meaningful to users.

IncludeSelector: DomainHistogram, Items. Also returned if IncludeSelector is not provided on input.
Products.Product.ItemSpecifics
  .NameValueList.Value 		string
(repeatable)		 Conditionally A value for the item specific. In GetSingleItem, this field is always returned for each item specific that is returned (if any). However, if the seller didn't select a value for the item specific, this field may return empty, or it may return a value like "-", "Not Selected", or "Unspecified" (or the equivalent in the language of the site).

For the item condition, this usually includes the word "New" or "Used" for eBay US, UK, Australia, and India listings; and "Neu" or "Gebraucht" for eBay Germany, Austria, and Switzerland listings.

IncludeSelector: DomainHistogram, Items. Also returned if IncludeSelector is not provided on input.
Products.Product.MinPrice AmountType (double) Conditionally The minimum price for all active items listed under this product. This field is only returned when QueryKeywords is specified in the request.
Min: 0.

IncludeSelector: Items.
Products.Product.ProductID ProductIDType (string)
(repeatable)		 Conditionally The Half.com or external IDs associated with the product. Use the Reference value as input to search for the same product in the future, or use the ISBN, EAN, or UPC value (if returned). The ISBN, EAN, and UPC values can also be useful as keys if your application is comparing products across different sites. Always returned when Product is returned.

IncludeSelector: DomainHistogram, Items. Also returned if IncludeSelector is not provided on input.
Products.Product.ReviewCount int Conditionally The total number of reviews that are available for this product on the Half.com Web site. This can be greater than the number of reviews returned by FindProducts. In a future release, we will provide the capability to retrieve details about reviews. Always returned when Product is returned.
Min: 0.

IncludeSelector: DomainHistogram, Items. Also returned if IncludeSelector is not provided on input.
Products.Product
  .ShippingCostSummary 		ShippingCostSummaryType Conditionally Contains basic shipping-related costs for the item. If Item.Quantity is greater than 1, this is the shipping cost for one item. If the seller offers a choice of more than one shipping service (such as USPS Ground or Expediated), this is the cost of the "first" shipping option (usually the lowest cost option).

IncludeSelector: Items.
Products.Product
  .ShippingCostSummary
  .ShippingServiceCost 		AmountType (double) Conditionally The basic shipping cost of the item. If multiple items were purchased, this includes the ShippingServiceAdditionalCost.

IncludeSelector: Items.
Products.Product
  .ShippingCostSummary
  .ShippingType 		ShippingTypeCodeType Conditionally How the seller stated that cost of shipping is to be determined, such as flat rate or calculated or free.

In GetSingleItem, this is always returned when ShippingCostSummary is returned.

Applicable values:

•   Calculated

(out) The calculated shipping model: the posted cost of shipping is based on the seller-offered and buyer-selected shipping service, where the shipping costs are calculated by eBay and the shipping carrier based on the buyer's address, and any packaging/handling costs established by the seller are automatically rolled into the total.

•   CalculatedDomesticFlatInternational

(out) The seller specified one or more calculated domestic shipping services and one or more flat international shipping services.

•   CustomCode

(out) Placeholder value. See token.

•   Flat

(out) The flat rate shipping model: the seller establishes the cost of shipping and cost of shipping insurance, regardless of what any buyer-selected shipping service might charge the seller.

•   FlatDomesticCalculatedInternational

(out) The seller specified one or more flat domestic shipping services and one or more calculated international shipping services.

•   Free

(out) Free is used when the seller is declaring that shipping is free for the buyer. Since Free cannot be selected via API, the seller has two options for signifying that shipping is free when listing an item:
- omit shipping details, mention in the item description that shipping is free, and set ShippingTermsInDescription to true
- select an arbitrary shipping service and set its shipping cost to 0, mention in the item description that shipping is free, and set ShippingTermsInDescription to true
The latter is a better way to communicate "free shipping" because eBay picks up the "0" cost and can more accurately identify shipping costs in search results.

•   Freight

(out) The freight shipping model: the cost of shipping is determined by a third party, FreightQuote.com, based on the item location (zip code). Currently, Freight can only be specified on input via eBay Web site, not via API.

•   NotSpecified

(out) The seller did not specify the shipping type.




IncludeSelector: Items.
Products.Product.StockPhotoURL anyURI Conditionally Fully qualified URL for a stock image (if any) that is associated with the Half.com catalog product. The URL is for the image Half.com usually displays in product search results (usually 70px tall). It may be helpful to calculate the dimensions of the photo programmatically before displaying it. Only returned if a URL is available for the product.

IncludeSelector: DomainHistogram, Items. Also returned if IncludeSelector is not provided on input.
Products.Product.Title string Conditionally The title of the product, as specified in the catalog. Always returned when Product is returned.

IncludeSelector: DomainHistogram, Items. Also returned if IncludeSelector is not provided on input.
TotalProducts int Always The total number of matching products found. (If more than 2000 products are found, the call fails with an error.)
Min: 0. Max: 2000.

IncludeSelector: DomainHistogram, Items. Also returned if IncludeSelector is not provided on input.



Back to top

Input Output Detail Controls Samples Change History User Notes
FindHalfProducts Detail Controls


Detail Control: IncludeSelector

The IncludeSelector input field influences which call-specific fields may be returned. (All standard output fields are returned regardless of IncludeSelector.)

noneThe field is returned if IncludeSelector is not specified on input.
YThe field is always returned.
(Y)The field is conditionally returned. See the field description for clarification of conditions.

Output Field DomainHistogram Items none
ApproximatePagesYYY
DomainHistogram(Y)--
DomainHistogram.Domain(Y)--
DomainHistogram.Domain.Count(Y)--
DomainHistogram.Domain.Name(Y)--
MoreResultsYYY
PageNumberYYY
ProductsYYY
Products.ProductYYY
Products.Product.DetailsURL(Y)(Y)(Y)
Products.Product.DisplayStockPhotos(Y)(Y)(Y)
Products.Product.DomainName(Y)(Y)(Y)
Products.Product.ItemArray-(Y)-
Products.Product.ItemArray.Item-(Y)-
Products.Product.ItemArray.Item.Country-(Y)-
Products.Product.ItemArray.Item.CurrentPrice-(Y)-
Products.Product.ItemArray.Item.HalfItemCondition-(Y)-
Products.Product.ItemArray.Item.ItemID-(Y)-
Products.Product.ItemArray.Item.Seller-(Y)-
Products.Product.ItemArray.Item.Seller.FeedbackScore-(Y)-
Products.Product.ItemArray.Item.SellerComments-(Y)-
Products.Product.ItemArray.Item.Storefront-(Y)-
Products.Product.ItemArray.Item.Storefront.StoreName-(Y)-
Products.Product.ItemArray.Item.Storefront.StoreURL-(Y)-
Products.Product.ItemArray.Item.ViewItemURLForNaturalSearch-(Y)-
Products.Product.ItemCount-(Y)-
Products.Product.ItemSpecifics(Y)(Y)(Y)
Products.Product.ItemSpecifics.NameValueList(Y)(Y)(Y)
Products.Product.ItemSpecifics.NameValueList.Name(Y)(Y)(Y)
Products.Product.ItemSpecifics.NameValueList.Value(Y)(Y)(Y)
Products.Product.MinPrice-(Y)-
Products.Product.ProductID(Y)(Y)(Y)
Products.Product.ReviewCount(Y)(Y)(Y)
Products.Product.ShippingCostSummary-(Y)-
Products.Product.ShippingCostSummary.ShippingServiceCost-(Y)-
Products.Product.ShippingCostSummary.ShippingType-(Y)-
Products.Product.StockPhotoURL(Y)(Y)(Y)
Products.Product.Title(Y)(Y)(Y)
TotalProductsYYY



Back to top

Input Output Detail Controls Samples Change History User Notes
FindHalfProducts Samples

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:

Sample: Basic Call

Retrieves products that match a keyword query.

Input

Here is an example of specifying a string like "Harry Potter" to obtain a list of products.

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=FindHalfProducts
   &responseencoding=XML
   &appid=YourAppID
   &version=527
   &QueryKeywords=harry%20potter
   &MaxEntries=2

   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"?>
<FindHalfProductsRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <QueryKeywords>harry potter</QueryKeywords>
  <MaxEntries>2</MaxEntries>
</FindHalfProductsRequest>

Output

Here is an example of the default output that you can obtain using this call.

   If you chose XML as the response encoding type, you would get something like this.

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

<?xml version="1.0" encoding="utf-8"?>
<FindHalfProductsResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2007-08-23T00:38:28.171Z</Timestamp>
  <Ack>Success</Ack>
  <Build>e527_core_Bundled_5199934_R1</Build>
  <Version>527</Version>
  <PageNumber>1</PageNumber>
  <ApproximatePages>109</ApproximatePages>
  <MoreResults>true</MoreResults>
  <TotalProducts>217</TotalProducts>
  <Products>
    <Product>
      <Title>Harry Potter and the Order of the Phoenix by J. K. Rowling (2004)</Title>
      <DetailsURL>http://syicatalogs.ebay.com/ws/eBayISAPI.dll?PageSyiProductDetails&IncludeAttributes=1&ShowAttributesTable=1&ProductMementoString=80671:2:1055:2284604981:57843881:7792a32407cb7d2a381f0fa6589b5990:1:1:1:8888877611</DetailsURL>
      <StockPhotoURL>http://i4.ebayimg.com/03/c/00/7b/7e/59_6.JPG</StockPhotoURL>
      <DisplayStockPhotos>true</DisplayStockPhotos>
      <ProductID type="Reference">31266511</ProductID>
      <ProductID type="ISBN">1234567890</ProductID>
      <DomainName>Nonfiction Books</DomainName>
      <ItemSpecifics>
        <NameValueList>
          <Name>Format</Name>
          <Value>Softcover</Value>
        </NameValueList>
        <NameValueList>
          <Name>Author</Name>
          <Value>J. K. Rowling</Value>
        </NameValueList>
      </ItemSpecifics>
      <ReviewCount>36</ReviewCount>
    </Product>
    <Product>
      <Title>Harry Potter and the Sorcerers Stone by Jill Daniels (2001)</Title>
      <DetailsURL>http://syicatalogs.ebay.com/ws/eBayISAPI.dll?PageSyiProductDetails&IncludeAttributes=1&ShowAttributesTable=1&ProductMementoString=80671:2:1055:1388689156:59451876:7b8d398d310ba24884754683a8efef0e:1:1:1:1078089110</DetailsURL>
      <StockPhotoURL>http://i3.ebayimg.com/03/c/00/77/a0/ee_6.JPG</StockPhotoURL>
      <DisplayStockPhotos>true</DisplayStockPhotos>
      <ProductID type="Reference">8793876</ProductID>
      <ProductID type="ISBN">9780439294829</ProductID>
      <ProductID type="ISBN">0439294827</ProductID>
      <DomainName>Nonfiction Books</DomainName>
      <ItemSpecifics>
        <NameValueList>
          <Name>Format</Name>
          <Value>Hardcover</Value>
        </NameValueList>
        <NameValueList>
          <Name>Author</Name>
          <Value>Jill Daniels</Value>
        </NameValueList>
      </ItemSpecifics>
      <ReviewCount>0</ReviewCount>
    </Product>
  </Products>
</FindHalfProductsResponse>

Back to list of samples

Sample: Getting Items with Basic Details Call

For one product, retrieves a list of items with the most commonly used fields.

Input

This sample shows how to use Items as an IncludeSelector. If you use Items, the call retrieves up to 200 items for the requested product.

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=FindHalfProducts
   &responseencoding=XML
   &appid=YourAppID
   &version=527
   &ProductID.type=ISBN
   &ProductID.Value=0439294827
   &IncludeSelector=Items

   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"?>
<FindHalfProductsRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <IncludeSelector>Items</IncludeSelector>
  <ProductID type="ISBN">0439294827</ProductID>
</FindHalfProductsRequest>

Output

Here is an example of the output that you can obtain using Items as an IncludeSelector.

   If you chose XML as the response encoding type, you would get something like this.

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

<?xml version="1.0" encoding="utf-8"?>
<FindHalfProductsResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2007-08-23T01:00:03.250Z</Timestamp>
  <Ack>Success</Ack>
  <Build>e527_core_Bundled_5199934_R1</Build>
  <Version>527</Version>
  <PageNumber>1</PageNumber>
  <ApproximatePages>1</ApproximatePages>
  <MoreResults>false</MoreResults>
  <TotalProducts>1</TotalProducts>
  <Products>
    <Product>
      <Title>Harry Potter and the Sorcerers Stone by Jill Daniels (2001)</Title>
      <DetailsURL>http://syicatalogs.ebay.com/ws/eBayISAPI.dll?PageSyiProductDetails&IncludeAttributes=1&ShowAttributesTable=1&ProductMementoString=80671:2:1055:1388689156:59451876:7b8d398d310ba24884754683a8efef0e:1:1:1:1078089110</DetailsURL>
      <StockPhotoURL>http://i3.ebayimg.com/03/c/00/77/a0/ee_6.JPG</StockPhotoURL>
      <ShippingCostSummary>
        <ShippingServiceCost>3.99</ShippingServiceCost>
        <ShippingType>Flat</ShippingType>
      </ShippingCostSummary>
      <DisplayStockPhotos>true</DisplayStockPhotos>
      <ItemCount>29</ItemCount>
      <ProductID type="Reference">8793876</ProductID>
      <ProductID type="ISBN">9780439294829</ProductID>
      <ProductID type="ISBN">0439294827</ProductID>
      <DomainName>Nonfiction Books</DomainName>
      <ItemSpecifics>
        <NameValueList>
          <Name>Format</Name>
          <Value>Hardcover</Value>
        </NameValueList>
        <NameValueList>
          <Name>Author</Name>
          <Value>Jill Daniels</Value>
        </NameValueList>
      </ItemSpecifics>
      <ItemArray>
        <Item>
          <ItemID>14015587752</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/Harry-Potter-and-the-Sorcerers-Stone-Jill-Daniels-Hardcover-2001_W0QQprZ8793876QQtgZvidetailsQQitemZ14015587752</ViewItemURLForNaturalSearch>
          <Seller>
            <FeedbackScore>0</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">8.75</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/karthikseller-123106500619_W0QQsellerZkarthikseller_123106500619</StoreURL>
            <StoreName>karthikseller_123106500619</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>BrandNew</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>90000100921</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/Harry-Potter-and-the-Sorcerers-Stone-Jill-Daniels-Hardcover-2001_W0QQprZ8793876QQtgZvidetailsQQitemZ90000100921</ViewItemURLForNaturalSearch>
          <Location>San Jose, CA</Location>
          <Seller>
            <FeedbackScore>2368</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">9.51</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/am-seller_W0QQsellerZam_seller</StoreURL>
            <StoreName>am_seller</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>BrandNew</HalfItemCondition>
          <SellerComments>etest</SellerComments>
        </Item>
        <Item>
          <ItemID>90000475431</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/stephanie-half-item_W0QQprZ8793876QQtgZvidetailsQQitemZ90000475431</ViewItemURLForNaturalSearch>
          <Location>New York, New York</Location>
          <Seller>
            <FeedbackScore>200</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">10.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/svu-half01_W0QQsellerZsvu-half01</StoreURL>
            <StoreName>svu-half01</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>BrandNew</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>90000475432</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/stephanie-half-item_W0QQprZ8793876QQtgZvidetailsQQitemZ90000475432</ViewItemURLForNaturalSearch>
          <Location>New York, New York</Location>
          <Seller>
            <FeedbackScore>200</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">10.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/svu-half01_W0QQsellerZsvu-half01</StoreURL>
            <StoreName>svu-half01</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>BrandNew</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>90000475433</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/stephanie-half-item_W0QQprZ8793876QQtgZvidetailsQQitemZ90000475433</ViewItemURLForNaturalSearch>
          <Location>New York, New York</Location>
          <Seller>
            <FeedbackScore>200</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">10.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/svu-half01_W0QQsellerZsvu-half01</StoreURL>
            <StoreName>svu-half01</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>BrandNew</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>90000468597</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/stephanie-half-item_W0QQprZ8793876QQtgZvidetailsQQitemZ90000468597</ViewItemURLForNaturalSearch>
          <Location>San Jose</Location>
          <Seller>
            <FeedbackScore>103</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">10.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/alm-half-01_W0QQsellerZalm_half_01</StoreURL>
            <StoreName>alm_half_01</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>LikeNew</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>90000468617</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/stephanie-half-item_W0QQprZ8793876QQtgZvidetailsQQitemZ90000468617</ViewItemURLForNaturalSearch>
          <Location>San Jose</Location>
          <Seller>
            <FeedbackScore>103</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">10.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/alm-half-01_W0QQsellerZalm_half_01</StoreURL>
            <StoreName>alm_half_01</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>LikeNew</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>90000468620</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/stephanie-half-item_W0QQprZ8793876QQtgZvidetailsQQitemZ90000468620</ViewItemURLForNaturalSearch>
          <Location>San Jose</Location>
          <Seller>
            <FeedbackScore>103</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">10.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/alm-half-01_W0QQsellerZalm_half_01</StoreURL>
            <StoreName>alm_half_01</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>LikeNew</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>90000468628</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/stephanie-half-item_W0QQprZ8793876QQtgZvidetailsQQitemZ90000468628</ViewItemURLForNaturalSearch>
          <Location>San Jose</Location>
          <Seller>
            <FeedbackScore>103</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">10.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/alm-half-01_W0QQsellerZalm_half_01</StoreURL>
            <StoreName>alm_half_01</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>LikeNew</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>90000469021</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/stephanie-half-item_W0QQprZ8793876QQtgZvidetailsQQitemZ90000469021</ViewItemURLForNaturalSearch>
          <Location>San Jose</Location>
          <Seller>
            <FeedbackScore>103</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">10.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/alm-half-01_W0QQsellerZalm_half_01</StoreURL>
            <StoreName>alm_half_01</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>LikeNew</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>90000051683</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/Harry-Potter-and-the-Sorcerers-Stone-Jill-Daniels-Hardcover-2001_W0QQprZ8793876QQtgZvidetailsQQitemZ90000051683</ViewItemURLForNaturalSearch>
          <Seller>
            <FeedbackScore>1150</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">5.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/half-s_W0QQsellerZhalf_s</StoreURL>
            <StoreName>half_s</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>VeryGood</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>90000051695</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/Harry-Potter-and-the-Sorcerers-Stone-Jill-Daniels-Hardcover-2001_W0QQprZ8793876QQtgZvidetailsQQitemZ90000051695</ViewItemURLForNaturalSearch>
          <Seller>
            <FeedbackScore>1150</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">5.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/half-s_W0QQsellerZhalf_s</StoreURL>
            <StoreName>half_s</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>VeryGood</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>90000783487</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/Harry-Potter-and-the-Sorcerers-Stone-Jill-Daniels-Hardcover-2001_W0QQprZ8793876QQtgZvidetailsQQitemZ90000783487</ViewItemURLForNaturalSearch>
          <Seller>
            <FeedbackScore>0</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">5.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/halfregression_W0QQsellerZhalfregression</StoreURL>
            <StoreName>halfregression</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>VeryGood</HalfItemCondition>
          <SellerComments>xzcvbzxcb</SellerComments>
        </Item>
        <Item>
          <ItemID>14015087167</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/Harry-Potter-and-the-Sorcerers-Stone-Hard_W0QQprZ8793876QQtgZvidetailsQQitemZ14015087167</ViewItemURLForNaturalSearch>
          <Location>San Jose, California</Location>
          <Seller>
            <FeedbackScore>153</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">6.99</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/mxv4102_W0QQsellerZmxv4102</StoreURL>
            <StoreName>mxv4102</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>VeryGood</HalfItemCondition>
          <SellerComments>dfhj</SellerComments>
        </Item>
        <Item>
          <ItemID>14015582484</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/SDK-item-title_W0QQprZ8793876QQtgZvidetailsQQitemZ14015582484</ViewItemURLForNaturalSearch>
          <Location>Cupertino, California</Location>
          <Seller>
            <FeedbackScore>1</FeedbackScore>
          </Seller>
          <CurrentPrice currenc