GetAppRankingsRequest Type | OpenRouter TypeScript SDK | OpenRouter

The TypeScript SDK and docs are currently in beta. Report issues on GitHub.

Example Usage

1 import { GetAppRankingsRequest } from "@openrouter/sdk/models/operations";
2 
3 let value: GetAppRankingsRequest = {};

Fields

Field	Type	Required	Description	Example
`httpReferer`	string	➖	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.
`appTitle`	string	➖	The app display name allows you to customize how your app appears in OpenRouter’s dashboard.
`appCategories`	string	➖	Comma-separated list of app categories (e.g. “cli-agent,cloud-agent”). Used for marketplace rankings.
`category`	operations.GetAppRankingsCategory	➖	Marketplace category group to filter by (e.g. `coding`). Only apps tagged with a subcategory inside this group are returned. Mutually combinable with `subcategory` — when both are supplied the `subcategory` must belong to the `category` group.	coding
`subcategory`	operations.Subcategory	➖	Marketplace subcategory to filter by (e.g. `cli-agent`). Takes precedence over `category` for the actual filter; when `category` is also supplied the pair must be consistent.	cli-agent
`sort`	operations.GetAppRankingsSort	➖	`popular` ranks apps by total token volume inside the date window. `trending` ranks apps by absolute excess token growth: window volume minus the average volume of the three equal-length periods immediately preceding the window. Apps with no excess growth are omitted from `trending` results.	popular
`startDate`	string	➖	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
`endDate`	string	➖	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
`limit`	number	➖	Maximum number of apps to return (1-100). Defaults to 50.	50
`offset`	number	➖	Number of ranked apps to skip before the first returned row (0-100). Defaults to 0. `rank` stays absolute, so the first row of `offset=50` is `rank: 51`.	0