# Wikimedia Pageviews Scraper (`crawlerbros/wikimedia-pageviews-scraper`) Actor

Scrape Wikipedia & Wikimedia pageview metrics from the official REST API. Get daily/monthly view counts per article, most-viewed (top) articles for any day or month, and project-wide aggregate traffic - across 40+ languages and sister projects.

- **URL**: https://apify.com/crawlerbros/wikimedia-pageviews-scraper.md
- **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community)
- **Categories:** Automation, Developer tools, SEO tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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

## Wikimedia Pageviews Scraper

Get **Wikipedia and Wikimedia pageview statistics** straight from the official Wikimedia REST API — no account, no API key, no cookies. Track how much attention any article receives over time, discover the most-viewed articles for any day or month, and measure the total traffic of an entire Wikipedia edition.

Perfect for **trend research, SEO and content strategy, market and interest analysis, journalism, and academic studies** into what the world is reading.

### What it does

This actor fetches structured pageview metrics across **40+ Wikimedia projects** (Wikipedia in every major language, plus Wikimedia Commons, Wikidata, Wiktionary, Wikisource, Wikivoyage and more). It supports four complementary modes:

| Mode | What you get |
|------|--------------|
| **Per-article pageviews** | Daily or monthly view counts for one or more articles over a date range |
| **Top / most-viewed articles** | The ranked list of the most-viewed articles for a specific day or a whole month |
| **Aggregate project pageviews** | Total pageviews for an entire project over a date range |
| **Top articles by country** | The ranked most-viewed articles in a specific country for a day, across all projects |

### Example use cases

- Measure whether interest in a topic is rising or falling over months and years
- Find the trending articles for the day a major event happened
- Compare desktop vs. mobile readership for a page
- Benchmark public interest across different language editions of the same topic
- Feed reader-demand signals into content-planning and SEO dashboards

### Input

Configure the run from the **Input** tab or via JSON. Key fields:

| Field | Description |
|-------|-------------|
| `mode` | `articlePageviews`, `topArticles`, `aggregatePageviews`, or `topArticlesByCountry` |
| `project` | The wiki to query, e.g. `en.wikipedia`, `fr.wikipedia`, `commons.wikimedia`, `www.wikidata` |
| `articles` | Article titles or full wiki URLs (Per-article mode). Spaces are converted to underscores automatically |
| `access` | `all-access`, `desktop`, `mobile-app`, or `mobile-web` |
| `agent` | `user` (humans only), `all-agents`, `spider`, or `automated` |
| `granularity` | `daily` or `monthly` (Per-article & Aggregate modes) |
| `startDate` / `endDate` | Date range in `YYYYMMDD` (or `YYYY-MM-DD`) format. Data begins 2015-07-01 |
| `topYear` / `topMonth` / `topDay` | The date to rank for (Top mode). Set day to `all-days` for a whole-month ranking |
| `country` | ISO 3166-1 alpha-2 country code (Top-by-country mode), e.g. `US`, `GB`, `DE`, `IN` |
| `maxItems` | Hard cap on the number of records returned |

#### Example input

