Analytics

Overview

Analytics and usage endpoints

Available Operations

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. Pass workspace_id to scope the response to a single workspace. Pass group_by=workspace to split each row per workspace and include workspace_id on every item; by default rows are aggregated across workspaces and workspace_id is not returned. Activity recorded before workspace resolution existed is permanently attributed to the account default workspace (no backfill is possible). Management key required.

Example Usage

from openrouter import OpenRouter
import os


with OpenRouter(
    http_referer="<value>",
    x_open_router_title="<value>",
    x_open_router_categories="<value>",
    api_key=os.getenv("OPENROUTER_API_KEY", ""),
) as open_router:

    res = open_router.analytics.get_user_activity()

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description
`request`	operations.GetUserActivityRequest	:heavy_check_mark:	The request object to use for the request.
`retries`	Optional[utils.RetryConfig]	:heavy_minus_sign:	Configuration to override the default retry behavior of the client.

Response

components.ActivityResponse

Errors

Error Type	Status Code	Content Type
errors.BadRequestResponseError	400	application/json
errors.UnauthorizedResponseError	401	application/json
errors.ForbiddenResponseError	403	application/json
errors.NotFoundResponseError	404	application/json
errors.InternalServerResponseError	500	application/json
errors.OpenRouterDefaultError	4XX, 5XX	/

Overview APIKeys

⌘I

TypeScript SDK

Python SDK

Go SDK

DevTools

Overview

Available Operations

get_user_activity

Example Usage

Parameters

Response

Errors

​Overview

​Available Operations

​get_user_activity

​Example Usage

​Parameters

​Response

​Errors

Overview

Available Operations

get_user_activity

Example Usage

Parameters

Response

Errors