# Gaming Company SEC Filings and Financial Facts Monitor (`zinin/gaming-company-sec-filings-financial-monitor`) Actor

Collect SEC filings and exact financial facts for up to ten supplied company CIKs, preserving reporting periods and source evidence.

- **URL**: https://apify.com/zinin/gaming-company-sec-filings-financial-monitor.md
- **Developed by:** [Tim Zinin](https://apify.com/zinin) (community)
- **Categories:** Games, Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $8.50 / 1,000 company financial report delivereds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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?

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

## Gaming Company SEC Filings and Financial Facts Monitor

Turn public SEC filings for a supplied list of company CIKs into structured company reports. Each report links financial facts to their exact filing, reporting period, unit and accession. This is useful for gaming industry research, company news workflows and financial-data preparation.

The Actor reads the SEC Submissions and Company Facts JSON APIs. It supports up to ten companies per run. It does not choose a company universe or create a recurring schedule automatically.

### Try the offline example

The Console example is:

```json
{"demo": true}
```

It uses an invented company and amounts 100 and 180 to show the difference between a quarter and a year-to-date period. The row is labelled `isDemo: true` and `dataProvenance: "fixed_synthetic_demo"`. It makes no external request and requests no result event. The platform start charge, if configured, may still apply. Use only this field in demo mode.

### Collect company reports

This example requests filings for DraftKings and MGM, selecting financial observations within the first half of 2026:

```json
{
  "ciks": ["0001883685", "0000789570"],
  "selection": {
    "filedFrom": "2026-07-01",
    "filedTo": "2026-09-09",
    "forms": ["10-Q", "10-Q/A", "10-K", "10-K/A"],
    "maxFilings": 5,
    "period": {"mode": "contained", "from": "2026-01-01", "to": "2026-06-30"}
  }
}
```

CIKs must be digit strings. Leading zeros are normalized; duplicate company identities are rejected. Choose explicit dates for the filings and for the financial periods. Both date windows are inclusive. Filing dates describe when a document was submitted; financial-period dates describe what its facts cover.

To select one exact quarter, use `"period": {"mode": "exact", "start": "2026-04-01", "end": "2026-06-30"}`. To select an instant such as a balance-sheet date, set `start` to `null` and supply `end`.

Optional `concepts` selects up to 12 exact XBRL concepts, for example:

```json
[{"taxonomy": "us-gaap", "tag": "Assets"}]
```

Supply this array inside `selection`. The optional `maxFilings` accepts 1–20. A missing concept produces an explicit absence, not a zero or a guessed replacement revenue concept.

### Results

Download the default Dataset as JSON for the complete nested report. One company report contains:

- Company CIK and source entity names.
- Selected filings: accession, form, filing date, report date and SEC link.
- Financial facts: taxonomy, tag, unit, value, start/end dates and the exact accession they belong to.
- Source retrieval times, response hashes, coverage and diagnostics.
- `useful`, `isDemo`, `dataProvenance` and billing intent.

Quarter and year-to-date observations remain separate. Amendments remain separate filings. Units and currencies are preserved without conversion. Conflicting facts or numeric values that cannot be preserved are quarantined and explained in diagnostics. The Actor does not infer gaming KPIs such as handle or gross gaming revenue from unrelated accounting tags.

### Charges and incomplete runs

A useful company report containing selected financial facts requests one `result-found` event. Multiple filings or facts within that report do not request additional report events. Demo, empty-source, missing-fact and diagnostic rows request no result event. The configured pricing is shown by Apify; set a finite Max total charge before a real run.

If the remaining budget cannot cover another report, collection stops and the remaining company count is reported. A source failure remains a failed run even if other companies returned useful reports. Those reports remain in the Dataset and their confirmed events are retained.

A Dataset row is written before charging is acknowledged, so its billing field describes intent. Check the actual run event counters for confirmed charges. If delivery or charging is interrupted, inspect the existing run before starting another one. A new run can produce another charge; there is no cross-run deduplication promise.

### Coverage

Only the recent submissions and Company Facts responses are read. Older submission archives and filing documents are not downloaded. Each company has a 4 MiB combined source bound; large issuers can exceed it and return an explicit source error. There is no OCR or general PDF extraction in this Actor.

This is structured source evidence for research. It does not calculate growth, normalize fiscal calendars into calendar quarters, rank investments, verify all issuer disclosures or guarantee current company-wide coverage.

Sources: [SEC developer resources](https://www.sec.gov/about/developer-resources), [SEC API documentation](https://www.sec.gov/search-filings/edgar-application-programming-interfaces).

# Actor input Schema

## `demo` (type: `boolean`):

True uses invented data without source requests or result events. Supply no other fields in demo mode. A platform start charge may still apply.

## `ciks` (type: `array`):

One to ten unique digit strings, for example \["0001883685"]. Leading zeros are normalized; duplicate company identities are rejected.

## `selection` (type: `object`):

Required in real mode. Set filedFrom/filedTo and period (contained: from/to; exact: start/end, start null for an instant). Optional forms, maxFilings and exact concepts are described in README. Dates are explicit; no automatic quarter choice.

## Actor input object example

```json
{
  "demo": true
}
```

# Actor output Schema

## `reports` (type: `string`):

One row per processed CIK. A paid row precedes charge acknowledgement; if the run fails, inspect Dataset and run events before recovery.

# 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 = {
    "demo": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("zinin/gaming-company-sec-filings-financial-monitor").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 = { "demo": True }

# Run the Actor and wait for it to finish
run = client.actor("zinin/gaming-company-sec-filings-financial-monitor").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 '{
  "demo": true
}' |
apify call zinin/gaming-company-sec-filings-financial-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,zinin/gaming-company-sec-filings-financial-monitor"
        }
    }
}
```

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/7vRIHRQPxKh1BMzay/builds/u1h4xvv2MijEkEVRW/openapi.json