Seqwa

Introduction

Businesses lose 80% of online sales due to sub-standard search functionality. Customers want speed, accuracy, and relevance. They expect to get to the right product within five to ten keystrokes.

Seqwa is a low-cost, easy-to-use hosted search platform for solving your critical search requirements. It supports three uniquely beneficial functions: Autocomplete (query suggestions and top full-text search results), Search (Full-text Search with semantic ranking for intent), and Semantic Search (Intent-driven search). Work with one or all the functions based on your needs.

Set up a functional search utility in minutes: upload your data, generate API keys, publish a demo user interface, and search!

Enjoy a seamless search experience supported by a highly available and scalable cloud infrastructure.

Semantic Ranking

Ranking search results semantically helps better serve users. This approach ranks the results based on the user's intent. You can understand user intent from the search query, previous search queries, user provided-context, user preferences, or demographic profile.

For instance, when two users search for the term: ball, they will get different top results if one is a soccer fan and the other is a tennis fan.

Entity Extraction

Finding documents based purely on intent can help discover documents that do not appear in full-text search results but are relevant to the user. Imagine showing product recommendations to users based on viewing and search history or displaying similar products while viewing a product page.

While working on a written document, you can provide semantic search assistance to the user based on the context of the document. For instance, a journalist writing a story on unethical behavior in a specific sport can search relevant news stories that cover either similar reports in the same sport or similar behavior in other sports.

Summarization

There are primarily two types of summarization: extractive and abstractive. Both approaches yield summaries that any average reader could make sense of the contents of a large document. Extractive summarization picks the document's key components that effectively explain the whole text. The abstractive approach involves writing a summary with words not part of the original text but similar to a human-written summary.

Clustering

Clustering means grouping similar documents. It helps recommend similar products and topics. Measuring the similarity of a document to others can help identify the semantically nearest ones. This approach requires natural language processing and natural language understanding.

Getting Started

Data Preparation

JSON – JavaScript Object Notation – is a format for data interchange and currently the only accepted format.

Follow these steps to prepare your data:

  • Prepare your data in a spreadsheet
  • Add columns for title, description, pricing, link to the product page, an image link, and any other required field.
  • Create rows for each product or document
  • Save the spreadsheet as a CSV file
  • Search on Google with the query Convert CSV to JSON
  • Pick an online tool to convert your CSV file to JSON format

JSON structure

[
  {
    "field1": ".....",
    "field2": ".....",
    "field3": ".....",
    ".....": "......"
  },
  {
    "field1": ".....",
    "field2": ".....",
    "field3": ".....",
    ".....": "......"
  }
]

You can add new records through the Add Records  utility.

Create An Index

  • Sign up (or Sign In if you have already signed up)
  • On the App homepage, you will see the Index Catalog with a Create Index button
  • Click the Create Index button
  • On the Create Index page,
    • Choose a JSON file to upload
    • Enter a title
    • Add a description
    • Click Create New Index  button when it is active
  • You will be redirected to the Indexing Logs page. 
  • The indexing process may take several minutes or more depending on the number of records in the uploaded file.
  • You can stay on the Indexing Logs page or come back to check the progress.
  • On completion, you MUST generate API Keys to search the index and optional create a Demo Search UI.

Generate API Keys

You can generate API keys after the indexing process is complete and the status is ACTIVE. To create API Keys:

  • Navigate to the Index Catalog page
  • Select the Index
  • On the Index page, click on API Keys
  • Click on the Generate button to generate keys
  • You will see API keys assigned to the specific functions
  • Copy and save the keys. You can view and regenerate keys at any time.

Working with No-Code Search UI

You create Demo Search UI pages to test and share.

