SearchApi.md

Manticoresearch.SearchApi

All URIs are relative to http://127.0.0.1:9308

Method	HTTP request	Description
search	POST /search	Performs a search on an index.
percolate	POST /pq/{index}/search	Perform a reverse search on a percolate index

search

SearchResponse search(searchRequest)

Performs a search on an index.

The method expects a SearchRequest object with the following mandatory properties:

• the name of the index to search | string

For details, see the documentation on SearchRequest

The method returns an object with the following properties:

• hits: an object with the following properties:
  • hits: an array of hit objects, where each hit object represents a matched document. Each hit object has the following properties:
    • _id: the ID of the matched document.
    • _score: the score of the matched document.
    • _source: the source data of the matched document.
  • total: the total number of hits found.
• timed_out: a boolean indicating whether the query timed out.
• took: the time taken to execute the search query.

In addition, if profiling is enabled, the response will include an additional array with profiling information attached.

Here is an example search response:

{
  "hits":
  {
    "hits":
    [
      {
        "_id":"1",
        "_score":1,
        "_source":{"title":"first find me fast","gid":11}
      },
      {
        "_id":"2",
        "_score":1,
        "_source":{"title":"second find me fast","gid":12}
      }
    ],
    "total":2
  },
  "profile":None,
  "timed_out":False,
  "took":0
}

For more information about the match query syntax and additional parameters that can be added to request and response, please check: https://manual.manticoresearch.com/Searching/Full_text_matching/Basic_usage#HTTP-JSON.

Example

var Manticoresearch = require('manticoresearch');
var client = new Manticoresearch.ApiClient();
client.basePath="http://localhost:9308";
var searchApi = new Manticoresearch.SearchApi(client);

// Create SearchRequest
var searchRequest = new Manticoresearch.SearchRequest();
searchRequest.index = "test";
searchRequest.fulltext_filter = new Manticoresearch.QueryFilter('Star Trek 2');

// or create SearchRequest in an alternative way as in the previous versions of the client. It uses a single complex JSON object for a query field
searchRequest = {"index":"test","query":{"query_string":"find smth"}};

// Perform a search
(async function searchExample() {
    var res = await searchApi.search(searchRequest);
    console.log(JSON.stringify(res, null, 4));
})();

Parameters

Name	Type	Description	Notes
searchRequest	SearchRequest

Return type

SearchResponse

Authorization

No authorization required

HTTP request headers

• Content-Type: application/json
• Accept: application/json

percolate

SearchResponse percolate(index, percolateRequest)

Performs a reverse search on a percolate index. [More info on percolate indexes in Manticore Search Manual]

This method must be used only on percolate indexes.

Expects two parameters: the index name and an object with a document or an array of documents to search by. Here is an example of the object with a single document:

{
  "query":
  {
    "percolate":
    {
      "document":
      {
        "content":"sample content"
      }
    }
  }
}

Responds with an object with matched stored queries:

{
  "took":0,
  "timed_out":false,
  "hits":
  {
    "total":1,
    "hits":
    [
      {
        "_index":"products",
        "_type":"doc",
        "_id":"2811045522851233808",
        "_score":"1",
        "_source":
        {
          "query":
          {
            "ql":"@title bag"
          }
        },
        "fields":{"_percolator_document_slot":[1]}
      }
    ]
  }
}

And here is an example of the object with multiple documents:

{
  "query":
  {
    "percolate":
    {
      "documents": [
        {
          "content":"sample content"
        },
        {
          "content":"another sample content"
        }
      ]
    }
  }
}

Example

var Manticoresearch = require('manticoresearch');

var searchApi = new Manticoresearch.SearchApi();
(async function percolateExample() {
    res = await searchApi.percolate('products',{"query":{"percolate":{"document":{"title":"What a nice bag"}}}});
})();

Parameters

Name	Type	Description	Notes
index	String	Name of the percolate index
percolateRequest	PercolateRequest

Return type

SearchResponse

Authorization

No authorization required

HTTP request headers

• Content-Type: application/json
• Accept: application/json