Classifications - Go SDK

Overview

Task classification market-share endpoints

Available Operations

• GetTaskClassifications - Task classification market share

GetTaskClassifications

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
package main
2
3
import(
4
	"context"
5
	"os"
6
	openrouter "github.com/OpenRouterTeam/go-sdk"
7
	"github.com/OpenRouterTeam/go-sdk/models/operations"
8
	"log"
9
)
10
11
func main() {
12
    ctx := context.Background()
13
14
    s := openrouter.New(
15
        openrouter.WithSecurity(os.Getenv("OPENROUTER_API_KEY")),
16
    )
17
18
    res, err := s.Classifications.GetTaskClassifications(ctx, operations.WindowSevend.ToPointer())
19
    if err != nil {
20
        log.Fatal(err)
21
    }
22
    if res != nil {
23
        // handle response
24
    }
25
}

Parameters

Response

*components.TaskClassificationResponse, error

Errors