This query returns eBay listings matching a keyword search, optionally narrowed by category, a price ceiling, item condition, and buying option.
Developer info
API endpoint slug
ebay.search_listings
Runtime method
performQuery("ebay.search_listings"}
Query fields
Keywords Text input > Other
Label
Keywords
Helper text
The words to search for in eBay listing titles.
Slug
keywords
Required
true
Can have default value
true
Category Text input > Other
Label
Category
Helper text
Optional. The eBay category ID to search within, from a listing's category breadcrumb. Leave blank for all categories. Use a specific leaf category: a top-level category ID silently turns off the Buying option filter.
Slug
category
Required
false
Can have default value
true
Maximum price Text input > Other
Label
Maximum price
Helper text
The most you want to pay, in US dollars. For an auction this compares the current bid, which can rise after the search runs.
Slug
maximum_price
Required
false
Can have default value
true
Condition Dropdown list
Label
Condition
Helper text
Optionally, limit results to a specific condition. Leave blank to search all conditions.
Slug
condition
Required
false
Can have default value
true
Buying option Dropdown list
Label
Buying option
Helper text
Which eBay buying formats to include. eBay only returns fixed-price (Buy It Now) listings unless you choose 'All formats' or a specific other format here -- auctions are excluded by default.
Slug
buying_option
Required
true
Can have default value
true
Ingredients
Title
The listing's title; present on every returned listing.
Slug
title
Filter code
Ebay.searchListings.Title
Type
String
Example
Vintage Levi's 501 Jeans
Price
The listing's price as a numeric value formatted as a string; not present on some listings, such as an auction with no current bid.
Slug
price
Filter code
Ebay.searchListings.Price
Type
String
Example
45.00
Currency
The three-letter ISO 4217 currency code for Price; present only when Price is present.
Slug
currency
Filter code
Ebay.searchListings.Currency
Type
String
Example
USD
Condition
The listing's condition, in eBay's own coarse vocabulary (for example, New or Used); not present on every listing.
Slug
condition
Filter code
Ebay.searchListings.Condition
Type
String
Example
Used
Listing url
A link to the listing on eBay; not present on every listing.
Slug
listing_url
Filter code
Ebay.searchListings.ListingUrl
Type
Web URL
Example
https://www.ebay.com/itm/example-listing
Image url
A link to the listing's primary photo; not every listing has an image.
Slug
image_url
Filter code
Ebay.searchListings.ImageUrl
Type
Image URL
Example
https://i.ebayimg.com/example.jpg
Listed at
The date and time the listing was first made available, retained across a relist; not present on every listing.
eBay
This query returns eBay listings matching a keyword search, optionally narrowed by category, a price ceiling, item condition, and buying option.