Shopping API863

FindHalfProducts

This call searches 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.

Usage Details

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 (such as 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. Also, due to the way product data is cached, you may get a faster response when you run the same query a second time.

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 specify a single ProductID. See the FindHalfProducts Detail Controls for which fields will be returned.

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.

Related Information

See also the reference documentation for this call (in the HalfFinding API Reference):



Back to top

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.

<?xml version="1.0" encoding="utf-8"?>
<FindHalfProductsRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Input Fields -->
  <AvailableItemsOnly> boolean </AvailableItemsOnly>
  <DomainName> string </DomainName>
  <!-- ... more DomainName values allowed 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>
  <!-- Standard Input Fields -->
  <MessageID> string </MessageID>
</FindHalfProductsRequest>
Argument Type Occurrence Meaning
Call-specific Input Fields [Jump to standard 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 Optional,
repeatable: [0..*]
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, 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.


Standard Input 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.



Back to top

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.

<?xml version="1.0" encoding="utf-8"?>
<FindHalfProductsResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Output Fields -->
  <ApproximatePages> int </ApproximatePages>
  <DomainHistogram> DomainHistogramType
    <Domain> HistogramEntryType
      <Count> int </Count>
      <Name> string </Name>
    </Domain>
    <!-- ... more Domain nodes allowed 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>
          <Quantity> int </Quantity>
          <Seller> SimpleUserType
            <FeedbackScore> int </FeedbackScore>
            <PositiveFeedbackPercent> float </PositiveFeedbackPercent>
          </Seller>
          <SellerComments> string </SellerComments>
          <Storefront> StorefrontType
            <StoreName> string </StoreName>
            <StoreURL> anyURI </StoreURL>
          </Storefront>
          <ViewItemURLForNaturalSearch> anyURI </ViewItemURLForNaturalSearch>
        </Item>
        <!-- ... more Item nodes allowed here ... -->
      </ItemArray>
      <ItemCount> int </ItemCount>
      <ItemSpecifics> NameValueListArrayType
        <NameValueList> NameValueListType
          <Name> string </Name>
          <Value> string </Value>
          <!-- ... more Value values allowed here ... -->
        </NameValueList>
        <!-- ... more NameValueList nodes allowed here ... -->
      </ItemSpecifics>
      <MinPrice> AmountType (double) </MinPrice>
      <ProductID type="ProductIDCodeType"> ProductIDType (string) </ProductID>
      <!-- ... more ProductID nodes allowed here ... -->
      <ReviewCount> int </ReviewCount>
      <ShippingCostSummary> ShippingCostSummaryType
        <ListedShippingServiceCost> AmountType (double) </ListedShippingServiceCost>
        <ShippingServiceCost> AmountType (double) </ShippingServiceCost>
        <ShippingType> ShippingTypeCodeType </ShippingType>
      </ShippingCostSummary>
      <StockPhotoURL> anyURI </StockPhotoURL>
      <Title> string </Title>
    </Product>
    <!-- ... more Product nodes allowed here ... -->
  </Products>
  <!-- ... more Products nodes allowed here ... -->
  <TotalProducts> int </TotalProducts>
  <!-- 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 allowed here ... -->
    <LongMessage> string </LongMessage>
    <SeverityCode> SeverityCodeType </SeverityCode>
    <ShortMessage> string </ShortMessage>
  </Errors>
  <!-- ... more Errors nodes allowed here ... -->
  <Timestamp> dateTime </Timestamp>
  <Version> string </Version>
</FindHalfProductsResponse>
Return Value Type Occurrence Meaning
Call-specific Output Fields [Jump to standard 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: none (not controlled by IncludeSelector)
DomainHistogram DomainHistogramType Always 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 Always,
repeatable: [1..*]
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 Always 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 Always 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: none (not controlled by IncludeSelector)
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: none (not controlled by IncludeSelector)
Products HalfProductsType Always,
repeatable: [1..20]
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: none (not controlled by IncludeSelector)
Products.Product HalfCatalogProductType Always,
repeatable: [1..*]
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: none (not controlled by IncludeSelector)
Products.Product.DetailsURL anyURI Always 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: none (not controlled by IncludeSelector)
Products.Product
  .DisplayStockPhotos
boolean Always 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: none (not controlled by IncludeSelector)
Products.Product.DomainName string Always 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: none (not controlled by IncludeSelector)
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 Conditionally,
repeatable: [0..*]
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 original listing currency.

For auction listings, this price is the starting minimum price (if the listing has no bids) or the current highest bid (if bids have been placed) for the item. This does not reflect the BuyItNow price.

For fixed-price and ad format listings, this is the current listing price.

IncludeSelector: Items
Products.Product.ItemArray
  .Item.HalfItemCondition
HalfItemConditionCodeType Conditionally Returns the Half.com condition code for the item. For example, "brand new," "used," 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

See (GetSingleItem) Item.Variations.

Products.Product.ItemArray
  .Item.Quantity
int Conditionally The number of items the seller is offering in the listing. (Subtract Item.QuantitySold from this value to calculate the number of items currently available for sale.)

An online, comptetitive-bidding auction with a Quantity of 1 is referred to as a < i>Chinese auction. Basic fixed-price listings can have a Quantity of 1 or more.

The listing's current or Buy It Now price is the price of the item in the listing.

Note: A seller can also offer multiple items for sale with a single price for all the items. For example, instead of listing 10 lightbulbs for US 2.00 each, they might list 10 lightbulbs for USD 20.00 (where you have to buy all 10). This is called a "lot."

If the listing includes a lot, Quantity does not specify the lot size; it reflects how many lots are being sold. For example, if the original listing included 5 lots of 10 lightbulbs each, Quantity would be 5.



IncludeSelector: Items

See Item.ListingType.

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.Seller
  .PositiveFeedbackPercent
float Conditionally A seller's positive feedback score. The percentage value of a seller's positive feedback is calculated by dividing the seller's positive feedback score by their negative feedback score. The last 12 months of feedback scores are taken into consideration for this calculation.

IncludeSelector: Items
Products.Product.ItemArray
  .Item.SellerComments
string Conditionally Notes that the Seller made when they listed the item. Not returned if the Seller did not make any comments.

IncludeSelector: Items
Products.Product.ItemArray
  .Item.Storefront
StorefrontType Conditionally Returns the seller's store information if the seller has an eBay store. Returns a blank store if the seller does not have an eBay storefront.

IncludeSelector: Items
Products.Product.ItemArray
  .Item.Storefront.StoreName
string Conditionally The name of the seller's eBay Store. Not returned if the seller does not have an 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. Not returned if the seller does not have an eBay store.

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

IncludeSelector: Items

See (GetSingleItem) Item.Variations.

Products.Product.ItemCount int Always 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.

Note: ItemCount is always returned, however, it's value will be zero unless you use ProductID in the search request and you set IncludeSelector to Items. Although ItemCount always returns 0 if you search using QueryKeyword, check for the presence of MinPrice; if the response contains MinPrice, you can retrieve a value for ItemCount as described.
Min: 0.

IncludeSelector: none (not controlled by IncludeSelector)
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: none (not controlled by IncludeSelector)
Products.Product.ItemSpecifics
  .NameValueList
NameValueListType Conditionally,
repeatable: [0..*]
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).

In multi-variation listings, the same name cannot appear in both the VariationSpecifics node and in the ItemSpecifics node.

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: none (not controlled by IncludeSelector)
Products.Product.ItemSpecifics
  .NameValueList.Name
string Conditionally The name of the item specific.

This field is returned only in responses if the seller included an item specific Name in the listing. However, if the seller didn't also include a corresponding value for the item specific, it is best to not display the name to 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.

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

IncludeSelector: none (not controlled by IncludeSelector)
Products.Product.ItemSpecifics
  .NameValueList.Value
string Conditionally,
repeatable: [0..*]
A value for the item specific.

This field is only returned in responses if the seller included a value for an item specific. In the GetSingleItem response, 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: none (not controlled by IncludeSelector)
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: none (not controlled by IncludeSelector)
Products.Product.ProductID ProductIDType (string) Always,
repeatable: [1..*]
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: none (not controlled by IncludeSelector)
Products.Product.ProductID
  [ attribute type ]
ProductIDCodeType Always The nature of identifier being used. For FindHalfProducts, FindProducts, and FindReviewsAndGuides, only Reference, ISBN, UPC, and EAN are supported. Required when ProductID is specified.

For a list of possible enumeration values, see ProductIDCodeType.
Products.Product.ReviewCount int Always 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: none (not controlled by IncludeSelector)
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
  .ListedShippingServiceCost
AmountType (double) Conditionally The listed shipping cost of the item. If multiple items were purchased, this includes the listed ShippingServiceAdditionalCost.

In GetSingleItem, this is always returned when ShippingCostSummary is returned, except when the ShippingType is Freight.

IncludeSelector: Items
Products.Product
  .ShippingCostSummary
  .ShippingServiceCost
AmountType (double) Conditionally The basic shipping cost of the item. This reflects the domestic shipping cost or the international shipping costs, depending on which applies (that is, whether the bidder/buyer is in the same country as the listing site of the item).

In GetSingleItem, this is always returned when ShippingCostSummary is returned, except for when the ShippingType is Freight.

GetShippingCosts: Flat shipping: single-item listing: this matches (in)ShippingServiceCost; multi-quantity listing: with a request version of 665 or greater, this is the total of (in)ShippingServiceCost plus ((in)ShippingServiceAdditionalCost times the number of items beyond the first item), and with a request version lower than 665, this is (in)ShippingServiceCost.
Promotional shipping: For a request version lower than 665, promotional shipping has no effect on shipping costs. Otherwise: if the promotional shipping option is lower than other shipping services being offered, the savings is reflected in the returned shipping cost; the shipping service named Promotional Shipping Service (or whatever is the localized name for it) is included among the shipping services; if the promotional shipping cost is lower than the cost of other shipping services being offered, it is presented first in the list (the lowest shipping service cost is always presented first, regardless of whether there is promotional shipping).
Shipping surcharge: With a request version of 665 or greater, shipping cost includes any surcharge, and surcharge is not returned as an individual tag. With a request version lower than 665, surcharge is not part of the total cost and is returned as its own tag.

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.

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: none (not controlled by IncludeSelector)
Products.Product.Title string Always The title of the product, as specified in the catalog. Always returned when Product is returned.

IncludeSelector: none (not controlled by IncludeSelector)
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: none (not controlled by IncludeSelector)
Standard Output 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 Conditionally,
repeatable: [0..*]
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 Conditionally,
repeatable: [0..*]
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
    Checklist for Going Live for more information see the eBay Features 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 Schema Versioning Strategy.



Back to top

FindHalfProducts Detail Controls


IncludeSelector

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 documentation for a clarification of these conditions.

YThe field is always returned.
(Y)The field is conditionally returned. See the field documentation for clarification of conditions.

Output Field none DomainHistogram Items
ApproximatePagesY--
DomainHistogram-Y-
DomainHistogram.Domain-Y-
DomainHistogram.Domain.Count-Y-
DomainHistogram.Domain.Name-Y-
MoreResultsY--
PageNumberY--
ProductsY--
Products.ProductY--
Products.Product.DetailsURLY--
Products.Product.DisplayStockPhotosY--
Products.Product.DomainNameY--
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.Quantity--(Y)
Products.Product.ItemArray.Item.Seller--(Y)
Products.Product.ItemArray.Item.Seller.FeedbackScore--(Y)
Products.Product.ItemArray.Item.Seller.PositiveFeedbackPercent--(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.ItemCountY--
Products.Product.ItemSpecifics(Y)--
Products.Product.ItemSpecifics.NameValueList(Y)--
Products.Product.ItemSpecifics.NameValueList.Name(Y)--
Products.Product.ItemSpecifics.NameValueList.Value(Y)--
Products.Product.MinPrice(Y)--
Products.Product.ProductIDY--
Products.Product.ReviewCountY--
Products.Product.ShippingCostSummary--(Y)
Products.Product.ShippingCostSummary.ListedShippingServiceCost--(Y)
Products.Product.ShippingCostSummary.ShippingServiceCost--(Y)
Products.Product.ShippingCostSummary.ShippingType--(Y)
Products.Product.StockPhotoURL(Y)--
Products.Product.TitleY--
TotalProductsY--


DetailLevel

This call does not support varying Detail Levels. You do not need to pass DetailLevel in the request.



Back to top

FindHalfProducts Samples

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

Note: Some data in these samples might no longer be active. If necessary, you can substitute current data in your requests.

Available samples:

Sample: Basic Call

Retrieves products from Half.com that are associated with a supplied keyword.

Input

This example searches Half.com for items that are associated with the keyword "harry potter".

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

The output from this example shows the default values returned by a keyword search.

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 Item Details by ProductID

Retrieves a list of available of items by a ProductID. The call uses an ItemSelector to return an extended set of item fields.

Input

This sample uses the Items IncludeSelector to return item details in the result. If you use Items, the call can retrieve 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

This example shows the output form a call that use the Items IncludeSelector.

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 currencyID="USD">1.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/halfapiuser7_W0QQsellerZhalfapiuser7</StoreURL>
            <StoreName>halfapiuser7</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>Good</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>14015582849</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/SDK-item-title_W0QQprZ8793876QQtgZvidetailsQQitemZ14015582849</ViewItemURLForNaturalSearch>
          <Location>Cupertino, California</Location>
          <Seller>
            <FeedbackScore>1</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">1.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/halfapiuser7_W0QQsellerZhalfapiuser7</StoreURL>
            <StoreName>halfapiuser7</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>Good</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>14015584336</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/SDK-item-title_W0QQprZ8793876QQtgZvidetailsQQitemZ14015584336</ViewItemURLForNaturalSearch>
          <Location>Cupertino, California</Location>
          <Seller>
            <FeedbackScore>1</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">1.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/halfapiuser7_W0QQsellerZhalfapiuser7</StoreURL>
            <StoreName>halfapiuser7</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>Good</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>14015585399</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/SDK-item-title_W0QQprZ8793876QQtgZvidetailsQQitemZ14015585399</ViewItemURLForNaturalSearch>
          <Location>Cupertino, California</Location>
          <Seller>
            <FeedbackScore>1</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">1.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/halfapiuser7_W0QQsellerZhalfapiuser7</StoreURL>
            <StoreName>halfapiuser7</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>Good</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>14015585598</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/SDK-item-title_W0QQprZ8793876QQtgZvidetailsQQitemZ14015585598</ViewItemURLForNaturalSearch>
          <Location>Cupertino, California</Location>
          <Seller>
            <FeedbackScore>1</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">1.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/halfapiuser7_W0QQsellerZhalfapiuser7</StoreURL>
            <StoreName>halfapiuser7</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>Good</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>14014801112</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/Harry-Potter-and-the-Sorcerers-Stone-Jill-Daniels-Hardcover-2001_W0QQprZ8793876QQtgZvidetailsQQitemZ14014801112</ViewItemURLForNaturalSearch>
          <Location>San Jose, California</Location>
          <Seller>
            <FeedbackScore>153</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">8.99</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/mxv4102_W0QQsellerZmxv4102</StoreURL>
            <StoreName>mxv4102</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>Acceptable</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>14014799055</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/Harry-Potter-and-the-Sorcerers-Stone-Jill-Daniels-Hardcover-2001_W0QQprZ8793876QQtgZvidetailsQQitemZ14014799055</ViewItemURLForNaturalSearch>
          <Location>San Jose, California</Location>
          <Seller>
            <FeedbackScore>153</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">9.99</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/mxv4102_W0QQsellerZmxv4102</StoreURL>
            <StoreName>mxv4102</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>Acceptable</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>14014801111</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/Harry-Potter-and-the-Sorcerers-Stone-Jill-Daniels-Hardcover-2001_W0QQprZ8793876QQtgZvidetailsQQitemZ14014801111</ViewItemURLForNaturalSearch>
          <Location>San Jose, California</Location>
          <Seller>
            <FeedbackScore>153</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">9.99</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/mxv4102_W0QQsellerZmxv4102</StoreURL>
            <StoreName>mxv4102</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>Acceptable</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>90000181503</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/Harry-Potter-and-the-Sorcerers-Stone-Jill-Daniels-Hardcover-2001_W0QQprZ8793876QQtgZvidetailsQQitemZ90000181503</ViewItemURLForNaturalSearch>
          <Location>San Jose, California</Location>
          <Seller>
            <FeedbackScore>153</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">16.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/mxv4102_W0QQsellerZmxv4102</StoreURL>
            <StoreName>mxv4102</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>Acceptable</HalfItemCondition>
          <SellerComments>FP test</SellerComments>
        </Item>
        <Item>
          <ItemID>90000783327</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/Harry-Potter-and-the-Sorcerers-Stone-Jill-Daniels-Hardcover-2001_W0QQprZ8793876QQtgZvidetailsQQitemZ90000783327</ViewItemURLForNaturalSearch>
          <Seller>
            <FeedbackScore>33</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">1234.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/halfapiuser_W0QQsellerZhalfapiuser</StoreURL>
            <StoreName>halfapiuser</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>Acceptable</HalfItemCondition>
          <SellerComments>My update Notes</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 currencyID="USD">1.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/halfapiuser7_W0QQsellerZhalfapiuser7</StoreURL>
            <StoreName>halfapiuser7</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>Used</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>14015582849</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/SDK-item-title_W0QQprZ8793876QQtgZvidetailsQQitemZ14015582849</ViewItemURLForNaturalSearch>
          <Location>Cupertino, California</Location>
          <Seller>
            <FeedbackScore>1</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">1.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/halfapiuser7_W0QQsellerZhalfapiuser7</StoreURL>
            <StoreName>halfapiuser7</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>Used</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>14015584336</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/SDK-item-title_W0QQprZ8793876QQtgZvidetailsQQitemZ14015584336</ViewItemURLForNaturalSearch>
          <Location>Cupertino, California</Location>
          <Seller>
            <FeedbackScore>1</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">1.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/halfapiuser7_W0QQsellerZhalfapiuser7</StoreURL>
            <StoreName>halfapiuser7</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>Used</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>14015585399</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/SDK-item-title_W0QQprZ8793876QQtgZvidetailsQQitemZ14015585399</ViewItemURLForNaturalSearch>
          <Location>Cupertino, California</Location>
          <Seller>
            <FeedbackScore>1</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">1.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/halfapiuser7_W0QQsellerZhalfapiuser7</StoreURL>
            <StoreName>halfapiuser7</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>Used</HalfItemCondition>
        </Item>
        <Item>
          <ItemID>14015585598</ItemID>
          <ViewItemURLForNaturalSearch>http://product.half.ebay.com/SDK-item-title_W0QQprZ8793876QQtgZvidetailsQQitemZ14015585598</ViewItemURLForNaturalSearch>
          <Location>Cupertino, California</Location>
          <Seller>
            <FeedbackScore>1</FeedbackScore>
          </Seller>
          <CurrentPrice currencyID="USD">1.0</CurrentPrice>
          <Storefront>
            <StoreURL>http://shops.half.ebay.com/halfapiuser7_W0QQsellerZhalfapiuser7</StoreURL>
            <StoreName>halfapiuser7</StoreName>
          </Storefront>
          <Country>US</Country>
          <HalfItemCondition>Used</HalfItemCondition>
        </Item>
      </ItemArray>
      <ReviewCount>0</ReviewCount>
    </Product>
  </Products>
</FindHalfProductsResponse>

Back to list of samples



Back to top

FindHalfProducts Change History

Version Description
637
2009-09-30
  • ShippingCostSummaryType.ListedShippingServiceCost (added): The listed shipping cost for an item.
599
2009-01-07
  • ProductSearchURL (added): A URL for product search results that corresponds to your search request. This is similar to ItemSearchURL in FindItems and FindItemsAdvanced.
565
2008-05-14
  • ProductID (modified): Starting in May 2008, some sites will start migrating some catalogs to a new provider. If you pass in an older product reference ID, Half.com will return items listed with a corresponding product, if available.
561
2008-04-16
  • Products.Product.MinPrice (added): The minimum price of items listed under a given product. Returned for query requests only.
  • Products.Product.ItemCount (modified): Now returned for query requests.
531
2007-09-21
  • SellerID (added): To search for specific Products with SellerID, specify ProductID and SellerID together.
527
2007-22-08
  • (added) New call.

Back to top

User-Contributed Notes

 

Copyright © 2006–2014 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.