v5

OpenAPI 3.1.02026-08-025631,1012.8 MB
Analytics
Analytics - Retrievers

Get Retriever Signals

Get retriever signals for interaction tuning.

Retrieves fine-grained signals about retriever behavior:

  • Cache hits/misses
  • Reranking scores
  • Filter effectiveness
  • Query expansion results

Signal Types:

  • cache_hit: Successful cache lookups
  • cache_miss: Cache misses requiring full search
  • rerank_scores: Reranking effectiveness metrics
  • filter_reduction: Pre-filter document reduction
  • expansion_results: Query expansion impact

Use Cases:

  • Fine-tune retrieval parameters
  • Analyze query patterns
  • Optimize cache strategies
  • Validate optimization improvements

Example:

curl -X GET "https://api.mixpeek.com/v1/analytics/retrievers/ret_abc123/signals?signal_type=rerank_scores&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Namespace: your-namespace"
get/v1/analytics/retrievers/{retriever_id}/signals

Path parameters

retriever_idstring required

Query parameters

signal_typestring nullable

Filter by signal type (cache_hit, rerank_scores, etc.)

Filter by signal type (cache_hit, rerank_scores, etc.)

limitinteger

Maximum results

Maximum results

hoursinteger

Hours of history

Hours of history

Response

Successful Response

timestampstring date-time required

Event timestamp

execution_idstring required

Execution identifier

signal_typestring required

Type of signal

signal_dataobject required

Signal-specific data

metadataobject nullable

Additional metadata

Example response

[
  {
    "signal_type": "cache_hit"
  }
]