Classifications - Python SDK

Overview

Task classification market-share endpoints

Available Operations

• get_task_classifications - Task classification market share

get_task_classifications

Returns the market-share breakdown of OpenRouter traffic by task classification (e.g. code generation, web search, summarization) over a trailing time window.

Each classification reports its share of classified sampled requests (usage_share) and classified sampled token volume (token_share) as fractions between 0 and 1. The unclassified other bucket is excluded. Absolute volumes are not exposed because the underlying data is sampled.

Each classification also includes a models array listing the top models by request volume within that classification, with their within-tag usage and token shares.

Classifications are grouped into macro-categories (Code, Data, Agent, General) with aggregate shares provided for each.

Authenticate with any valid OpenRouter API key (same key used for inference). Rate-limited to 30 requests/minute per key and 500 requests/day per account.

When republishing or quoting this data, cite as: “Source: OpenRouter (openrouter.ai/rankings), as of {as_of}.”

Example Usage

1
from openrouter import OpenRouter
2
import os
3
4
with OpenRouter(
5
    http_referer="<value>",
6
    x_open_router_title="<value>",
7
    x_open_router_categories="<value>",
8
    api_key=os.getenv("OPENROUTER_API_KEY", ""),
9
) as open_router:
10
11
    res = open_router.classifications.get_task_classifications(window="7d")
12
13
    # Handle response
14
    print(res)

Parameters

Response

components.TaskClassificationResponse

Errors