*Sharing the Demo Search page will expose the API keys to everyone with the link to the page.

  • Navigate to the Index Catalog page
  • Select the Index
  • On the Index page, click on Search UI.
  • On the Search UI page, click the Create button. If you have previously created a UI page, you will be able to edit it from the list.
  • Fill up the details in the Search UI Creation Form:
    • Page Title (required)
    • Content Details (required) - Enter the source, copyright and other details about your data.
    • Show Summary (optional) - Select the checkbox if you want to show the summary of the search record that shows the appearance of the keywords in the search query.
    • Semantic Ranking  (optional) - Select the checkbox if you want to semantically rank the full-text search results. Selecting this checkbox opens up a text box where you can enter contextual text for personalization.
    • Highlight Field  (required) - Pick the highlight field from the list of fields in the dataset. This will be used to highlight keywords after the full-text search.
    • Title Field (required) - Pick the title field from the list of fields in the dataset.
    • Page/Document URL (optional) - Pick the field which has the document link
    • Image URL (optional) - In the case of Product layout, pick the field that links to the product image.
    • Functions
      • Search (Selected by default and cannot be changed)
      • Autocomplete (optional) - Selecting Autocomplete function checkbox enables the Autocomplete AND/OR/NOT buttons.
      • Recommend (optional)
    • Visual Settings  (optional) - pick the colors and font for custom look-n-feel
      • Grid Layout
      • Page Background Color
      • Page Font
      • Tag Background Color
      • Tag Title Color
      • Summary Text Color
      • Button Background Color
      • Button Text Color
  • Entering the required fields: Page Title, Highlight field, Content Details and Title field  will activate the demo utility.
  • You can change the look-n-feel and perform all the functions.
  • Click Submit to create the Search UI
  • On successful submission, you will be redirected to the Search UI page, and the newly created page is listed in the pages list.
  • You can edit the page, open it in a new window, copy the URL, or delete it with the Actions dropdown.

Developer API

