st_rankings: Fetch Sensor Tower Rankings

In sensortowerR: Interface to 'Sensor Tower' Mobile App Intelligence API

Fetch Sensor Tower Rankings

Description

Thin v1.0.0 facade that standardizes the app, publisher, and category ranking entrypoints while dispatching to the existing implementations.

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

entity	Ranking entity to fetch: '"app"', '"publisher"', or '"category"'.
os	Operating system. One of '"ios"', '"android"', or '"unified"'.
category	Optional category identifier forwarded to the legacy ranking implementation.
country	Two-letter country code.
chart_type	Chart type for category rankings. Ignored for app and publisher rankings.
date	Ranking date. Accepts a 'Date' object or ISO date string.
limit	Positive integer row limit.
filter	Optional 'st_filter' object or 24-character filter ID string.
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.

Examples

## Not run: 
st_rankings(entity = "app", os = "ios", category = 6014, country = "US")

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

## End(Not run)

sensortowerR documentation built on April 25, 2026, 5:06 p.m.