```json
{
  "mode": "articlePageviews",
  "project": "en.wikipedia",
  "articles": ["Albert Einstein", "Python (programming language)"],
  "access": "all-access",
  "agent": "user",
  "granularity": "monthly",
  "startDate": "20240101",
  "endDate": "20240301"
}
````

### Output

Every record is a flat JSON object. Empty fields are omitted, so you never get `null` values.

#### Per-article / aggregate record

```json
{
  "recordType": "pageviews",
  "project": "en.wikipedia",
  "article": "Albert_Einstein",
  "articleLabel": "Albert Einstein",
  "access": "all-access",
  "agent": "user",
  "granularity": "monthly",
  "date": "2024-01-01",
  "views": 639747,
  "articleUrl": "https://en.wikipedia.org/wiki/Albert_Einstein",
  "sourceUrl": "https://wikimedia.org/api/rest_v1/metrics/pageviews/per-article/...",
  "scrapedAt": "2026-07-02T13:25:30.111789+00:00"
}
```

#### Top-articles record

```json
{
  "recordType": "topArticle",
  "project": "en.wikipedia",
  "access": "all-access",
  "date": "2024-01",
  "article": "Main_Page",
  "articleLabel": "Main Page",
  "views": 152225418,
  "rank": 1,
  "articleUrl": "https://en.wikipedia.org/wiki/Main_Page",
  "sourceUrl": "https://wikimedia.org/api/rest_v1/metrics/pageviews/top/...",
  "scrapedAt": "2026-07-02T13:25:37.454208+00:00"
}
```

#### Top-by-country record

```json
{
  "recordType": "topArticleByCountry",
  "country": "US",
  "access": "all-access",
  "date": "2024-01-01",
  "project": "en.wikipedia",
  "article": "Main_Page",
  "articleLabel": "Main Page",
  "viewsCeil": 1866400,
  "rank": 1,
  "articleUrl": "https://en.wikipedia.org/wiki/Main_Page",
  "sourceUrl": "https://wikimedia.org/api/rest_v1/metrics/pageviews/top-per-country/...",
  "scrapedAt": "2026-07-02T13:25:41.001200+00:00"
}
```

#### Output fields

| Field | Present in | Description |
|-------|-----------|-------------|
| `recordType` | all | `pageviews`, `topArticle`, `aggregate`, or `topArticleByCountry` |
| `country` | top-by-country | ISO 3166-1 alpha-2 country code the ranking covers |
| `project` | all | The Wikimedia project queried (per-entry in top-by-country, as rankings span projects) |
| `article` | per-article, top, top-by-country | Article token (underscored) |
| `articleLabel` | per-article, top, top-by-country | Human-readable article title (spaces) |
| `access` | all | Access method the counts cover |
| `agent` | per-article, aggregate | Traffic source |
| `granularity` | per-article, aggregate | `daily` or `monthly` |
| `date` | all | The period the count belongs to |
| `views` | per-article, top, aggregate | Number of pageviews |
| `viewsCeil` | top-by-country | Privacy-bucketed (ceiling-rounded) view count published for country rankings |
| `rank` | top, top-by-country | Position in the most-viewed ranking |
| `articleUrl` | per-article, top, top-by-country | Direct link to the article |
| `sourceUrl` | all | The API endpoint the record came from |
| `scrapedAt` | all | UTC timestamp of the run |

### Data source

Data comes from the public [Wikimedia REST API](https://wikimedia.org/api/rest_v1/) pageviews endpoints, which the Wikimedia Foundation publishes openly. The actor sends a descriptive User-Agent as requested by Wikimedia's API policy. Pageview data is available from **July 2015** onward and is typically updated through the previous day.

### FAQ

**Do I need an API key or account?**
No. The Wikimedia pageviews API is completely public and free.

**How far back does the data go?**
Daily and monthly pageview data is available from **2015-07-01** onward.

**Which projects are supported?**
40+ projects, including Wikipedia in all major languages plus Wikimedia Commons, Wikidata, Meta-Wiki, Wiktionary, Wikisource, Wikiquote, Wikivoyage, Wikibooks and Wikinews. Choose one from the `project` dropdown.

**Why do human-only counts differ from all-agents?**
The `user` agent filter excludes known bots and crawlers, giving a cleaner picture of genuine human readership. Use `all-agents` to include everything.

**Can I get the top articles for an entire month?**
Yes — in Top mode, set `topDay` to `all-days` to receive the whole-month ranking.

**Can I see the most-viewed articles in a specific country?**
Yes — use `topArticlesByCountry` mode with a `country` code (e.g. `US`, `DE`, `IN`). It returns the daily ranking across all Wikimedia projects. Because Wikimedia publishes country-level data with privacy protection, this mode reports `viewsCeil` (a ceiling-rounded view count) instead of an exact `views` figure, and is available per day rather than per whole month.

**What happens if an article has no data?**
Articles with no recorded views for the chosen range are simply skipped; the run still completes successfully.

# Actor input Schema

## `mode` (type: `string`):

What to fetch.

## `project` (type: `string`):

The wiki to query, e.g. `en.wikipedia` for English Wikipedia.

## `articles` (type: `array`):

Article titles or full wiki URLs, e.g. `Albert Einstein` or `https://en.wikipedia.org/wiki/Albert_Einstein`. Spaces are converted to underscores automatically.

## `access` (type: `string`):

Which platform's traffic to count.

## `agent` (type: `string`):

Traffic source. `user` excludes bots/crawlers. Used by per-article and aggregate modes.

## `granularity` (type: `string`):

Time bucket for per-article and aggregate modes.

## `startDate` (type: `string`):

Range start, format `YYYYMMDD` (or `YYYY-MM-DD`). Data begins 2015-07-01.

## `endDate` (type: `string`):

Range end, format `YYYYMMDD` (or `YYYY-MM-DD`).

## `topYear` (type: `integer`):

Year to rank the most-viewed articles for.

## `topMonth` (type: `string`):

Month (01-12) to rank the most-viewed articles for.

## `topDay` (type: `string`):

Day of month (01-31) to rank, or `all-days` for the whole-month ranking.

## `country` (type: `string`):

ISO 3166-1 alpha-2 country code to rank the most-viewed articles for. This mode ranks daily and across all projects, so set `topDay` to a specific day (a whole-month ranking is not available).

