v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB

Analytics

Analytics - Retrievers

Get Retriever Performance

Get retriever performance metrics for tuning.

Retrieves time-series performance data including:

Query latency (P50, P95, P99)
Query counts
Result counts
Latency trends

Use Cases:

Monitor retriever performance over time
Identify performance degradations
Compare performance across time periods
Establish performance baselines

Example:

curl -X GET "https://api.mixpeek.com/v1/analytics/retrievers/ret_abc123/performance?hours=24&group_by=hour" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Namespace: your-namespace"

get/v1/analytics/retrievers/{retriever_id}/performance

Path parameters

retriever_idstring required

Query parameters

start_datestring date-time nullable

Start date (UTC)

end_datestring date-time nullable

End date (UTC)

group_bystring

Time grouping: hour, day, week

Response

Successful Response

retriever_idstring required

Retriever identifier

metricsobject[] required

Time-series performance metrics

summaryobject nullable

Aggregated summary statistics

Example response

{
  "metrics": [
    {
      "avg_latency_ms": 145.3,
      "avg_results": 10.5,
      "p95_latency_ms": 287.5,
      "p99_latency_ms": 456.2,
      "query_count": 245,
      "time_bucket": "2025-10-28T00:00:00Z"
    }
  ],
  "retriever_id": "ret_abc123",
  "summary": {
    "avg_latency_ms": 152.8,
    "p95_latency_ms": 295.2,
    "p99_latency_ms": 502.1,
    "total_queries": 5234
  },
  "time_range": {
    "end": "2025-10-29T00:00:00Z",
    "start": "2025-10-28T00:00:00Z"
  }
}