Query analytics timeseries (legacy path)

Query analytics timeseries with metrics, aggregations and filters. Identical to POST /api/analytics/timeseries, which is the path to use in new integrations; this one stays for callers written against it.

POST /api/v1/analytics

Query analytics timeseries (legacy path)

Python

import requests

url = "https://app.langwatch.ai/api/v1/analytics"

payload = {
    "startDate": 123,
    "endDate": 123,
    "series": [
        {
            "metric": "<string>",
            "key": "<string>",
            "subkey": "<string>",
            "filters": {
                "topics.topics": ["<string>"],
                "topics.subtopics": ["<string>"],
                "metadata.user_id": ["<string>"],
                "metadata.thread_id": ["<string>"],
                "metadata.customer_id": ["<string>"],
                "metadata.labels": ["<string>"],
                "metadata.key": ["<string>"],
                "metadata.value": ["<string>"],
                "metadata.prompt_ids": ["<string>"],
                "traces.origin": ["<string>"],
                "traces.error": ["<string>"],
                "traces.name": ["<string>"],
                "spans.type": ["<string>"],
                "spans.model": ["<string>"],
                "evaluations.evaluator_id": ["<string>"],
                "evaluations.evaluator_id.guardrails_only": ["<string>"],
                "evaluations.evaluator_id.has_passed": ["<string>"],
                "evaluations.evaluator_id.has_score": ["<string>"],
                "evaluations.evaluator_id.has_label": ["<string>"],
                "evaluations.passed": ["<string>"],
                "evaluations.score": ["<string>"],
                "evaluations.state": ["<string>"],
                "evaluations.label": ["<string>"],
                "events.event_type": ["<string>"],
                "events.metrics.key": ["<string>"],
                "events.metrics.value": ["<string>"],
                "events.event_details.key": ["<string>"],
                "annotations.hasAnnotation": ["<string>"]
            },
            "asPercent": True
        }
    ],
    "timeZone": "<string>"
}
headers = {
    "X-Auth-Token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

200

{
  "currentPeriod": [
    {}
  ],
  "previousPeriod": [
    {}
  ]
}

Authorizations

X-Auth-Token · string · header · required

Project API key for sending traces and accessing project-scoped resources. Format: sk-lw-... (no underscore). Obtain one by creating a project via the Admin API or the LangWatch UI.

Body

application/json

startDate · number string · required

endDate · number string · required

series · object[] · required

Show child attributes

timeZone · string · required

query · string

filters · object

Show child attributes

traceIds · string[]

negateFilters · boolean

excludeOrigins · string[]

groupBy · string

Minimum string length: 1

groupByKey · string

timeScale · string integer

Allowed value: "full"

shouldSkipPreviousPeriod · boolean

Response

200

application/json

Success

currentPeriod · object[] · required

Show child attributes

previousPeriod · object[] · required

Show child attributes