Skip to main content
GET
/
api
/
v2
/
experiments
/
{experiment_id}
/
logs
/
summary
{
  "filters": [
    {
      "field": "status",
      "operator": "=",
      "value": "completed"
    },
    {
      "field": "total_cost",
      "operator": ">=",
      "value": 0.01
    }
  ]
}

{
  "total_count": 150,
  "total_cost": 12.45,
  "total_tokens": 50000,
  "total_prompt_tokens": 30000,
  "total_completion_tokens": 20000,
  "avg_latency": 1.23
}

Documentation Index

Fetch the complete documentation index at: https://docs.keywordsai.co/llms.txt

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

Retrieves aggregated summary statistics for experiment traces matching the current filters. This is useful for getting overview metrics without retrieving individual traces.

​
Authentication

  • API key: Authorization: Bearer <API key>

​
Path Parameters

​
experiment_id
string
required
The ID of the experiment to get summary statistics for.

​
Query Parameters

​
start_time
string
Filter start time (ISO format).
​
end_time
string
Filter end time (ISO format).

​
POST Request Body (Optional)

For advanced filtering, you can send a POST request with filters in the body: 
{
  "filters": [
    {
      "field": "status",
      "operator": "=",
      "value": "completed"
    },
    {
      "field": "total_cost",
      "operator": ">=",
      "value": 0.01
    }
  ]
}
Supported Filter Operators:
  • = or "": Exact match
  • != or "not": Not equal
  • >, >=, <, <= or "gt", "gte", "lt", "lte": Numeric comparisons
  • contains: String contains (case-insensitive)
  • startsWith: String starts with
  • endsWith: String ends with
  • in or IN: Value in list
  • not_in or NOT IN: Value not in list
For more filter operators and examples, see the Filters API Reference.

​
Examples

import requests

experiment_id = "experiment_id_123"
url = f"https://api.keywordsai.co/api/v2/experiments/{experiment_id}/logs/summary/"
headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}

# GET request
response = requests.get(url, headers=headers)
print(response.json())

# POST request with filtering
data = {
    "filters": [
        {
            "field": "status",
            "operator": "=",
            "value": "completed"
        }
    ]
}
response = requests.post(url, headers=headers, json=data)
print(response.json())

​
Response

{
  "total_count": 150,
  "total_cost": 12.45,
  "total_tokens": 50000,
  "total_prompt_tokens": 30000,
  "total_completion_tokens": 20000,
  "avg_latency": 1.23
}
Response Fields:
  • total_count: Total number of traces matching filters
  • total_cost: Sum of all trace costs (in dollars)
  • total_tokens: Sum of all tokens (input + output)
  • total_prompt_tokens: Sum of all input tokens
  • total_completion_tokens: Sum of all output tokens
  • avg_latency: Average latency across all traces (in seconds)
Notes:
  • Uses same filtering logic as list endpoint for consistency
  • Returns zeros if no traces match the filters
  • Supports both GET and POST methods (POST for advanced filtering)
  • Efficient aggregation without loading individual trace data