Search APIs

Generally Available in Liferay DXP 2025.Q4+/Portal 2026.Q1+

You can search with headless APIs using the endpoints at /o/search. These are the primary endpoints:

Use the GET /search endpoint to perform an empty or keyword search, using query parameters to shape the search request. Facets cannot be retrieved. This endpoint is intended for collecting data for display in the user interface.
Use the POST /search endpoint to perform an empty or keyword search, including facets. You can shape the request details with query parameters and the JSON request body. This endpoint is best suited for mimicking search page behavior (e.g., when creating a custom search page).

See Search API Basics for more information.

In addition, the /suggestions endpoint powers Liferay’s Search Bar Suggestions. See Suggestions API for more information.