# Aggrometer — Gaming Attention Data (players, viewers, hype) (`aggrometer/aggrometer-gaming-attention-data`) Actor

Live cross-platform gaming market data: Steam concurrent players, Twitch + YouTube live viewership, the aggro ratio (viewers/players), genre rollups, pre-release hype, per-game history. Pay per query.

- **URL**: https://apify.com/aggrometer/aggrometer-gaming-attention-data.md
- **Developed by:** [Kyle O'Connor](https://apify.com/aggrometer) (community)
- **Categories:**
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $40.00 / 1,000 aggrometer data queries

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Aggrometer — Gaming Attention Data

> **Unofficial.** This Actor is not affiliated with, endorsed, or sponsored by Valve/Steam or Twitch. It provides independently derived aggregates and estimates compiled from publicly available platform interfaces.

**Live gaming market intelligence, pay-per-query.** Aggrometer continuously measures ~2,000 games across **Steam concurrent players** (hourly) and **Twitch live viewership** (15-minute, game-level aggregates) — joined per game with prices, discounts, top-seller ranks, clip velocity, review counts, and pre-release hype. One query = one charge. No subscription.

### The aggro ratio

**aggro = live viewers ÷ concurrent players, same hour.** Above 1.0, a game holds more audience than players — the signal that streamer marketing converts, that a spectacle moment is happening, or that attention is arriving ahead of sales. This Actor is the pay-per-use door to that dataset.

### What you can query

Set `endpoint` in the input to one of:

| endpoint | returns |
|---|---|
| `aggro` *(default)* | The aggro board: attention ratios per game (min 500 players); filter by `genre` |
| `players` | Top 100 games by Steam concurrent players; filter by `genre` |
| `watched` | Top 100 by live Twitch viewers — game-level averages, peaks, and channel counts |
| `genres` | Genre rollup: game count, players, viewers, genre-level aggro, combined hype of unreleased games |
| `hype` | Aggrometer Anticipation Index: top-wishlisted unreleased games scored with pre-release Twitch attention |
| `game` | Full profile for one `app_id`: hourly player/viewer history, prices, sales-rank appearances, clips/day, reviews, metadata |
| `search` | Find Steam `app_id`s by name (`query` input) |
| `summary` | Warehouse coverage and data freshness |

### Example

Input:

```json
{ "endpoint": "aggro", "genre": "RPG", "platform": "twitch" }
```

Output (dataset rows):

```json
{
  "app_id": 262060,
  "name": "Darkest Dungeon",
  "genres": "[\"Indie\",\"RPG\",\"Strategy\"]",
  "players": 6566,
  "viewers_avg": 21868,
  "aggro": 3.33
}
```

### Who uses this

- **Game developers & publishers** — market research: which genres are heavily played but under-streamed, launch-window scouting, competitor attention tracking
- **Marketing teams** — where a game's attention lives: watched-vs-played balance at the game and genre level
- **Analysts & press** — attention momentum, hype-to-release pipelines, price/discount effects on player counts
- **AI agents** — everything above, autonomously; every board returns clean structured JSON

### Data quality & cadence

Game-level derived aggregates and estimates only. Cadence: players hourly · Twitch viewership 15-min · prices, ranks, clips & anticipation daily. History accrues continuously since 2026-08-26; sparse series indicate a young warehouse, not missing coverage. Live viewership data provided by Twitch; the anticipation score is Aggrometer's own composite index (Steam wishlist rank + pre-release Twitch attention).

### Documentation

Data reference, field definitions, and client configs: [github.com/Aggrometer/aggrometer](https://github.com/Aggrometer/aggrometer)

Data provided AS-IS; estimates and derived metrics, not official platform numbers.

# Actor input Schema

## `endpoint` (type: `string`):

Which view of the gaming attention graph to query.

## `genre` (type: `string`):

Optional Steam genre (e.g. Action, RPG, Strategy) — applies to players/watched/aggro.

## `app_id` (type: `integer`):

Required for endpoint=game (e.g. 1623730 = Palworld).

## `query` (type: `string`):

Required for endpoint=search (min 2 chars).

## Actor input object example

```json
{
  "endpoint": "aggro"
}
```

# Actor output Schema

## `results` (type: `string`):

The query results as JSON items: games or genres with players, live viewers, the aggro ratio (viewers/players), hype counts, and related fields.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("aggrometer/aggrometer-gaming-attention-data").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("aggrometer/aggrometer-gaming-attention-data").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call aggrometer/aggrometer-gaming-attention-data --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,aggrometer/aggrometer-gaming-attention-data"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/LWx5GLkIcZguJJZOo/builds/o4ARvHsTgES6UcKJ6/openapi.json