Analytics - Python SDK

Analytics method reference

(analytics)

Overview

Analytics and usage endpoints

Available Operations

get_user_activity

Returns user activity data grouped by endpoint for the last 30 (completed) UTC days

Example Usage

1from openrouter import OpenRouter
2import os
3
4with OpenRouter(
5 api_key=os.getenv("OPENROUTER_API_KEY", ""),
6) as open_router:
7
8 res = open_router.analytics.get_user_activity(date_="2025-08-24")
9
10 # Handle response
11 print(res)

Parameters

ParameterTypeRequiredDescriptionExample
date_Optional[str]Filter by a single UTC date in the last 30 days (YYYY-MM-DD format).2025-08-24
retriesOptional[utils.RetryConfig]Configuration to override the default retry behavior of the client.

Response

operations.GetUserActivityResponse

Errors

Error TypeStatus CodeContent Type
errors.BadRequestResponseError400application/json
errors.UnauthorizedResponseError401application/json
errors.ForbiddenResponseError403application/json
errors.InternalServerResponseError500application/json
errors.OpenRouterDefaultError4XX, 5XX*/*