Query Parameters

# Suggest Search API

This table lists the query parameters supported by the Suggest Search API. Some are required, but most are optional.

Parameter Required Type Default Description
q yes string none The user's suggest search query term. Query can not be empty. The max query length is 400 characters and word limit is 50.
country no string us

The suggest search query country, where potentially the results could come from.

The country string is limited to 2 character country codes of supported countries. This is a just a hint for calculating suggest responses. For a list of supported supported values, see Country Codes.

lang no string en

The suggest search language preference, where potentially the results could come from.

The 2 or more character language code for which the suggest search results are provided. This is a just a hint for calculating suggest responses. For a list of possible values, see Language Codes.

count no int 5 The number of suggestions returned. This is done as best effort. The maximum is 20.
rich no bool 0 Whether to enhance suggestions with rich results. This is an extra option in plans which needs to be enabled.