eBay Shopping APIVersion 1293
 

GetSingleItemRequestType ( AbstractRequestType )

Retrieves publicly available data for a single listing. Use this call to retrieve most of the information that is visible on a listing's View Item page on the eBay Web site, such as title, description, prices, basic seller and bidder information, and other details about the listing. Also returns basic shipping cost information. For more information on shipping details, use GetShippingCosts.

Call that uses GetSingleItemRequestType:

Fields

IncludeSelector ( string ) [0..1]
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 (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:

•   Details

Include most available fields in the response (except fields that significantly affect the call's performance).

•   Description

Include the Description field in the response. (This can affect the call's performance.)

•   TextDescription

Include the text Description (no html tag) field in the response. (This can affect the call's performance.)

•   ShippingCosts

Include basic shipping costs in the response. (Use GetShippingCosts to retrieve more details.)

•   ItemSpecifics

Include ItemSpecifics in the response.

•   Variations

Include Variations in the response.

•   Compatibility

Include Compatibility in the response.


Use a comma to specify multiple values. (In this case, the results are cumulative.) See "GetSingleItem 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.
See the Field Index to learn which calls use IncludeSelector.

ItemID ( string ) [0..1]
The item ID that uniquely identifies the item listing for which to retrieve the data.

You can determine an item's ID by calling findItemsAdvanced( Finding API) or from the eBay Web site.
See the Field Index to learn which calls use ItemID.

VariationSKU ( string ) [0..1]
Variation-level SKU that uniquely identifies a variation within the listing identified by ItemID. Only applicable when the seller included variation-level SKU (Variation.SKU) values. Retrieves all the usual listing fields, but limits the variations content to the specified variation. If not specified, the response includes all variations.
See the Field Index to learn which calls use VariationSKU.

VariationSpecifics ( NameValueListArrayType ) [0..1]
Name-value pairs that identify one or more variations within the listing identified by ItemID. Only applicable when the seller listed the item with variations. Retrieves all the usual Item fields, but limits the Variations content to the specified variation(s). If the specified pairs do not match any variation, eBay returns all variations.

To retrieve only one variation, specify the full set of name/value pairs that match all the name-value pairs of one variation.

To retrieve multiple variations (using a wildcard), specify one or more name/value pairs that partially match the desired variations. For example, if the listing contains variations for shirts in different colors and sizes, specify Color as Red (and no other name/value pairs) to retrieve all the red shirts in all sizes (but no other colors).
See the Field Index to learn which calls use VariationSpecifics.