% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/st_rankings.R
\name{st_rankings}
\alias{st_rankings}
\title{Fetch Sensor Tower Rankings}
\usage{
st_rankings(
  entity = c("app", "publisher", "category"),
  os = "ios",
  category = NULL,
  country = "US",
  chart_type = "topfreeapplications",
  date = Sys.Date() - 1,
  limit = 100,
  filter = NULL,
  auth_token = NULL
)
}
\arguments{
\item{entity}{Ranking entity to fetch: `"app"`, `"publisher"`, or
`"category"`.}

\item{os}{Operating system. One of `"ios"`, `"android"`, or `"unified"`.}

\item{category}{Optional category identifier forwarded to the legacy ranking
implementation.}

\item{country}{Two-letter country code.}

\item{chart_type}{Chart type for category rankings. Ignored for app and
publisher rankings.}

\item{date}{Ranking date. Accepts a `Date` object or ISO date string.}

\item{limit}{Positive integer row limit.}

\item{filter}{Optional `st_filter` object or 24-character filter ID string.}

\item{auth_token}{Optional Sensor Tower API token.}
}
\value{
A tibble with standardized columns `rank`, `id`, `name`, `os`,
  `category`, `country`, and `date`, plus any entity-specific columns returned
  by the dispatched implementation.
}
\description{
Thin v1.0.0 facade that standardizes the app, publisher, and category ranking
entrypoints while dispatching to the existing implementations.
}
\examples{
\dontrun{
st_rankings(entity = "app", os = "ios", category = 6014, country = "US")

st_rankings(
  entity = "category",
  os = "android",
  category = "game",
  chart_type = "topgrossing",
  country = "GB"
)
}

}
