Suggestions grouped

Instance specific key.

Search term entered by the user.

Maximum length: 100

The category that should contain the filtered results. If you want to provide the entire path, you should include the categories divided by a hyphen (-).

Example: ?tn_cid=100-150

Specify the language to use for the search algorithms.

All available languages can be retrieved with the catalog call: /catalog/languages/{instancekey}

Example: ?tn_lang=nl

Whether or not navigation urls returned in the response use the tn_filters parameter (?tn_filters=brand%3DCoca%20Cola%26volume%3D1L, instead of ?tn_fk_brand=Coca%20Cola&tn_fk_volume=1L).

Example: ?tn_use_filters=true

Hidden parameters can be added to the URL by using the parameter 'tn_parameters'. The key is the facet URL-name. The value is the facet value that should be applied.

Important: double URL-encoding is required.

1. Build the parameter string — combining keys and values:

   • encode special characters inside values (spaces, +, &, =, etc.)
   • concatenate multiple values using a pipe (|) example: brand=Coca%20Cola%7CPepsi&volume=1L%7C1.5L

2. URL-encode the entire filter string — because the whole string is passed as a single query parameter value, encode it a second time:

   brand%3DCoca%2520Cola%257CPepsi%26volume%3D1L%257C1.5L

3. Append to the URL:

   ?tn_parameters=brand%3DCoca%2520Cola%257CPepsi%26volume%3D1L%257C1.5L

Hidden exclusion parameters can be added to the URL by using the parameter 'tn_parameters_except'. This is used to exclude certain parameters from the results (show everything except specified parameters). The key is the facet URL-name. The value is the facet value that should be applied.

Important: double URL-encoding is required.

1. Build the parameter string — combining keys and values:

   • encode special characters inside values (spaces, +, &, =, etc.)
   • concatenate multiple values using a pipe (|) example: brand=Coca%20Cola%7CPepsi&volume=1L%7C1.5L

2. URL-encode the entire filter string — because the whole string is passed as a single query parameter value, encode it a second time:

   brand%3DCoca%2520Cola%257CPepsi%26volume%3D1L%257C1.5L

3. Append to the URL:

   ?tn_parameters_except=brand%3DCoca%2520Cola%257CPepsi%26volume%3D1L%257C1.5L

Specify the keyboard to use for the search algorithms.

All available options are: 'qwerty', 'azerty' or 'qwertz'

Example: ?tn_keyboard=azerty

The source of the request. See the article on the request source for more information.