## `maxItems` (type: `integer`):

Hard cap on emitted records.

## Actor input object example

```json
{
  "mode": "articlePageviews",
  "project": "en.wikipedia",
  "articles": [
    "Albert Einstein",
    "Python (programming language)"
  ],
  "access": "all-access",
  "agent": "user",
  "granularity": "monthly",
  "startDate": "20240101",
  "endDate": "20240301",
  "topYear": 2024,
  "topMonth": "01",
  "topDay": "all-days",
  "country": "US",
  "maxItems": 15
}
```

# Actor output Schema

## `pageviews` (type: `string`):

Dataset containing all scraped pageview rows.

# 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 = {
    "mode": "articlePageviews",
    "project": "en.wikipedia",
    "articles": [
        "Albert Einstein",
        "Python (programming language)"
    ],
    "access": "all-access",
    "agent": "user",
    "granularity": "monthly",
    "startDate": "20240101",
    "endDate": "20240301",
    "topYear": 2024,
    "topMonth": "01",
    "topDay": "all-days",
    "country": "US",
    "maxItems": 15
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlerbros/wikimedia-pageviews-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 = {
    "mode": "articlePageviews",
    "project": "en.wikipedia",
    "articles": [
        "Albert Einstein",
        "Python (programming language)",
    ],
    "access": "all-access",
    "agent": "user",
    "granularity": "monthly",
    "startDate": "20240101",
    "endDate": "20240301",
    "topYear": 2024,
    "topMonth": "01",
    "topDay": "all-days",
    "country": "US",
    "maxItems": 15,
}

