Skip to main content
GET
/
v1
/
analytics
/
trends
curl "https://api.playgent.com/v1/analytics/trends?agent_id=agent_abc123&period=30d&granularity=day&metrics=pass_rate,avg_faithfulness,avg_latency_ms,total_cost_usd" \
  -H "Authorization: Bearer your-api-key"
{
  "period": { "start": "2024-11-16", "end": "2024-12-16" },
  "data_points": [
    {
      "date": "2024-11-16",
      "runs": 45,
      "pass_rate": 0.78,
      "avg_faithfulness": 0.84,
      "avg_latency_ms": 2450,
      "total_cost_usd": 1.23
    },
    {
      "date": "2024-11-17",
      "runs": 52,
      "pass_rate": 0.81,
      "avg_faithfulness": 0.86,
      "avg_latency_ms": 2380,
      "total_cost_usd": 1.45
    }
  ],
  "summary": {
    "total_runs": 1234,
    "overall_pass_rate": 0.85,
    "trend": "improving",
    "cost_total_usd": 45.67
  }
}

Documentation Index

Fetch the complete documentation index at: https://playgent.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve performance metrics and trends for an agent over a specified time period.
agent_id
string
Filter by agent ID (optional)
period
string
required
Time period (e.g., “7d”, “30d”, “90d”)
granularity
string
Data granularity: hour, day, week (default: day)
metrics
string
Comma-separated metrics to include: pass_rate, avg_faithfulness, avg_relevance, avg_latency_ms, total_cost_usd
period
object
required
Time period
data_points
array
required
Time series data
summary
object
required
Period summary
curl "https://api.playgent.com/v1/analytics/trends?agent_id=agent_abc123&period=30d&granularity=day&metrics=pass_rate,avg_faithfulness,avg_latency_ms,total_cost_usd" \
  -H "Authorization: Bearer your-api-key"
{
  "period": { "start": "2024-11-16", "end": "2024-12-16" },
  "data_points": [
    {
      "date": "2024-11-16",
      "runs": 45,
      "pass_rate": 0.78,
      "avg_faithfulness": 0.84,
      "avg_latency_ms": 2450,
      "total_cost_usd": 1.23
    },
    {
      "date": "2024-11-17",
      "runs": 52,
      "pass_rate": 0.81,
      "avg_faithfulness": 0.86,
      "avg_latency_ms": 2380,
      "total_cost_usd": 1.45
    }
  ],
  "summary": {
    "total_runs": 1234,
    "overall_pass_rate": 0.85,
    "trend": "improving",
    "cost_total_usd": 45.67
  }
}