v5
OpenAPI 3.1.02026-08-025631,1012.8 MBAnalytics
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
Example response
[
{
"signal_type": "cache_hit"
}
]