# Run the Actor and wait for it to finish
run = client.actor("crawlerbros/wikimedia-pageviews-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "mode": "articlePageviews",
  "project": "en.wikipedia",
  "articles": [
    "Albert Einstein",
    "Python (programming language)"
  ],
  "access": "all-access",
  "agent": "user",
  "granularity": "monthly",
  "startDate": "20240101",
  "endDate": "20240301",
  "topYear": 2024,
  "topMonth": "01",
  "topDay": "all-days",
  "country": "US",
  "maxItems": 15
}' |
apify call crawlerbros/wikimedia-pageviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=crawlerbros/wikimedia-pageviews-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Wikimedia Pageviews Scraper",
        "description": "Scrape Wikipedia & Wikimedia pageview metrics from the official REST API. Get daily/monthly view counts per article, most-viewed (top) articles for any day or month, and project-wide aggregate traffic - across 40+ languages and sister projects.",
        "version": "1.0",
        "x-build-id": "HjD3171QmDvDusW4H"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/crawlerbros~wikimedia-pageviews-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-crawlerbros-wikimedia-pageviews-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/crawlerbros~wikimedia-pageviews-scraper/runs": {
            "post": {
                "operationId": "runs-sync-crawlerbros-wikimedia-pageviews-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/crawlerbros~wikimedia-pageviews-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-crawlerbros-wikimedia-pageviews-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "mode",
                    "project"
                ],
                "properties": {
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "articlePageviews",
                            "topArticles",
                            "aggregatePageviews",
                            "topArticlesByCountry"
                        ],
                        "type": "string",
                        "description": "What to fetch.",
                        "default": "articlePageviews"
                    },
                    "project": {
                        "title": "Wikimedia project",
                        "enum": [
                            "en.wikipedia",
                            "es.wikipedia",
                            "de.wikipedia",
                            "fr.wikipedia",
                            "it.wikipedia",
                            "ja.wikipedia",
                            "ru.wikipedia",
                            "zh.wikipedia",
                            "pt.wikipedia",
                            "ar.wikipedia",
                            "pl.wikipedia",
                            "nl.wikipedia",
                            "uk.wikipedia",
                            "fa.wikipedia",
                            "tr.wikipedia",
                            "id.wikipedia",
                            "ko.wikipedia",
                            "sv.wikipedia",
                            "vi.wikipedia",
                            "he.wikipedia",
                            "cs.wikipedia",
                            "fi.wikipedia",
                            "hi.wikipedia",
                            "th.wikipedia",
                            "el.wikipedia",
                            "hu.wikipedia",
                            "ro.wikipedia",
                            "da.wikipedia",
                            "bn.wikipedia",
                            "no.wikipedia",
                            "sr.wikipedia",
                            "ca.wikipedia",
                            "commons.wikimedia",
                            "www.wikidata",
                            "meta.wikimedia",
                            "en.wiktionary",
                            "en.wikisource",
                            "en.wikiquote",
                            "en.wikivoyage",
                            "en.wikibooks",
                            "en.wikinews"
                        ],
                        "type": "string",
                        "description": "The wiki to query, e.g. `en.wikipedia` for English Wikipedia.",
                        "default": "en.wikipedia"
                    },
                    "articles": {
                        "title": "Articles (mode=articlePageviews)",
                        "type": "array",
                        "description": "Article titles or full wiki URLs, e.g. `Albert Einstein` or `https://en.wikipedia.org/wiki/Albert_Einstein`. Spaces are converted to underscores automatically.",
                        "default": [
                            "Albert Einstein"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "access": {
                        "title": "Access method",
                        "enum": [
                            "all-access",
                            "desktop",
                            "mobile-app",
                            "mobile-web"
                        ],
                        "type": "string",
                        "description": "Which platform's traffic to count.",
                        "default": "all-access"
                    },
                    "agent": {
                        "title": "Agent type",
                        "enum": [
                            "user",
                            "all-agents",
                            "spider",
                            "automated"
                        ],
                        "type": "string",
                        "description": "Traffic source. `user` excludes bots/crawlers. Used by per-article and aggregate modes.",
                        "default": "user"
                    },
                    "granularity": {
                        "title": "Granularity",
                        "enum": [
                            "daily",
                            "monthly"
                        ],
                        "type": "string",
                        "description": "Time bucket for per-article and aggregate modes.",
                        "default": "monthly"
                    },
                    "startDate": {
                        "title": "Start date (mode=articlePageviews / aggregatePageviews)",
                        "type": "string",
                        "description": "Range start, format `YYYYMMDD` (or `YYYY-MM-DD`). Data begins 2015-07-01.",
                        "default": "20240101"
                    },
                    "endDate": {
                        "title": "End date (mode=articlePageviews / aggregatePageviews)",
                        "type": "string",
                        "description": "Range end, format `YYYYMMDD` (or `YYYY-MM-DD`).",
                        "default": "20240301"
                    },
                    "topYear": {
                        "title": "Top: year (mode=topArticles)",
                        "minimum": 2015,
                        "maximum": 2100,
                        "type": "integer",
                        "description": "Year to rank the most-viewed articles for.",
                        "default": 2024
                    },
                    "topMonth": {
                        "title": "Top: month (mode=topArticles)",
                        "enum": [
                            "01",
                            "02",
                            "03",
                            "04",
                            "05",
                            "06",
                            "07",
                            "08",
                            "09",
                            "10",
                            "11",
                            "12"
                        ],
                        "type": "string",
                        "description": "Month (01-12) to rank the most-viewed articles for.",
                        "default": "01"
                    },
                    "topDay": {
                        "title": "Top: day (mode=topArticles)",
                        "enum": [
                            "all-days",
                            "01",
                            "02",
                            "03",
                            "04",
                            "05",
                            "06",
                            "07",
                            "08",
                            "09",
                            "10",
                            "11",
                            "12",
                            "13",
                            "14",
                            "15",
                            "16",
                            "17",
                            "18",
                            "19",
                            "20",
                            "21",
                            "22",
                            "23",
                            "24",
                            "25",
                            "26",
                            "27",
                            "28",
                            "29",
                            "30",
                            "31"
                        ],
                        "type": "string",
                        "description": "Day of month (01-31) to rank, or `all-days` for the whole-month ranking.",
                        "default": "all-days"
                    },
                    "country": {
                        "title": "Country (mode=topArticlesByCountry)",
                        "enum": [
                            "US",
                            "GB",
                            "CA",
                            "AU",
                            "IN",
                            "DE",
                            "FR",
                            "IT",
                            "ES",
                            "NL",
                            "PL",
                            "RU",
                            "UA",
                            "BR",
                            "MX",
                            "JP",
                            "KR",
                            "CN",
                            "TW",
                            "HK",
                            "ID",
                            "TR",
                            "IR",
                            "SA",
                            "EG",
                            "IL",
                            "SE",
                            "NO",
                            "DK",
                            "FI",
                            "BE",
                            "AT",
                            "CH",
                            "PT",
                            "GR",
                            "CZ",
                            "RO",
                            "HU",
                            "TH",
                            "VN",
                            "PH",
                            "MY",
                            "SG",
                            "AR",
                            "CL",
                            "CO",
                            "ZA",
                            "NG",
                            "PK",
                            "BD"
                        ],
                        "type": "string",
                        "description": "ISO 3166-1 alpha-2 country code to rank the most-viewed articles for. This mode ranks daily and across all projects, so set `topDay` to a specific day (a whole-month ranking is not available).",
                        "default": "US"
                    },
                    "maxItems": {
                        "title": "Max items",
                        "minimum": 1,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "Hard cap on emitted records.",
                        "default": 100
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
