Get Retriever Signals
Analytics
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 lookupscache_miss: Cache misses requiring full searchrerank_scores: Reranking effectiveness metricsfilter_reduction: Pre-filter document reductionexpansion_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
Get Retriever Signals
Headers
REQUIRED: Bearer token authentication using your API key. Format: 'Bearer sk_xxxxxxxxxxxxx'. You can create API keys in the Mixpeek dashboard under Organization Settings.
REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like 'my-namespace'
Path Parameters
Query Parameters
Filter by signal type (cache_hit, rerank_scores, etc.)
Maximum results
Required range:
x <= 1000Hours of history
Required range:
1 <= x <= 720