Implement Related Search

Once your company enables Related Search, Constructor generates related search terms using historical clickstream data and previous searches in one (1) business day.

Constructor's Search API will then return related search terms as part of the API response using this format:

"related_searches": [
      {
        "query": "string"
      }
    ]

Your team will be responsible for parsing the API response and deciding how related search terms will appear on a search results page.

Configuration options for Related Search

  • Methods for related search term generation
    • As mentioned in the Related Search overview, Constructor uses four distinct generation methods, or algorithms, to identify related search terms for a query. If desired, one or more of these algorithms can be turned off. However, we recommend that all four methods remain active to ensure relevant coverage.
  • Number of returned or displayed terms
    • By default, eight (8) related search terms are returned for a search query when all generation methods are enabled. Less popular queries might see fewer results returned due to insufficient clickstream data. You can adjust the number of returned terms with our team or slice the array to show your desired number (i.e., slice the array to show the first 4 of the returned 8 terms).

Recommended practices for displaying related search terms

Popular options include displaying related search terms beneath the search bar or alongside the search results.

We recommend displaying terms as actionable buttons to encourage users to consider and engage with them. These buttons can even change color when the user hovers over them:

Related searches appear as a clickable button that changes color when hovered.

Related search terms appear as clickable buttons that change color when hovered.

A similar experience can be extended to the mobile experience but could use a horizontal scroll for the terms since there would be limited room to display more than a few terms at a time:

On a mobile device, related search terms appear as tappable buttons.

On a mobile device, related search terms appear as tappable buttons.

Other options include having related terms appear as links:

Related search terms appear as hyperlinks beneath the search field or total search results count.

Related search terms appear as hyperlinks beneath the search field or total search results count.

It is also good practice to include related search terms at the top of a page and in the footer. This is useful to users who scroll the first page of results without seeing exactly what theyā€™re looking for. You are now giving them additional search options. We recommend keeping the design of the footer terms identical to the terms displayed at the top of the page:

Related search terms appear as clickable boxes at the bottom of a search results page.

Related search terms appear as clickable boxes at the bottom of a search results page.