eBay Finding APIVersion 1.13.0
 

ItemFilter

Reduce the number of items returned by a find request using itemFilters. Use the itemFilter container to specify itemFilter Name/Value pairs. You can include multiple itemFilters in a single request.

Types that use ItemFilter:

Calls that use ItemFilter:

Fields

name ( ItemFilterType ) [1]
Specify the name of the item filter you want to use. The itemFilter name must have a corresponding value. You can apply multiple itemFilter Name/Value pairs in a single request.

Item Filter Names:

  • AvailableTo
  • BestOfferOnly
  • CharityOnly
  • Condition
  • Currency
  • EndTimeFrom
  • EndTimeTo
  • ExcludeAutoPay
  • ExcludeCategory
  • ExcludeSeller
  • ExpeditedShippingType
  • FeedbackScoreMax
  • FeedbackScoreMin
  • FreeShippingOnly
  • HideDuplicateItems
  • ListedIn
  • ListingType
  • LocalPickupOnly
  • LocalSearchOnly
  • LocatedIn
  • LotsOnly
  • MaxBids
  • MaxDistance
  • MaxHandlingTime
  • MaxPrice
  • MaxQuantity
  • MinBids
  • MinPrice
  • MinQuantity
  • ModTimeFrom
  • ReturnsAcceptedOnly
  • Seller
  • SellerBusinessType
  • TopRatedSellerOnly
  • ValueBoxInventory
See the Field Index to learn which calls use name.

paramName ( token ) [0..1]
In addition to filter Name/Value pairs, some itemFilters use an additional parameter Name/Value pair. Specifically, filters that use currency values (MaxPrice and MinPrice) make use of addition parameters. When you use these itemFilters, set paramName to Currency and provide the currency ID in paramValue.

For example, if you use the MaxPrice itemFilter, you will need to specify a parameter Name of Currency with a parameter Value that specifies the type of currency desired.

Note that for MaxPrice and MinPrice itemFilters, the default value for paramName is Currency.
See the Field Index to learn which calls use paramName.

paramValue ( string ) [0..1]
The currency value associated with the respective itemFilter parameter Name.

Usually paramName is set to Currency and paramValue is set to the currency type in which the monetary transaction occurs.

Note that for MaxPrice and MinPrice itemFilters, the default value for paramValue is USD.
See the Field Index to learn which calls use paramValue.

value ( string ) [1..*]
The value associated with the respective item filter name. Allowed values and datatypes vary for a given filter name.
See the Field Index to learn which calls use value.