eBay Trading APIVersion 1003

MetadataType

This type is used by the Metadata container to provide price guidance information, which includes the minimum and maximum recommended prices for the item, which are based on recent sales of similar items.

Type that uses MetadataType:

Calls that use MetadataType:

Fields

Name ( string ) [0..1]
The name of the price guidance parameter is returned in this field. Any of the following price guidance parameters may be returned in a Metadata container:
  • AppliesTo: this parameter indicates the type of listing that the MaxRecommendedValue and MinRecommendedValue values pertain to. The corresponding value values that can be returned with the AppliesTo parameter is 'Auction' and 'FixedPrice'.
  • Currency: this parameter indicates the type of currency being used for the MaxRecommendedValue and MinRecommendedValue values. The currency values (returned in corresponding value field) are based on the currency codes defined in the ISO 4217 - Currency Codes standard.
  • MaxRecommendedValue: this parameter indicates the upper end of the recommended price range for the item. Based on the recent sales of similar items, eBay recommends a price range through the MaxRecommendedValue and MinRecommendedValue parameters. A dollar value is returned in the corresponding value field.
  • MinRecommendedValue: this parameter indicates the lower end of the recommended price range for the item. Based on the recent sales of similar items, eBay recommends a price range through the MaxRecommendedValue and MinRecommendedValue parameters. A dollar value is returned in the corresponding value field.
  • SimilarItems: this parameter and its corresponding value values indicates which eBay item listings were used to determine the MinRecommendedValue and MaxRecommendedValue values. The values returned in the value fields are Item IDs.
See the Field Index to learn which calls use Name.

Value ( string ) [0..*]
The corresponding value(s) for the price guidance parameter (returned in Name field of the same Metadata container. For the AppliesTo parameter, this value will either be 'Auction' or 'FixedPrice'. For the Currency parameter, this value will be a three-digit representation of a currency (as defined in the ISO 4217 - Currency Codes standard). For the MaxRecommendedValue and MinRecommendedValue parameters, this value will be a dollar value. For the SimilarItems parameters, this value will be an Item ID value, and it's possible that numerous Item IDs will be returned.
See the Field Index to learn which calls use Value.