# Facebook Gaming Scraper (`crawlix/facebook-gaming-scraper`) Actor

Facebook Gaming Scraper extracts title, name, url, viewer count, follower count, game name, streamer name, streamer profile url, thumbnail url, cover image url, scraped at for every row. Inputs: scrape target, sort by, max items to scrape, connection country.

- **URL**: https://apify.com/crawlix/facebook-gaming-scraper.md
- **Developed by:** [Crawlix](https://apify.com/crawlix) (community)
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 game or live streams

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

The **facebook gaming scraper** is a purpose-built data collection solution engineered to extract real-time intelligence from Facebook Gaming. Gaming studios, esports franchises, talent management agencies, and market analysts rely on the **facebook gaming scraper** to monitor trending games, track audience engagement metrics, evaluate broadcaster performance, and discover rising content creators. Instead of relying on manual observation across dynamic video pages, this **facebook gaming directory scraper** and **facebook gaming live stream scraper** delivers structured, machine-readable datasets directly to your business intelligence pipelines.

Whether your objective is to map out viewership distribution across competitive titles or monitor concurrent broadcasts for brand sponsorship opportunities, the **facebook gaming scraper** automates the entire discovery process. When data teams need to **scrape facebook gaming streams** efficiently, this **facebook live game stream scraper** extracts critical performance indicators while eliminating the operational bottlenecks of manual data compilation.

#### Key Capabilities at a Glance

- **Dual Extraction Modes**: Seamlessly alternate between harvesting the complete games catalog and monitoring active live video broadcasts using the **facebook gaming scraper**.
- **Real-Time Audience Metrics**: Capture live concurrent viewer numbers, historical follower metrics, and page engagement data with this **facebook gaming live stream scraper**.
- **Comprehensive Broadcaster Intelligence**: Extract verified creator names, personal profile links, channel identifiers, and public avatar URLs using the **facebook live game stream scraper**.
- **Game Attribution Mapping**: Associate live video broadcasts directly with official game titles, catalog IDs, and platform URLs through this **facebook gaming scraper**.
- **Dynamic Field Presentation**: Clean dataset delivery adhering to a zero-empty standard where unpopulated fields are automatically omitted from individual records.
- **Pay-Per-Event Predictability**: Cost-effective execution where charges only apply to verified records pushed directly to your permanent dataset storage.
- **Flexible Ordering Controls**: Rank directories by default platform relevance or prioritize channels with the highest concurrent audiences via the **facebook gaming directory scraper**.

***

### Practical Use Cases & Applications

The **facebook gaming scraper** delivers structured data tailored for a wide variety of competitive intelligence, marketing, and analytical workflows:

#### 1. Esports & Creator Talent Scouting

Talent agencies, esports organizations, and gaming clans use the **facebook gaming live stream scraper** to identify promising creators. By tracking viewership growth over time, scouts can identify high-performing broadcasters playing titles like *Mobile Legends*, *PUBG Mobile*, *Free Fire*, *Grand Theft Auto V*, and *Valorant*. This specialized **facebook live game stream scraper** provides verified channel URLs and personal creator links for direct outreach.

#### 2. Video Game Publisher Market Research

Publishers and indie developers utilize the **facebook gaming directory scraper** to benchmark competitor titles against their own releases. By analyzing follower volume, active broadcast frequency, and aggregate concurrent audiences, product teams can gauge market interest and evaluate community retention trends with the **facebook gaming scraper**. Teams that regularly **scrape facebook gaming streams** can identify underserved player demographics.

#### 3. Sponsorship & Advertising Campaign Auditing

Brand marketing managers leverage this **facebook gaming scraper** to verify whether sponsored creators hit agreed-upon viewership thresholds. Furthermore, brands planning influencer campaigns can systematically **scrape facebook gaming streams** to discover broadcasters with dedicated communities that match their demographic targets.

#### 4. Competitive Viewership Analytics & Archiving

Market research firms employ the **facebook live game stream scraper** to establish longitudinal datasets of platform audience dynamics. Archiving hourly or daily viewership metrics allows analysts to forecast genre trends and evaluate platform-level market share in the broader livestreaming ecosystem using the **facebook gaming scraper**.

***

### Target Audiences & Engineering Teams

The **facebook gaming scraper** is architected to support technical and non-technical stakeholders across multiple industries:

| Role / Team | Primary Objective | How the Solution Delivers Value |
|---|---|---|
| **Data Engineers & ETL Teams** | Pipeline Integration | Ingest clean JSON/CSV streams directly into data warehouses and cloud data lakes via the **facebook gaming scraper**. |
| **Esports Operations** | Creator Recruitment | Track rising streaming channels, active hours, and concurrent audiences systematically using the **facebook gaming live stream scraper**. |
| **Game Analytics Teams** | Title Benchmarking | Monitor competitor directory rankings and audience retention without manual logging via the **facebook gaming directory scraper**. |
| **Brand Marketing Agencies** | Influencer Vetting | Verify authentic viewer counts and evaluate streamer channel stability before deploying advertising spend with the **facebook live game stream scraper**. |
| **Academic & Media Researchers** | Digital Culture Studies | Capture comprehensive snapshots of livestreaming communities, broadcast themes, and social interaction using the **facebook gaming scraper**. |

***

### Key Architectural Advantages & Reliability

Relying on manual logging or unstable browser scripts introduces significant data discrepancies and operational overhead. The **facebook gaming scraper** offers an enterprise-ready alternative built for high throughput and consistent reliability:

| Operational Consideration | Manual Tracking & Browser Extensions | Automated Cloud Scraper |
|---|---|---|
| **Data Consistency** | Prone to human error, missed streams, and inconsistent interval capture. | Automated extraction running on scheduled intervals with standardized schemas via the **facebook gaming scraper**. |
| **Scale & Throughput** | Restricted to a handful of tabs before system memory bottlenecks occur. | Capable of harvesting hundreds or thousands of records in minutes through the **facebook gaming directory scraper**. |
| **Dataset Cleanliness** | Inconsistent formats, broken links, and incomplete notes. | Standardized data output with empty fields omitted row-by-row in the **facebook gaming scraper**. |
| **Audience Accuracy** | Stale figures captured minutes or hours after stream completion. | Captures active, real-time concurrent viewers straight from live broadcasts via the **facebook live game stream scraper**. |
| **Automation & Scheduling** | Requires manual daily effort and visual tracking. | Run headless on cloud infrastructure with webhook notifications when you **scrape facebook gaming streams**. |
| **Resource Utilization** | Heavy browser memory consumption and high hardware overhead. | Lightweight cloud execution requiring minimal compute resources in this **facebook gaming scraper**. |

***

### Quickstart: Step-by-Step Execution Guide

Getting started with the **facebook gaming scraper** takes less than two minutes through the platform interface:

1. **Select Scrape Target**:
   Choose **Games Directory** to audit game titles and follower stats across thousands of games (virtually unlimited continuous browsing), or choose **Live Gaming Streams** to collect actively running broadcasts (typically ~145 to 200 streams broadcasting concurrently across the platform) using the **facebook gaming live stream scraper**.
2. **Select Sort Order**:
   Keep **Suggested** for default platform recommendation ranking, or choose **Viewers** to prioritize channels with the highest active audiences using the **facebook live game stream scraper**.
3. **Configure Volume Limit**:
   Set **Max Items to Scrape** to your target quota (default is `50` items). For the Games Directory, you can extract hundreds or thousands of games continuously. For Live Gaming Streams, Facebook typically hosts 145–200 active streams at any given moment, so requesting a higher number gathers 100% of all active streams. Note that free Apify accounts collect up to 50 items per run; upgrading to a paid plan unlocks unlimited item collection with this **facebook gaming directory scraper**.
4. **Choose Connection Country**:
   Select your preferred geographical region for platform access (default is United States `US`).
5. **Execute the Run**:
   Click the **Start** button. Watch real-time extraction progress in the run log and download your structured data in JSON, CSV, Excel, or XML formats through the **facebook gaming scraper**.

***

### Input Parameters & Configuration Reference

Configure the **facebook gaming scraper** using the following input controls:

| Setting | Control | Default | What it does |
|---|---|---|---|
| **Scrape Target** | dropdown | `Games Directory` | Select whether to collect entries from the games directory (unlimited catalog of thousands of titles) or actively broadcasted live streams (typically ~145 to 200 real-time streams) using the **facebook gaming scraper**. |
| **Sort by** | dropdown | `Suggested (Default Relevance)` | Choose result ranking. `Suggested` reflects standard platform recommendation order; `Viewers` ranks games and live streams by highest concurrent viewer count. |
| **Max Items to Scrape** | number box | `50` | Maximum number of games or live streams to collect. For the Games Directory, extract thousands of titles without limits. For Live Streams, platform capacity typically caps between 145 and 200 concurrent broadcasts. Free accounts collect up to 50 items per run; paying accounts enjoy unlimited collection with the **facebook gaming directory scraper**. |
| **Connection Country** | dropdown | `United States (US)` | Geographic region your run connects from. Select from dozens of available international options to tailor extraction to regional game libraries via the **facebook gaming live stream scraper**. |

***

### Extracted Dataset Schema & Field Definitions

The **facebook gaming scraper** delivers structured, transparent datasets designed for immediate ingestion into databases and spreadsheet applications. To ensure maximum data quality, this **facebook gaming live stream scraper** implements a dynamic field omission policy: if an optional attribute is not published by the broadcaster or game studio, that specific key is excluded from the row rather than populated with placeholder text.

#### Fields That Most of the Time May Come in the Output

*These fields represent standard metadata that is typically present on the vast majority of scraped records:*

| Field | Type | Description |
|---|---|---|
| `id` | String | **The unique platform identifier.** Primary identification key for the game or broadcast in the **facebook gaming scraper**. |
| `name` | String | Official title of the video game (populated on game directory records). |
| `title` | String | Headline title of the live stream broadcast (populated on live stream records). |
| `url` | String | Direct canonical URL to the game directory page or live video stream. |
| `viewer_count` | Integer | Live concurrent viewers actively watching the title or stream at time of capture. |
| `target_type` | String | Operational category classification (`game` or `live_stream`). |
| `sort_order` | String | Ranking criteria applied during the run (`suggested` or `viewers`). |
| `scraped_at` | String | ISO 8601 standardized UTC timestamp recording the exact moment of extraction. |

#### Fields Less Often Available (Present When Provided by the Listing or Broadcaster)

*These fields are conditionally populated only when explicitly disclosed by the listing or platform; otherwise, they are omitted from the row:*

| Field | Type | Description |
|---|---|---|
| `vanity` | String | Custom platform username or URL vanity slug for the game directory page. |
| `cover_image_url` | String | High-resolution game cover artwork poster image URL. |
| `follower_count` | Integer | Total registered followers subscribed to the official game page. |
| `can_viewer_follow` | Boolean | Whether viewing accounts can follow the game page. |
| `does_viewer_follow` | Boolean | State indicating whether the viewing account follows the game page. |
| `broadcast_status` | String | Real-time broadcast transmission status (e.g., `LIVE`). |
| `game_id` | String | Platform catalog ID of the specific video game being played in this **facebook live game stream scraper**. |
| `game_name` | String | Display name of the video game attributed to the live stream. |
| `game_vanity` | String | Canonical vanity slug of the game attributed to the broadcast. |
| `game_url` | String | Direct canonical link to the attributed game profile. |
| `streamer_name` | String | Public display name of the content creator or gaming page. |
| `streamer_id` | String | Unique public platform page or channel ID of the broadcaster. |
| `streamer_user_id` | String | Underlying user identifier associated with the streaming account. |
| `streamer_vanity` | String | Custom handle or vanity username for the broadcaster channel. |
| `streamer_profile_url` | String | Direct web link to the content creator's public profile page. |
| `streamer_avatar_url` | String | Direct URL pointing to the broadcaster's public profile picture. |
| `thumbnail_url` | String | High-resolution video frame preview thumbnail URL from the live broadcast. |
| `thumbnail_id` | String | Platform media asset identifier corresponding to the video thumbnail. |
| `video_channel_id` | String | Channel or user identifier hosting the active video stream. |
| `is_live_streaming` | Boolean | Flag verifying that the broadcast is actively transmitting live media. |
| `is_video_broadcast` | Boolean | Flag indicating that the record represents a full video broadcast. |
| `is_currently_live` | Boolean | Real-time status affirming that the channel is currently broadcasting. |
| `is_premiere` | Boolean | Attribute indicating whether the broadcast is an scheduled video premiere. |
| `is_huddle` | Boolean | Indicator denoting whether the stream is an interactive audio/video huddle. |
| `breaking_status` | Boolean | Status indicating if the stream has been designated as a special broadcast event. |

#### Authentic Sample Output Records

##### 1. Games Directory Record Sample

```json
{
  "id": "1494097103958822",
  "name": "Mobile Legends",
  "vanity": "mobilelegends",
  "url": "https://www.facebook.com/gaming/mobilelegends/",
  "cover_image_url": "https://scontent.xx.fbcdn.net/m1/v/t0.53032-6/game_cover.jpg",
  "viewer_count": 11298,
  "follower_count": 11787179,
  "can_viewer_follow": false,
  "does_viewer_follow": false,
  "target_type": "game",
  "sort_order": "suggested",
  "scraped_at": "2026-11-04T08:15:30+00:00"
}
```

##### 2. Live Gaming Stream Record Sample

```json
{
  "id": "1403355128230584",
  "title": "FREE FIRE TOURNAMENT GRAND FINALS - PRO SQUAD SHOWDOWN",
  "url": "https://www.facebook.com/Royalckm99/videos/1403355128230584/",
  "broadcast_status": "LIVE",
  "viewer_count": 4820,
  "game_id": "1479554652143335",
  "game_name": "Garena Free Fire",
  "game_vanity": "garenafreefire",
  "game_url": "https://www.facebook.com/gaming/garenafreefire/",
  "streamer_name": "Royal Gaming",
  "streamer_id": "111539201858710",
  "streamer_user_id": "100090080270223",
  "streamer_vanity": "Royalckm99",
  "streamer_profile_url": "https://www.facebook.com/Royalckm99/",
  "streamer_avatar_url": "https://scontent.xx.fbcdn.net/v/t39.30808-1/avatar.jpg",
  "thumbnail_url": "https://scontent.xx.fbcdn.net/v/t15.5256-10/thumbnail.jpg",
  "thumbnail_id": "1159056663450185",
  "video_channel_id": "100090080270223",
  "is_live_streaming": true,
  "is_video_broadcast": true,
  "is_currently_live": true,
  "target_type": "live_stream",
  "sort_order": "viewers",
  "scraped_at": "2026-11-04T08:15:30+00:00"
}
```

***

### Operational Constraints & Platform Limits

When incorporating the **facebook gaming scraper** into your recurring workflows, keep the following platform parameters in mind:

- **Live Stream Platform Capacity (~145 to 200 Streams Globally)**: Live gaming streams reflect real-time video broadcasts active at the exact moment of your run. Across the entire Facebook Gaming platform, there are typically between ~145 and ~200 gaming livestreams broadcasting concurrently at any given moment. If you set `Max Items` to 500 or 1,000, the scraper will extract 100% of every active gaming livestream on the platform (typically 145–200 streams) and complete the run successfully once all live broadcasts are collected.
- **Virtually Unlimited Games Directory**: In contrast to live broadcasts, the Facebook Games Directory catalogs thousands of official game titles. You can scrape 500, 1,000, 5,000, or more game titles continuously across deep catalog browsing with no platform ceiling.
- **Guaranteed Output Deduplication & Count Parity**: The scraper automatically filters out duplicate items across continuous browsing batches. Every single item reported in the progress log represents a unique record pushed directly to your Apify dataset, ensuring 100% exact count parity between logs and output data with zero duplicate charges.
- **Single Flat Pricing**: Pay-Per-Event billing charges a single unified fee per item saved to your dataset. There are zero extra surcharges for viewer sorting or custom ordering.
- **Publicly Available Information Only**: The scraper accesses only public directories and broadcasts. Private streams, invite-only gaming hubs, and restricted user content are not accessible.
- **Zero-Invented Data Standard**: If an optional parameter (such as a follower count or vanity handle) is omitted by the source, the scraper excludes that key. Data is never fabricated.
- **Time-Sensitive CDN Media Links**: URLs pointing to video thumbnails, creator avatars, and cover artwork are hosted on platform content delivery networks and subject to expiration. If long-term media preservation is required, download assets promptly into permanent cloud storage.
- **Dynamic Live Viewership Fluctuations**: Concurrent viewer numbers reflect the active state at the precise second the record was retrieved by the **facebook gaming live stream scraper**. Live audiences fluctuate constantly throughout a stream.
- **Free Account Capacity**: Free Apify user tiers are limited to collecting up to 50 items per run. Subscribing to an Apify paid plan lifts this boundary entirely for large-scale operations.
- **Pricing Administration**: Operational event prices are maintained directly in the platform Monetization tab rather than hardcoded in listing text.

***

### Best Practices & Performance Optimization

Maximize efficiency and data richness when using the **facebook gaming scraper** by adopting these guidelines:

#### Schedule Periodic Tracking Batches

Live streaming metrics evolve rapidly. Rather than launching massive single executions, schedule hourly or twice-daily runs to **scrape facebook gaming streams** during prime gaming hours.

#### Target Specific Output Categories

If your research focuses solely on title market share, run the **facebook gaming directory scraper** in `Games Directory` mode to collect high-volume game statistics rapidly. Conversely, switch to `Live Gaming Streams` when auditing active broadcasters with the **facebook live game stream scraper**.

#### Choose Geographic Regions Carefully

Different video games dominate in different regions. For instance, battle royale and mobile titles see peak engagement across Southeast Asia and Latin America, whereas PC titles may peak in Europe and North America. Use the `Connection Country` setting in the **facebook gaming scraper** to match your target audience.

#### Integrate Directly with Cloud Warehouses

Configure automated platform webhooks or API triggers to forward dataset output straight to Snowflake, Google BigQuery, or Amazon S3 buckets as soon as each run finishes when you **scrape facebook gaming streams**.

***

### Troubleshooting & Frequently Asked Questions

#### Why did my Live Streams run stop around 145–200 items when I requested 500?

Live streams represent active, real-time video broadcasts currently streaming on Facebook Gaming. At any given moment, there are typically between ~145 and ~200 gaming livestreams broadcasting globally on Facebook. When you request 500 items, the scraper harvests 100% of every active gaming livestream on the platform and completes cleanly once all current broadcasts are collected. If you need thousands of items, switch to the **Games Directory**, which indexes thousands of cataloged titles with virtually unlimited browsing.

#### Can I scrape thousands of items from the Games Directory?

Yes. Unlike live video broadcasts which depend on who is currently online streaming, the Facebook Games Directory indexes thousands of permanent game titles. Paying Apify users can scrape 500, 1,000, 5,000, or more games in a single execution with continuous deep browsing.

#### Do I need to provide Facebook login credentials to use this scraper?

No. The **facebook gaming scraper** operates entirely on public directory data. You do not need to provide passwords, personal cookies, or account access tokens to collect games or live streams.

#### Is there a collection limit on a free Apify account?

Yes. Free accounts can extract up to 50 items per individual run. Upgrading to any paid Apify tier removes this threshold, enabling you to extract thousands of games or streams per run with the **facebook gaming scraper**.

#### Is the 50 item limit per day or per account?

The 50 item cap applies per run. Each time you execute the **facebook live game stream scraper** on a free account, it collects up to 50 records. Upgrading your account removes the limit per run completely.

#### The execution log says "Free user detected" but I am on a paid plan. What should I do?

If your run displays a free-tier notice despite holding an active subscription, navigate to the **Issues** tab on the Actor Console page. Open a new issue citing your **Run ID** and plan name, and our engineering team will inspect the tier mapping immediately.

#### Why do some live stream records contain fewer fields than others?

Broadcasters configure their pages differently. Some creators link official game tags and maintain custom vanity handles, while casual streamers may omit game categories entirely. The **facebook gaming scraper** automatically omits fields that are not supplied by the source, ensuring you never receive dummy or null values.

#### Can I systematically scrape Facebook Gaming streams using automated code?

Yes. The **facebook gaming scraper** provides native integration via Python, JavaScript, and cURL REST endpoints, enabling you to **scrape facebook gaming streams** directly from your own software applications.

#### How frequently does directory ranking refresh?

The platform updates directory rankings and viewer aggregates continuously. When you **scrape facebook gaming streams** on a scheduled basis, each execution captures the fresh standing of active channels.

***

### Code Integration: Python, JavaScript & REST API

The **facebook gaming scraper** integrates smoothly with automated pipelines. Use the official client libraries to initiate runs and fetch datasets:

#### Python Integration

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")

run_input = {
    "target_type": "live_streams",
    "sort_by": "viewers",
    "max_items": 100,
    "proxyCountry": "US"
}

run = client.actor("facebook-gaming-scraper").call(run_input=run_input)

dataset_items = client.dataset(run["defaultDatasetId"]).iterate_items()
for stream in dataset_items:
    print(f"Stream: {stream.get('title')} | Viewers: {stream.get('viewer_count')} | Streamer: {stream.get('streamer_name')}")
```

#### JavaScript / Node.js Integration

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

const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

const runInput = {
    target_type: 'games',
    sort_by: 'suggested',
    max_items: 50,
    proxyCountry: 'US',
};

const run = await client.actor('facebook-gaming-scraper').call(runInput);

const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((game) => {
    console.log(`Game: ${game.name} | Followers: ${game.follower_count} | URL: ${game.url}`);
});
```

#### REST API Integration via cURL

```bash
curl --request POST \
  --url "https://api.apify.com/v2/acts/facebook-gaming-scraper/runs?token=<YOUR_API_TOKEN>" \
  --header "Content-Type: application/json" \
  --data '{
    "target_type": "live_streams",
    "sort_by": "viewers",
    "max_items": 50,
    "proxyCountry": "US"
  }'
```

***

### Technical Architecture Glossary

| Term | Operational Meaning |
|---|---|
| **Actor Run** | A single execution of the **facebook gaming scraper** operating in a cloud container environment on the Apify platform. |
| **Dataset** | A durable, append-only tabular cloud repository storing structured records produced by the **facebook gaming scraper**. |
| **Pay-Per-Event (PPE)** | A consumption-based billing model where costs are tied strictly to successful item extraction rather than idle compute time. |
| **Volume Limit** | The maximum threshold of items harvested per execution, configured via the `max_items` setting in the **facebook gaming directory scraper**. |
| **Dual Target Extraction** | The capability of this **facebook gaming scraper** to collect either high-level directory entries or active livestream broadcasts. |
| **Permanent Cloud Storage** | Persistent cloud storage facilities maintaining historical dataset tables and exported structured records. |
| **Item Limit** | The boundary applied to free-tier accounts (capped at 50 records per run), fully lifted for paying subscribers. |
| **Viewers Ranking** | An optional sorting configuration in the **facebook gaming live stream scraper** that orders results by highest concurrent live audience size. |

***

### Complementary Scrapers in the Ecosystem

Expand your multi-channel intelligence collection by pairing the **facebook gaming scraper** with other scrapers in the ecosystem:

- **Facebook Marketplace Scraper**: Extract local marketplace listings, vehicle offerings, rental properties, electronics, prices, and seller profiles.
- **Meta Ad Scraper**: Collect active sponsored marketing campaigns, creative copy, targeting details, and publisher pages across Facebook and Instagram.
- **LinkedIn Jobs Scraper**: Extract professional job postings, company intelligence, compensation ranges, and employment requirements.
- **Instagram Profile & Post Scraper**: Gather creator profiles, engagement metrics, hashtags, and high-resolution media across Instagram.

***

### Support & Feedback Channels

The **facebook gaming scraper** is actively maintained to ensure ongoing compatibility with platform changes.

If you encounter unexpected behavior, suspect a schema discrepancy, or wish to suggest new feature enhancements:

1. Navigate to the **Issues** tab within the Actor Console page on Apify.
2. Open a new issue containing your specific **Run ID** and the input configuration utilized.
3. The technical team will review the execution log and publish updates promptly.

# Actor input Schema

## `target_type` (type: `string`):

Choose what to scrape: Games Directory (thousands of games cataloged by Facebook, virtually unlimited browsing) or Live Gaming Streams (active real-time broadcasts currently streaming on Facebook, typically ~145 to 200 streams online at any given moment).

## `sort_by` (type: `string`):

Order of results. Suggested ranks by Facebook's default discovery algorithm. Viewers ranks games or live streams by highest concurrent live viewer count.

## `max_items` (type: `integer`):

Maximum number of items to collect. For Games Directory, Facebook indexes thousands of titles with virtually no limit. For Live Gaming Streams, total available items are determined by active real-time broadcasters (typically ~145 to 200 streams globally at any moment); requesting higher quantities collects 100% of all active streams. Free Apify users collect up to 50 items per run; paying users have no limit.

## `proxyCountry` (type: `string`):

The country your run connects from. Pick the location closest to the target audience. If a country is not available, the run connects from the United States automatically.

## Actor input object example

```json
{
  "target_type": "games",
  "sort_by": "suggested",
  "max_items": 20,
  "proxyCountry": "US"
}
```

# Actor output Schema

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

Every game or live stream collected in this run. Use the Export button on the Output tab to download in CSV, Excel, JSON, or XML format.

# 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 = {
    "target_type": "games",
    "sort_by": "suggested",
    "max_items": 20,
    "proxyCountry": "US"
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlix/facebook-gaming-scraper").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 = {
    "target_type": "games",
    "sort_by": "suggested",
    "max_items": 20,
    "proxyCountry": "US",
}

# Run the Actor and wait for it to finish
run = client.actor("crawlix/facebook-gaming-scraper").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 '{
  "target_type": "games",
  "sort_by": "suggested",
  "max_items": 20,
  "proxyCountry": "US"
}' |
apify call crawlix/facebook-gaming-scraper --silent --output-dataset

```

## MCP server setup

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

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/SWA90fegdreU00btY/builds/i1jlTD46l2ox0VwoP/openapi.json