Skip to main content
The TypeScript SDK and docs are currently in beta. Report issues on GitHub.

Example Usage

import { GetRankingsDailyRequest } from "@openrouter/sdk/models/operations";

let value: GetRankingsDailyRequest = {};

Fields

FieldTypeRequiredDescriptionExample
httpRefererstring:heavy_minus_sign:The app identifier should be your app’s URL and is used as the primary identifier for rankings.
This is used to track API usage per application.
appTitlestring:heavy_minus_sign:The app display name allows you to customize how your app appears in OpenRouter’s dashboard.
appCategoriesstring:heavy_minus_sign:Comma-separated list of app categories (e.g. “cli-agent,cloud-agent”). Used for marketplace rankings.
startDatestring:heavy_minus_sign:Start of the date window in YYYY-MM-DD (UTC), inclusive. Defaults to 30 days before end_date. The dataset begins at 2025-01-01; earlier values are clamped forward to that floor and the resolved value is echoed in meta.start_date.2026-04-12
endDatestring:heavy_minus_sign:End of the date window in YYYY-MM-DD (UTC), inclusive. Defaults to the most recent completed UTC day. Must be on or after 2025-01-01; earlier values are rejected with a 400.2026-05-11