Export experiment logs

GET /api/v2/experiments/{experiment_id}/logs/

Request

{
  "filters": [
    {
      "field": "status",
      "operator": "=",
      "value": "completed"
    },
    {
      "field": "comparison_key",
      "operator": "in",
      "value": ["key1", "key2"]
    }
  ]
}

202 Accepted

{
  "message": "Exporting experiment logs. Check your email for the download link."
}

Exports experiment logs to CSV/Excel format. The export is processed asynchronously and a download link is sent to your email.

Authentication

• API key: Authorization: Bearer <API key>

Path Parameters

experiment_id · string · required

The ID of the experiment to export logs from.

Query Parameters

export · string · required

Set to 1 or true to trigger export.

page · integer

Page number (default: 1).

page_size · integer

Number of results per page (default: 100).

sort_by · string

Sort field (e.g., “-cost”, “-start_time”, “name”).

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:

Request

{
  "filters": [
    {
      "field": "status",
      "operator": "=",
      "value": "completed"
    },
    {
      "field": "comparison_key",
      "operator": "in",
      "value": ["key1", "key2"]
    }
  ]
}

Examples

Python

import requests

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

# GET request with export parameter
params = {
    "export": "1",
    "start_time": "2025-01-01T00:00:00Z",
    "end_time": "2025-01-31T23:59:59Z"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

Response

202 Accepted

{
  "message": "Exporting experiment logs. Check your email for the download link."
}

Export Features:

• Supports all filtering options (query params and POST body filters)
• Includes all trace data: input, output, metrics, metadata
• Async processing for large datasets
• Email notification with download link
• CSV and Excel format options

Notes:

• Export is processed asynchronously
• You will receive an email with the download link when the export is ready
• Large datasets may take several minutes to process
• All standard filtering parameters are supported