Search Suggestions API

DXP 2024.Q3+/Portal GA125+

You can return suggestions with the headless API using the /suggestions endpoint. This endpoint is used by Liferay’s Search Bar Suggestions feature. There are two primary suggestions contributors available: the basic contributor for returning suggestions based on Liferay’s standard indexer based search, and the sxpBlueprint contributor for returning suggestions based on a search blueprint.

Here’s an example search request for the term able, made using cURL:

curl \
	-H "Content-Type: application/json" \
	-X POST \
  "http://localhost:8080/o/portal-search-rest/v1.0/suggestions?currentURL=http://localhost:8080&destinationFriendlyURL=http://localhost:8080/web/guest/search&plid=1&search=able" \
  --data-raw '[ { "attributes": {}, "contributorName": "basic", "displayGroupName": "search", "size": 5 } ]' \
	-u "[e-mail]:learn"

You can configure the service access policy or disable the suggestions endpoint entirely. See Configuring Search Bar Suggestions for more information.

Suggestions Query Parameters

Parameter	Notes
currentURL	(Required) Provide the URL to your Liferay instance.
destinationFriendlyURL	(Required) Set the search page’s friendly URL.
plid	Set the portal layout ID that identifies a page across virtual instances. Usually you can specify 1, the default home page’s plid.
scope	Specify a list of sites (by ID or ERC) to search. You can mix IDs and ERCs in the same request. If not specified, the whole instance is searched (e.g., company scoped objects are searched).
search	(Required) Search by keyword(s).

Suggestions Request Body

Property	Description
attributes	Set available search context attributes to configure a search blueprint or enable empty search. See Available Search Request Attributes for details.
contributorName	Set the contributor that provides the search query (basic or sxpBlueprint).
displayGroupName	Set the language key to use as a heading in the UI.
size	Set the maximum number of results to return from the endpoint.

To search with a blueprint, you can use this request body syntax:

[{
  "attributes": {
    "search.experiences.blueprint.external.reference.code": ""
  },
  "contributorName": "sxpBlueprint",
  "displayGroupName": "suggestions",
  "size": 5
}]

The available suggestions request attributes are for configuring a search blueprint. Always use the sxpBlueprint contributor with these attributes.

Property	Description
DXP Only search.experiences.blueprint.external.reference.code	(Preferred) Set a search blueprint to control the search query and configuration.
DXP Only search.experiences.blueprint.id	Set a search blueprint to control the search query and configuration.
DXP Only search.experiences.ip.address	Set automatically. Only use this to test blueprints with geolocation configured to simulate different locations.
DXP Only search.experiences.scope.group.id	Set this when your blueprint uses an element that requires it: Limit Search to the Current Site, Boost Contents in a Category for a User Segment, or Staging Aware.

Related Topics

• Searching for Content
• Headless Delivery
• Search Bar Suggestions