GetDealsRequest ( BaseMerchandisingServiceRequest )

Retrieves data for top 20 "best deal" items on eBay that match a simple keyword query. Items that provide the best value to buyers, such as items that are on sale or items with free shipping) are considered best deals. The query searches item titles only, and results, if any, must match all terms specified in the required keywords field. Items in the results are sorted by Best Match, which is based on community buying activity and other relevance- based factors.

Important: The getDeals call is not returning any item recommendations. Refer to the getDeals call not returning results thread in the eBay Shopping and Merchandising API Production System Announcements board for more information, including an ETA for when this problem will be resolved.

No calls use GetDealsRequest.

Field

keywords ( string ) [1]

Not used by any call.

A query string for searching titles of items on eBay. The query is limited to a maximum of 7 space-delimited terms. Any additional terms will be ignored. Results must match all terms in the query.

The keywords field does not support wildcards, such as asterisks ("*") or question marks ("?"), or Boolean search operators, such as "AND" (or the plus sign "+"), "OR," or "NOT" (or the minus sign "-"). Search wildcard or operator characters (e.g., "*" or "+") will be ignored. The words "and" and "or" and "not" are treated like any other word, and should be used only if you are searching for listings containing these words.

Note: If you are using an HTTP GET (i.e., URL) request, use "%20" to delimit terms specified in keywords. For example, use Harry%20Potter to search for items containing those words in any order.

See the Field Index to learn which calls use keywords.