st_app_lookup: Look up app information by any ID type

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

Look up app information by any ID type

Description

This function looks up app information using any type of app ID - unified, iOS, or Android. It returns the unified ID and platform-specific IDs that can be used with other API functions.

Usage

st_app_lookup(
  app_id,
  auth_token = Sys.getenv("SENSORTOWER_AUTH_TOKEN"),
  verbose = FALSE
)

Arguments

app_id	Character string. Can be: - Sensor Tower unified app ID (24-char hex like "5ba4585f539ce75b97db6bcb") - iOS app ID (numeric like "943599237") - Android package name (like "com.bandainamcogames.dbzdokkanww")
auth_token	Character string. Your Sensor Tower API authentication token.
verbose	Logical. Whether to show progress messages. Default is FALSE.

Details

The function automatically detects the ID type: - 24-character hex strings are treated as unified IDs - Numeric strings are treated as iOS app IDs - Strings starting with com/net/org/io are treated as Android package names

Value

A list with components: - 'unified_app_id': The Sensor Tower unified app ID - 'ios_app_id': iOS app ID if found - 'android_app_id': Android app ID if found - 'app_name': App name if found - 'publisher_name': Publisher name if found Returns NULL if app cannot be found.

Examples

## Not run: 
# Look up Star Trek Fleet Command
app_ids <- st_app_lookup("5ba4585f539ce75b97db6bcb")

# Use the IDs with st_ytd_metrics
if (!is.null(app_ids)) {
  metrics <- st_ytd_metrics(
    ios_app_id = app_ids$ios_app_id,
    android_app_id = app_ids$android_app_id,
    years = 2025,
    metrics = "revenue",
    countries = "WW"
  )
}

## End(Not run)

sensortowerR documentation built on March 18, 2026, 5:07 p.m.