Initial commit: OpenRouter Python SDK

Auto-generated Python SDK for OpenRouter API, providing comprehensive client library with: - Chat completions and streaming support - Embeddings API - Model and provider information - API key management - Analytics and usage tracking - OAuth authentication flows - Full type hints and error handling
2026-07-30 12:20:57 +08:00 · 2025-11-13 10:56:25 -05:00
commit 5fc522c72f
721 changed files with 45654 additions and 0 deletions
@@ -0,0 +1,54 @@
+# Analytics
+(*analytics*)
+
+## Overview
+
+Analytics and usage endpoints
+
+### Available Operations
+
+* [get_user_activity](#get_user_activity) - Get user activity grouped by endpoint
+
+## get_user_activity
+
+Returns user activity data grouped by endpoint for the last 30 (completed) UTC days
+
+### Example Usage
+
+<!-- UsageSnippet language="python" operationID="getUserActivity" method="get" path="/activity" -->
+```python
+from openrouter import OpenRouter
+import os
+
+
+with OpenRouter(
+    api_key=os.getenv("OPENROUTER_API_KEY", ""),
+) as open_router:
+
+    res = open_router.analytics.get_user_activity(date_="2025-08-24")
+
+    # Handle response
+    print(res)
+
+```
+
+### Parameters
+
+| Parameter                                                            | Type                                                                 | Required                                                             | Description                                                          | Example                                                              |
+| -------------------------------------------------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------- |
+| `date_`                                                              | *Optional[str]*                                                      | :heavy_minus_sign:                                                   | Filter by a single UTC date in the last 30 days (YYYY-MM-DD format). | 2025-08-24                                                           |
+| `retries`                                                            | [Optional[utils.RetryConfig]](../../models/utils/retryconfig.md)     | :heavy_minus_sign:                                                   | Configuration to override the default retry behavior of the client.  |                                                                      |
+
+### Response
+
+**[models.GetUserActivityResponse](../../models/getuseractivityresponse.md)**
+
+### Errors
+
+| Error Type                         | Status Code                        | Content Type                       |
+| ---------------------------------- | ---------------------------------- | ---------------------------------- |
+| errors.BadRequestResponseError     | 400                                | application/json                   |
+| errors.UnauthorizedResponseError   | 401                                | application/json                   |
+| errors.ForbiddenResponseError      | 403                                | application/json                   |
+| errors.InternalServerResponseError | 500                                | application/json                   |
+| errors.OpenRouterDefaultError      | 4XX, 5XX                           | \*/\*                              |