Data Notes
GameDiscoverCo data is designed for market research and directional analysis. Use it to compare games, evaluate trends, and form hypotheses, not as audited financial reporting.
Estimates
Revenue, sales, player counts, active users, and similar metrics are estimates based on multiple data sources. Treat them as directional rather than exact actuals.
Platform Coverage
The MCP server covers Steam, Xbox, PlayStation, and Nintendo Switch. Steam has the richest metadata, including reviews, wishlists, concurrent users, tags, followers, price history, and review-language data.
Separate tools cover tracked Twitch games and channels, standalone Steam demos, and Steam DLC/soundtracks. Twitch coverage does not imply coverage of other streaming platforms. Catalog membership and available metrics differ between these datasets; a game appearing in one does not guarantee data in another.
Freshness
Most market metrics update daily. Concurrent user data updates more frequently, and historical CCU data can be hourly depending on the metric and availability.
Identifiers
appidis Steam's game identifier.gdcoIdis GameDiscoverCo's unified identifier for a game across supported platforms.- Demo and DLC
appidvalues identify the demo or add-on;parentAppididentifies the base Steam game. - Twitch
gameIdandchannelIdare separate string identifiers returned by streaming search. Steam/IGDB mappings, channel names, URLs, and follower counts may be missing. UsemetadataResolvedwhere returned to assess metadata resolution; do not invent missing names or follower counts.
If a cross-platform query returns no data, first search for the game with
search_games so the assistant can identify the correct gdcoId.
Availability
Very small games, newly announced titles, unreleased titles, or games without enough public signal may have limited data. Some metrics are Steam-only, while others are cross-platform.
Steam Trends
Trends are detected clusters of related Steam games. They do not cover every game on Steam. A game with no detected Trends can still have competitors.
Keep publishedAt with discovery and detail results; from filters by detection
month, not a period of sales or Twitch activity. Heat describes relative
momentum among published Trends. Revenue uses US dollars; revenue, sales, and
wishlist counts are directional estimates. Unreleased member-game revenue and
copies sold are null rather than zero.
Discovery excludes mature Trends by default, but category counts and game memberships include them. Older slugs may resolve to a current Trend or a retired Trend with successors. Retired Trends return no member games; successor slugs can be missing. Not every member game has a Twitch mapping.
Twitch Metrics And Coverage
hoursWatchedmeasures viewer-hours;streamHoursmeasures broadcast hours.avgViewersandpeakViewersare concurrent-viewer metrics, not unique people or follower counts. Do not interpret watched hours as unique reach.- Historical concurrent-viewer metrics can be null or partial even when hours
watched is available. Preserve nulls rather than replacing them with zero.
Inspect
viewerMetricCoverageandviewerMetricsCompleteon streamer results, andobservedDays/coverageon game statistics where returned. A top-streamer result can also includeviewerMetricHoursWatched, separate from total watched hours. Do not assume all metrics cover the full requested period. shareOfChannelandshareOfGameare fractions from 0 to 1, not percentages: 0.25 means 25%. Channel-game share is the game's share of that channel's watched hours. Streamer share is the channel's share of the game's watched hours; channel activity reports this for each day.- Explicit date pairs are inclusive UTC days in
YYYY-MM-DDform, with at most 366 inclusive days. All-time presets mean all available history, not a promise of complete lifetime coverage. Keep the returned range and coverage information alongside comparisons.
Steam Demo Availability And CCU
Demo availability is based on positive Steam evidence, not just a release date
or a parent game's demo link. Treat isActive/availabilityStatus as observed
availability and check lastCheckedAt and latestCcuAt when returned. A historical
peak does not prove a demo is playable now.
ccuCurrent, ccuMax24h, ccuMaxAll, and windowPeakCcu count concurrent players
but describe different time scopes. All-time peaks are not current CCU. Window
rankings and demo CCU history use inclusive UTC ranges of at most 90 days.
History stores positive hourly observations only: missing hours are not measured
zero-player hours. Daily rows are peaks, and sampleCount (or windowSampleCount
in rankings) counts observations, not players. Use these for observed peaks and
trends, not average CCU or inferred continuous activity.
When a demo-details or demo-history query uses a parent game's ID, it resolves to one canonical tracked demo. Use the parent demo catalog and explicit demo IDs to avoid confusing multiple demos for the same game.
Steam DLC And Soundtrack Estimates
Prices (priceBase, priceCurrent) use US cents; estimated revenue uses US
dollars. copiesSold, wishlists, and parentCopiesSold are estimated counts.
attachRate is a percentage, unlike Twitch's fractional share fields, and can
exceed 100%. Do not cap it or present it as a verified percentage of distinct
base-game customers who bought the add-on.
Catalog entries may lack commercial metrics or daily history. Missing estimates
remain null, not zero. Check metricsObservedAt for metric freshness and
observedDate for daily history. History is available only when requested in
the DLC details fields; date bounds and a point limit restrict that history.
Release-date filters select products by release date, not revenue earned during
those dates. Estimated commercial metrics are directional, not audited results.