Datasets - Go SDK

Overview

Datasets endpoints

Available Operations

• GetRankingsDaily - Daily token totals for top 50 models

GetRankingsDaily

Returns the top 50 public models per day by total token usage on OpenRouter, plus a single aggregated other row per day that sums every model outside that top 50. Token totals are prompt_tokens + completion_tokens, matching the public rankings chart on openrouter.ai/rankings.

Each row is a distinct (date, model_permaslug) pair. The other row uses the reserved permaslug other and is always returned last within its date, so callers can compute top-50 traffic / total daily traffic without a second request.

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 dataset, OpenRouter must be cited as: “Source: OpenRouter (openrouter.ai/rankings), as of {as_of}.”

Token counts come from each upstream provider’s own tokenizer (Anthropic counts are as reported by Anthropic, OpenAI counts are as reported by OpenAI, etc.), so a token in one row is not directly comparable to a token in another row from a different provider.

Example Usage

1
package main
2
3
import(
4
	"context"
5
	"os"
6
	openrouter "github.com/OpenRouterTeam/go-sdk"
7
	"log"
8
)
9
10
func main() {
11
    ctx := context.Background()
12
13
    s := openrouter.New(
14
        openrouter.WithSecurity(os.Getenv("OPENROUTER_API_KEY")),
15
    )
16
17
    res, err := s.Datasets.GetRankingsDaily(ctx, nil, nil)
18
    if err != nil {
19
        log.Fatal(err)
20
    }
21
    if res != nil {
22
        // handle response
23
    }
24
}

Parameters

Response

*components.RankingsDailyResponse, error

Errors