Create Interaction

POST

features

interactions

object

feature_id

string

interaction_type

enum<string>

search_request

object

queries

array

queries

Required

array

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.

Add Example Value

collection_ids

array

filters

object

case_sensitive

boolean

AND

array

NOR

array

group_by

object

field

string

field

string

    Field to group by
    
    Note: We currently do not support ad-hoc grouping.
    This means the field must be indexed separately. 
    Please contact us to add additional fields for grouping.

Add Example Value

max_features

integer

sort

object

field

string

direction

enum<string>

sort

object

field

string

direction

enum<string>

select

array

ranking_options

object

weights

object

weights

object

    Weights to blend different ranking signals. Must sum to 1.0.
    - feedback: Weight for feedback-based score (positive, negative)
    - popularity: Weight for user interaction signals (clicks, views)

Add Example Value

enable_reranking

boolean

enable_reranking

boolean

    Enable interaction-based score adjustments.
    When enabled, historical interactions will influence ranking:
    - Positive feedback and clicks boost scores
    - Negative feedback reduces scores
    - View duration and skip signals are considered
    - Adjustments are weighted by recency

Add Example Value

session_id

string

return_url

boolean

position

integer

metadata

object

session_id

string

Headers

Authorization

string | null

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'

X-Namespace

string | null

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

Body

application/json

feature_id

string

required

ID of the item that was interacted with

interaction_type

enum<string>

required

Type of interaction or feedback

Available options:

view,

click,

positive_feedback,

negative_feedback

search_request

object | null

The search request that led to this interaction

position

integer | null

Position in search results where interaction occurred

metadata

object | null

Additional context about the interaction

session_id

string | null

Search session identifier

Response

200 - application/json

feature_id

string

required

ID of the item that was interacted with

interaction_type

enum<string>

required

Type of interaction or feedback

Available options:

view,

click,

positive_feedback,

negative_feedback

interaction_id

string

required

Unique identifier for this interaction

search_request

object | null

The search request that led to this interaction

position

integer | null

Position in search results where interaction occurred

metadata

object | null

Additional context about the interaction

session_id

string | null

Search session identifier

Was this page helpful?

List Interactions Get Interaction

API Documentation

Health

Multimodal Search

Multimodal Index

Features

Namespaces

Search Interactions

Entities

Assets

Accounts

Collections

Tasks

Create Interaction

Headers

Body

Response