Interface to 'Video Game Insights' API for Gaming Market Analytics

Interface to the 'Video Game Insights' API v4 < https://app.sensortower.com/vgi/> for video game market analytics. Retrieves game metadata, developer and publisher information, player statistics (concurrent players, daily and monthly active users), revenue and units, reviews, wishlists, followers, price history, player overlap and player demographics for games on 'Steam', 'PlayStation' and 'Xbox', as tidy tibbles with VGI and Steam identifiers for cross-platform comparison.

videogameinsightsR

R package for the Video Game Insights API (by Sensor Tower). Retrieve player counts, revenue, units, wishlists, reviews, player insights and company data for games on Steam, Xbox and PlayStation, all returned as tidy tibbles with snake_case column names.

Since 0.3.0 the package uses only the v4 API: multi-platform rows, VGI IDs and slugs alongside Steam App IDs, and cursor paging. Interactive docs: https://app.sensortower.com/vgi/api/v4/api-docs/. See dev/api_coverage_2026-10.md for the endpoint-by-endpoint mapping.

Installation

install.packages("videogameinsightsR")

# development version
devtools::install_github("econosopher/videogameinsightsR")

Quick Start

library(videogameinsightsR)

# Store your API token (once per session, or add to .Renviron)
Sys.setenv(VGI_AUTH_TOKEN = "your_token_here")

# Search and inspect a game
vgi_search_games("Valheim")
vgi_game_metadata(892970)

Core Workflow

The typical workflow is search -> inspect -> pull time series -> analyse.

library(dplyr)

# 1. Find a game
games <- vgi_search_games("Elden Ring")
app_id <- games$steam_app_id[1]

# 2. Pull metadata (one row per game; per-platform prices, dates and store URLs)
meta <- vgi_game_metadata(app_id)
meta[, c("name", "genre", "steam_genres", "release_date_steam")]

# 3. Pull the full daily history for one Steam game
ccu   <- vgi_insights_ccu(app_id)$player_history   # date, avg, median, max, min
rev   <- vgi_insights_revenue(app_id)              # date, revenue_change, revenue_total
units <- vgi_insights_units(app_id)                # date, units_sold_change, units_sold_total
wl    <- vgi_insights_wishlists(app_id)$wishlist_changes

# 4. Or grab every metric at once
hist <- vgi_historical_data(app_id)
names(hist)
#> "steam_app_id" "revenue" "units_sold" "concurrent_players" "active_players"
#> "reviews" "wishlists" "followers" "price_history" "daily"

# 5. One day across many games, every platform, optional country breakdown
snap <- vgi_historical_data_by_date("2025-06-01", steam_app_ids = c(app_id, 730))
by_country <- vgi_historical_data_by_date("2025-06-01", steam_app_ids = app_id,
                                          countries = c("US", "DE"))

Genres

VGI assigns each game one genre and subgenre (genre, subgenre, for example "Shooter" / "Shooter (General)"). Steam's own store genres, several per game, are kept separately in steam_genres and steam_subgenres. The two can disagree: ARC Raiders is an "Action" game to VGI but a "Shooter" subgenre on Steam. vgi_filter_genre() filters the local cache on either (source = "vgi" or "steam").

Function Families

Game discovery and metadata

Snapshots by date

All accept date and optional steam_app_ids. vgi_historical_data_by_date() returns every metric at once and supports vgi_ids, slugs, countries and regions.

Per-game history (Steam)

Player insights

Publishers and developers

vgi_publishers_overview(slugs = "free-lives")  # per-platform revenue and genre mix
vgi_publisher_list(search = "valve")           # directory (id, name, slug)
vgi_publisher_info(28663)                      # Steam revenue and game counts, releases per platform
vgi_publisher_games(28663)                     # the publisher's Steam App IDs
vgi_all_publisher_games(vgi_ids = 28663)       # VGI game IDs on every platform
# ...and the matching vgi_developer*() functions

Convenience functions

summary <- vgi_game_summary(
  steam_app_ids = c(892970, 1245620),
  start_date = "2025-01-01",
  end_date   = "2025-01-31"
)
summary$summary_table

yoy <- vgi_game_summary_yoy(
  steam_app_ids = 892970,
  years = c(2024, 2025),
  start_month = "Jan",
  end_month = "Mar"
)
yoy$comparison_table

Pagination

Functions that list many records take limit and cursor and return the next cursor as an attribute; pass all_pages = TRUE to fetch everything.

page1 <- vgi_games_metadata(limit = 500)
page2 <- vgi_games_metadata(limit = 500, cursor = attr(page1, "next_cursor"))
everything <- vgi_publisher_list(all_pages = TRUE)

Configuration

# API root (the /v4 segment is added; default shown)
options(vgi.base_url = "https://vginsights.com/api")

# Timeouts and retries
options(vgi.timeout = 30)
options(vgi.retry_max_tries = 4)

# Request caching (seconds, GET only)
options(vgi.request_cache_ttl = 3600)

# Rate limiting
options(vgi.auto_rate_limit = TRUE)
options(vgi.calls_per_batch = 10)
options(vgi.batch_delay = 1)

# Verbose logging
options(vgi.verbose = TRUE)

Important Notes

• Platforms: on Xbox, VGI's "units owned" includes Game Pass players and other free copies; "paid units" excludes them. Xbox and PlayStation figures are VGI model estimates.
• Steam App IDs: pass explicit IDs to the snapshot-by-date functions. Without them the API returns its default handful of games.
• API host: requests go to https://vginsights.com/api/v4, which redirects to https://app.sensortower.com/vgi/api/v4.
• Return types: all data-returning functions produce tibbles with snake_case columns.

Development

devtools::load_all()
devtools::test()
devtools::check(cran = TRUE)

Tests replay httptest2 fixtures under tests/testthat/api/v4/ (re-record with Rscript dev/record_fixtures.R). Live smoke tests run only when VGI_AUTH_TOKEN is set.

License

MIT