Skip to content

Searching with Cloud Indexing

Prerequisites

  • Your catalogue has been successfully indexed into our Cloud Indexing platform using the POST /update endpoint.

  • We assume that a web app is present on the client side. This app communicates with our REST app and serves your website. Other than this, there are no prerequisites for using 904Labs A.I. for Search service.

Workflow

904Labs A.I. for Seach works with multiple consecutive calls from your web app to our REST app. In a common setup, the workflow consists of eight steps.

Workflow

Step Description
Step 1 A visitor searches on your website and sends a text query to your web app.
Step 2 Your web app sends the visitor's text query to our suggest endpoint. See POST /suggest for the request details.
Step 3 Our REST app returns suggestions for the query to to your web app. See POST /suggest for the response details.
Step 4 Your web app shows the suggestions to the visitor. When the visitor selects a suggested query or hits enter to submit her query, the workflow continues. If a category or specific product is selected, the visitor is directed to the appropriate page (see POST /direct-browse for optimizing category pages).
Step 5 Your web app sends the original or suggested text query to our search endpoint. See POST /direct-search for the request details.
Step 6 Our REST app returns a ranked list of items to your web app. See POST /direct-search for the response details.
Step 7 Your web app formats the ranked list and shows the results to the visitor. When the visitor interacts with the results (e.g., clicks, adds-to-basket), the web app records these feedback signals.
Step 8 Your web app sends the feedback signals to our feedback endpoint. See POST /feedback for the request details.

904Labs provides three API endpoints to facilitate the workflow described above:

  • POST /suggest for providing suggestions for queries (typeahead), categories, and products.

  • POST /direct-search for ranking items based on the original or suggested query.

  • POST /feedback for sending visitors' feedback signals (e.g., clicks, add-to-basket).

Notes

  • Steps 2 and 3 are optional. Your web app could also directly send the visitor's text query to the /direct-search endpoint and receive a ranked list of items.
  • There is no need for caching of results. 904Labs A.I. for Search is using sophisticated caching strategies for serving requests as fast as possible. We take away processing load from your search infrastructure and move it to our own servers. This also speeds up response times by minimizing network traffic between your and our servers. Since caching is already in place, we strongly recommend not to use any caching on 904Labs' results at your end. First, it is very difficult to synchronize independent caches. Second, it leads to loosing important feedback from which 904Labs A.I. for Search learns.

More information

For more information or questions, please send an email to support@904labs.com