Skip to main content

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​

  • appid is Steam's game identifier.
  • gdcoId is GameDiscoverCo's unified identifier for a game across supported platforms.
  • Demo and DLC appid values identify the demo or add-on; parentAppid identifies the base Steam game.
  • Twitch gameId and channelId are separate string identifiers returned by streaming search. Steam/IGDB mappings, channel names, URLs, and follower counts may be missing. Use metadataResolved where 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.

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​

  • hoursWatched measures viewer-hours; streamHours measures broadcast hours. avgViewers and peakViewers are 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 viewerMetricCoverage and viewerMetricsComplete on streamer results, and observedDays/coverage on game statistics where returned. A top-streamer result can also include viewerMetricHoursWatched, separate from total watched hours. Do not assume all metrics cover the full requested period.
  • shareOfChannel and shareOfGame are 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-DD form, 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.