The Seqwa API is organized around REST. Our API has predictable, resource-oriented URLs, and uses HTTP response codes to indicate API errors. We use built-in HTTP features, like HTTP verbs, which are understood by off-the-shelf HTTP clients. We support cross-origin resource sharing, allowing you to interact securely with our API from a client-side web application (though you should never expose your secret API key in any public website's client-side code). JSON will be returned in all responses from the API, including errors.

Credentials

Before accessing the REST API, you need to note the Index IDand API Keys. You can do with these steps:

  • Navigate to the Index Catalog page
  • Select the Index
  • On the Index page, click on API Keys.
  • Copy the Index ID and the API Keys.

Seqwa offers function-specific API keys so you can choose the function that best suits your needs.

Autocomplete

Autocomplete performs a fundamental and essential to help users complete a search. Autocomplete offers query suggestions, related named entities, and top full-text search results.

Implementing a user interface must include an API call for any change in the query, like adding or removing a character. Having a caching mechanism can considerably reduce the number of API calls.

Request URL

https://www.seqwa.com/api/v1/autocomplete

Method

GET

Headers

Content-Type
application/json
seqwa-api-key
API KEY generated for the Autocomplete Function

Params

index
Index Id
required
query
Query text entered by the user. Supports Lucene query parser syntax which includes AND, OR, and NOT operands, term query like fieldName:fieldValue, and range query like fieldName:[minFieldValue TO maxFieldValue]
required
highlightField
Field for highlighting the query text
optional
fields
Array of fields
optional
maxResults
Maximum results to be returned. (Default: 10, Limit: 25)
optional

Request URL Structure

https://www.seqwa.com/api/v1/autocomplete?index=INDEX_ID&query=QUERY_TEXT&highlightField=SEARCH_FIELD&fields=FIELDS&maxResults=MAX_RESULTS

Response

suggestions
Contains an array of suggestions for queries based on the query text. Each element of the array is an object with  suggest  and displaySuggest  parameters. The suggest param is plain text and displaySuggest has highlighted words with the html <b> element.
relatedItems
Contains an array of top tags from the search results.
records
Top search results based on the search query and upto maximum number of results requested.
error
Returns an error message if any error occurs on the server.

Response JSON Structure

{
  "suggestions": [
    {
      "suggest": "...",
      "displaySuggest": "<b>....</b> ..."
    },
    {
      "suggest": "...",
      "displaySuggest": "<b>....</b> ..."
    }
  ],
  "relatedItems": [
    "...",
    "..."
  ],
  "records": [
    {
      "recordId": "##",
      "title....": "......",
      "link.....": "......",
      "image......": "......"
    },
    {
      "....": "......",
      ".....": "......",
      "......": "......"
    }
  ],
  "error": "....."
}

Recommend

Recommend function searches based on semantic similarity, also called semantic search, including finding similar documents for a given document or recommending documents based on the context. For instance, you can suggest similar products on the current product page or create a list of recommended products based on user browsing or purchase history.

Request URL

https://www.seqwa.com/api/v1/recommend

Method

GET

Headers

Content-Type
application/json
seqwa-api-key
API KEY generated for the Recommend Function

Params

index
Index Id
required
recordId
Autogenerated record Id to find similar records
conditional
context
Contextual text for finding the recommendations.
conditional
idField
Name of the Id field included in the dataset
conditional
idValue
Value of the Id field included in the dataset to find similar records
conditional
fields
Array of fields
optional
maxResults
Maximum results to be returned. (Default: 10, Limit: 25)
optional

Either recordId or idField & idValue  or context is required.

Request URL Structure

https://www.seqwa.com/api/v1/recommend?index=INDEX_ID&recordId=RECORD_ID&context=CONTEXT&idField=ID_FIELD&idValue=ID_VALUE&fields=FIELDS&maxResults=MAX_RESULTS

Response

recommendations
Contains an array of records for queries based on the semantic search query or the selected item. Each element of the array is an object with recordId and requested fields as parameters.
error
Returns an error message if any error occurs on the server.

Response JSON Structure

{
  "recommendations": [
    {
      "recordId": "##",
      "field1": ".....",
      "field2": ".....",
      "field3": "....."
    },
    {
      "recordId": "##",
      "field1": ".....",
      "field2": ".....",
      "field3": "....."
    }
  ],
  "error": "....."
}

Index

You can view information and manage an Index with seven operations: API Usage, API Keys, Search UI, Add Records, Indexing Logs, Update Information, and Delete Index.

View API Usage

View monthly usage of the index with a breakdown for each REST API function.

  • Select the month from the Date Picker field
  • Click the Get button.
  • You will see the API usage for each function for the current index.

Add Records

Add new records to your index.

  • Prepare a JSON data file with the same structure as the one used to create the index.
  • Upload the file with the Choose File field
  • Click the Update Index button to process the upload file
  • You will be forwarded to the Indexing logs page.

(Re)generate API Keys

View, generate, and regenerate API keys for all the functions.

Search UI

Quickly build and manage Search UI with simple custom configuration. You can create a demo Search UI by clicking the Create button. Existing Search UIs are listed with Actions dropdown. You may edit the design, copy the link, open the link in a new window, or delete the UI configuration. *Sharing the Demo Search UI page will expose the API keys to everyone with the link to the page.

Update Information

You can view and update the title and description of the Index.

View Indexing Logs

View the logs to check the progress of the indexing process when you have created a new index or added new records.

Delete Index

Deleting the index will permanently remove all the data and Search UIs associated with the index. This operation is irreversible.

Tools

Site Crawler

Site Crawler scans through a website to extract related links and text.

  • Enter the url for the website you want to crawl.
  • Click the Crawl button to start the process.
  • Download the dataset JSON file after the scanning completes using the Download JSON button.

API Credits are charged for successfully crawled pages. See the Pricing page.

Convert CSV to JSON

Convert CSV to JSON runs through the CSV file and converts the data into the JSON format.

  • Simply select the file using the Choose File button.
  • Download the dataset JSON file using the Download JSON button after the conversion completes.

There are NO charges for using this tool.

Account

View API Usage

View monthly usage of the whole account with a breakdown for each REST API function.

  • Select the month from the Date Picker field
  • Click the Get button.
  • You will see the API usage for each function for your account.

Add API Credits and Storage

You MUST purchase API Credits and Storage Units separately. Please view the Pricing page for details.

View Purchase History

View past purchases made for both API credits and Storage units. You can view the purchase receipts hosted on the Stripe website.

Redeem Code

You can redeem your code acquired from third-party purchases and promotions. To redeem:

  • Enter the redemption code
  • Click Submit
  • If the code was accepted, then you will receive an email notification and web notification.
  • You view the newly added API Credits and Storage Units in the Purchase History and the Account page.

Delete Account

Deleting the account will disable logging into your account and permanently remove all the indexes, data, and Search UIs associated with each index. This operation is irreversible.