v126

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-08-04957391.2 MB
Classifications

Task classification market share

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}."

get/classifications/task

Query parameters

window'7d'

Trailing time window for the classification data. Currently only 7d (trailing 7 days) is supported.

Example:7d

Trailing time window for the classification data. Currently only 7d (trailing 7 days) is supported.

Response

Task classification market-share data for the requested trailing window.

Example response

{
  "data": {
    "as_of": "2026-06-17",
    "classifications": [
      {
        "category_token_share": 0.48,
        "category_usage_share": 0.51,
        "display_name": "Code Generation",
        "macro_category": "code",
        "models": [
          {
            "id": "openai/gpt-4.1-mini",
            "tag_token_share": 0.75,
            "tag_usage_share": 0.55
          }
        ],
        "tag": "code:general_impl",
        "token_share": 0.31,
        "usage_share": 0.23
      }
    ],
    "macro_categories": [
      {
        "key": "code",
        "label": "Code",
        "token_share": 0.52,
        "usage_share": 0.45
      }
    ],
    "window_days": 7
  }
}