Retrievers

Typeahead

Changed on

Prefix suggestions for a search box (autocomplete/typeahead).

Suggests from three namespace-scoped sources concurrently: values of the requested metadata fields (index-backed, with per-value document counts), collection names, and the caller's own recent search queries. A source that cannot answer is dropped and named in warnings rather than failing the request.

get/v1/retrievers/typeahead

Request

  • Base URL: https://api.mixpeek.com
  • URL: https://api.mixpeek.com/v1/retrievers/typeahead
  • Auth: HTTP bearer and API key in header X-Namespace

Query parameters

qstring required

The typed prefix.

fieldsstring nullable

Comma-separated metadata field paths to suggest values from (e.g. metadata.talent,metadata.production). Each field should carry a keyword index; at most 5 are consulted. Omit to skip the field-value source.

limitinteger

Max suggestions per source.

Response

Successful Response

querystring required

The prefix that was matched.

suggestionsstring[]

Flat ranked suggestion texts across all sources.

recent_searchesstring[]

The caller's own recent queries matching the prefix, newest first.

warningsstring[]

Sources that could not be consulted this request.

Changes

  • 61a175e8eb9aRevision changes
    • warning

      removed the optional property from the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • 5307993e44d3Revision changes
    • info

      endpoint added