Documentation
- Introduction
- Full-Text Search
- Semantic Ranking
- Semantic Search
- Entity Extraction
- Summarization
- Clustering
- Data Preparation
- Create an Index
- Generate API Keys
- Working with No-Code Search UI
- Credentials
- Autocomplete
- Search
- Recommend
- View API Usage
- Add Records
- (Re)generate API Keys
- Search UI
- Update Information
- View Indexing Logs
- Delete Index
- Site Crawler
- Convert CSV to JSON
- View API Usage
- Add API Credits and Storage
- View Purchase History
- Delete Account
Features
Getting Started
Developer API
Index
Tools
Account
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.
Features
Full-Text Search
When looking for a word or topic, you can quickly use a sequential search to find it within a single document. However, it would take hours to search it in a large corpus.
Full-text search engines speed up searching by breaking this process into two phases: indexing and searching. Indexing involves reading, processing, and listing search terms. Search engines can now look up the index and then rank the documents. There are many ways of ranking search results, including search term frequency, term distance, or a pre-defined custom formula.
Full-text search is a common and robust approach. The user is presumed to be looking for a specific set of documents.
In edge cases, the user may have to go through several searches and documents. These edges cases get amplified on websites providing e-commerce and similar services. Users are likely to drop off within a few unsuccessful queries resulting in lost sales.
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.
Semantic Search
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.
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
Params
Request URL Structure
Response
Response JSON Structure
{ "suggestions": [ { "suggest": "...", "displaySuggest": "<b>....</b> ..." }, { "suggest": "...", "displaySuggest": "<b>....</b> ..." } ], "relatedItems": [ "...", "..." ], "records": [ { "recordId": "##", "title....": "......", "link.....": "......", "image......": "......" }, { "....": "......", ".....": "......", "......": "......" } ], "error": "....." }
Search
Search function integrates full-text search with semantic ranking to provide better search results based on context or user preferences. Semantic ranking personalizes full-text search results for products based on user browsing or purchase history. It includes support for double-quoted phrases for specificity and AND/OR/NOT operators for filtering.
Request URL
https://www.seqwa.com/api/v1/search
Method
GET
Headers
Params
Request URL Structure
Response
Response JSON Structure
{ "searchResults": [ { "recordId": "##", "summary": "...", "displaySummary": "<b>....</b> ...", "field1": ".....", "field2": ".....", "field3": "....." }, { "recordId": "##", "summary": "...", "displaySummary": "<b>....</b> ...", "field1": ".....", "field2": ".....", "field3": "....." } ], "topTags": [ "...", "..." ], "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
Params
Either recordId or idField & idValue or context is required.
Request URL Structure
Response
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.