Search Features

Bearer token authentication using your API key. Format: 'Bearer your_api_key'. To get an API key, create an account at mixpeek.com/start and generate a key in your account settings. Example: 'Bearer sk_1234567890abcdef'

Optional namespace for data isolation. Example: 'netflix_prod' or 'spotify_recs_dev'. To create a namespace, use the /namespaces endpoint.

The position to start returning results from. Used for pagination. Does not work with group_by

Number of results to return per page.

List of search queries to perform.

    Behavior:
    - Single query: Results are returned directly from that query
    - Multiple queries: Results are combined using Reciprocal Rank Fusion (RRF)
    
    RRF combines results from multiple queries by:
    1. Taking each item's rank position in each result list
    2. Re-ranking all items by their combined RRF scores
    
    When merging lists from different sources, 
    RRF considers all items that appear in any of the input lists, 
    not just items that appear in all lists.
    
    This helps surface items that rank well across multiple queries while
    reducing the impact of outlier high rankings in single queries.
    
    NOTE: If query array is empty, it will return all features.
    
    

List of Collection IDs to search within, required

Used for filtering across all indexes

Grouping options for search results

List of fields to sort by, with direction (asc or desc). Supports dot notation for nested fields.

List of fields to return in results, supports dot notation. If None, all fields are returned.

Options for ranking the search results, including weights and feedback application

Identifier for tracking search session interactions

Return the presigned URL for the asset and preview asset, this will introduce additional latency