Domains

Hawksearch has three environments available: Development, Test and a load-balanced Production.  When using the search API methods in this document, the following domains can be used to access each environment after your engine has been set-up in that environment.

Development

https://indexing-dev.hawksearch.net/

Configurations for an engine in this location are maintained in the Hawksearch Workbench at dev.hawksearch.net.

Test

https://indexing-test.hawksearch.net/

Configurations for an engine in this location are maintained in the Hawksearch Workbench at test.hawksearch.net.

Production

https://indexingapi-na.hawksearch.com/

Configurations for an engine in this location are maintained in the Hawksearch Workbench at https://dashboard-na.hawksearch.com/

Indexing API Methods

Create

This method creates a new index in Hawksearch.  The new index will be empty.  Other methods must be used to populate the index. The methods, IndexItems and DeleteIndexItems are used to add, update and delete items in an index.  The index will not be set to be active until the Set-Current method is called, passing the name of the index.  Each client engine can have multiple indexes, but only 1 current index at a time.

Request

Response

Delete Index Item

This method delete the single item from existing index in Hawksearch.  

Request

Response

Delete Index Items

This method deletes multiple items from existing index in Hawksearch.  

Request

Response

Delete Index

This method delete an existing index in Hawksearch.  

Request

Response

Get All Indexes

This method will return all of the indexes that exist for the engine.  

Request

Response

Get Current Index Name

This method will return the name of the index that is currently being used for search. If there is no “current index,” an error will be returned.

Request

Response

Index Items

This method adds and updates items and their attributes to a specified index. Attributes must be defined in the Hawksearch Workbench Fields list in order for the attributes to be stored for an object. Once an item is indexed with this method, it will immediately be available in search results, if the modified index is queried.

If an item is sent with a key that matches an existing item, that item will be updated with the attributes being sent. If an item is sent with a new key, that item will be added to the index.

Request

Response

Update Items

This method updates items and their attributes to a specified index. Attributes must be defined in the Hawksearch Workbench Fields list in order for the attributes to be stored for an object. Once an item is updated with this method, it will immediately be available in search results, if the modified index is queried.

If an item is sent with a key that matches an existing item, that item will be updated with the attributes being sent. If an item is sent with a new key, that item will be added to the index. The item will be updated with the attributes being sent. Note that in this method, you can send only those attributes in the request which are required to be updated along with the Primary key and skip the ones which do not require any changes. 

Request

Response

Set Current Index

Sets a specified index as the current index.  This will be the index that will be used when calling Hawksearch search methods (documented in a separate document).

Request

Response

Rebuild All

Rebuilds autocomplete, percolator, learning search and related searches.  

Request

Response

Rebuild Autocomplete

Rebuilds Autocomplete Categories & Autocomplete Popular Items.  This method is called as part of Rebuild-All.  It is not required that this method be called separately.

Request

Response

Rebuild Percolator

Rebuilds Percolator (boost rules & visitor target rules) for Hawksearch.  This method is called as part of Rebuild-All.  It is not required that this method be called separately.

Request

Response

Rebuild Learning Search

Rebuilds Learning Search & Learning Search By Visitor.  This method is called as part of Rebuild-All.  It is not required that this method be called separately.

Request

Response

Rebuild Related

Rebuilds Related Searches.  This method is called as part of Rebuild-All.  It is not required that this method be called separately.

Request

Response

FAQs

Hawksearch v4.0 - Indexing API - What are the basic steps to getting an index up?

Open

Create Fields

1. Establish what fields/attributes need to be in Hawksearch. Consider what needs to be searched, what needs to be displayed on the search results page and what might be needed to use for merchandising. Some examples of fields that could be needed for merchandising: a rating field to sort by top rated; a sales margin to use for featured products.

2. Create fields in Hawksearch workbench for each field/attribute that will be sent to Hawksearch. Alternatively, these fields can be created using the REST API.

(Optional) Create Facets

1. Once the fields are created in Hawksearch, Facets can then be created. This step is optional in the sense that it is not required to be done at this time, and can be completed after the data has been initially indexed, but Facets should be created at some point to make for a richer search results page, that is also easier to navigate. 

2. Consider the expectations of your users and what navigation choices they would expect to have available, and consider what fields of data are available for facet use. 

3. Facets can be created from the Hawksearch workbench, or through the REST API. 

(Optional) Remove old index

1. If applicable, delete inactive index using the delete API call

Create Index

1. Use the 'Create' call documented above to create the empty index. 

2. NOTE: You are limited to a total of two indexes. If you already have two indexes created, you will need to first delete one before you can create a new index. Please see the 'Delete' call documented above for instructions on how to perform this action. 

(Optional) Build Hierarchy

1. Use the upsert call to add/update new hierarchies (ref Hierarchy API) to add your hierarchical data for nested facets.

2. Build the hierarchical data model using the build call.

Index Items

1. Use the Index-Items call to import data into the Index.

(Optional) Set Current Index

1. You can choose to set the current index using the relevant call, but it is not required. You can submit the index you would like to search against as part of the search call. However, if you do set the current index - that information does not need to be included in the search call. 

Rebuild All

1. This final step rebuilds several Hawksearch functions - the autocomplete, percolator, learning search and related searches. 

Method Calls Overview

1. Delete (for older index)

2. Create (the new index)

3. Upsert and Rebuild (the hierarchy)

4. Index-Items (your products)

5. Set-Current (the latest index)

6. Rebuild-All (on the latest index)

More info - Full v/s Partial Indexing - Hawksearch Knowledge Base - Confluence (atlassian.net)

Why do I have to send the index name in every request if I am sending the key?

You will have the flexibility to have multiple indexes stored in Hawksearch. The index name is required to indicate on which index the action should be taken.