Task classification market share

curl --request GET \
  --url https://openrouter.ai/api/v1/classifications/task \
  --header 'Authorization: Bearer <token>'

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

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 .”

GET

classifications

task

Task classification market share

curl --request GET \
  --url https://openrouter.ai/api/v1/classifications/task \
  --header 'Authorization: Bearer <token>'

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

Authorizations

Authorization

string

header

required

API key as bearer token in Authorization header

Query Parameters

window

enum<string>

default:7d

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

Available options:

7d

Example:

"7d"

Response

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

data

object

required

Show child attributes

Create a chat completion Get remaining credits

⌘I