MultiSearch APIs

The multiSearch API endpoints allow users to send multiple searchSingleBest queries at one time, using a JSON array. Parameter names can be followed by a dash ("-") to indicate an optional parameter. The default maximum number of different JSONs that can be sent is 50. When the configured limit is exceeded, the user will receive an HTTP 400 status code and the response as shown in the example.

Example Response Exceeds Maximum

Max request limit exceeded. Requests Sent:51 Limit:50

Results are returned as a JSON array. The order of the items returned in the response corresponds to the order of the items in the original request. Requests with no matches will return "No matches found" in the response. Requests with more than one match will return the property "error" with the value "Search returned more than one result."

Example No Match/Multiple Results Response

[
    {
        "error": "No matches found."
    },
    {
        "error": "No matches found."
    },
    {
        "error": "Search returned more than one result."
    }
]