st_app_info: Fetch Unified App or Publisher Information from Sensor Tower

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

Fetch Unified App or Publisher Information from Sensor Tower

Description

This function retrieves information about apps or publishers from the Sensor Tower API based on a search term. It targets the '/v1/{app_store}/search_entities' endpoint and fetches IDs and names for unified app or publisher entities.

Usage

st_app_info(
  term,
  app_store = "unified",
  entity_type = "app",
  limit = 20,
  auth_token = Sys.getenv("SENSORTOWER_AUTH_TOKEN"),
  return_all_fields = FALSE
)

Arguments

term	Character string. The search term for the app or publisher.
app_store	Character string. The app store to search. Defaults to "unified".
entity_type	Character string. The type of entity to search for. Either "app" (default) or "publisher".
limit	Numeric. The maximum number of results to return. Defaults to 20.
auth_token	Character string. Your Sensor Tower API authentication token.
return_all_fields	Boolean. If TRUE, returns all available fields from the API response. Defaults to FALSE.

Value

A [tibble][tibble::tibble] with entity information:

**For apps** ('entity_type = "app"'): - 'unified_app_id': The unified app ID (24-char hex) - 'unified_app_name': The app name - 'category_details': (when available) Nested tibble with category info

**For publishers** ('entity_type = "publisher"'): - 'unified_publisher_id': The unified publisher ID (24-char hex) - 'unified_publisher_name': The publisher name

Use the returned publisher ID with 'st_publisher_apps()' to get the publisher's apps.

Examples

## Not run: 
# Search for an app by name
app_info <- st_app_info(term = "Clash of Clans")
print(app_info)

# Search for a publisher by name
publisher_info <- st_app_info(term = "Lilith", entity_type = "publisher")
print(publisher_info)

# Get publisher's apps
lilith_apps <- st_publisher_apps(
  unified_id = publisher_info$unified_publisher_id[1],
  aggregate_related = TRUE
)

# ---- Piping Workflow Examples ----
library(dplyr)

# Pipe-friendly workflow: Find publisher -> Get apps -> Fetch sales
lilith_sales <- st_app_info("Lilith", entity_type = "publisher") %>%
  slice(1) %>%
  pull(unified_publisher_id) %>%
  st_publisher_apps(aggregate_related = TRUE) %>%
  pull(unified_app_id) %>%
  st_unified_sales_report(
    countries = "WW",
    start_date = "2024-01-01",
    end_date = "2024-12-31",
    date_granularity = "monthly"
  )

## End(Not run)

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