# REST Countries Reference Data Scraper (`parseforge/rest-countries-scraper`) Actor

Pull rich reference data on every country: official + common names, capital, currencies, languages, region, demonym, calling code, top-level domain, area, population, flag, coat-of-arms, timezones, borders, IDD. Filter by name, code, region, or currency.

- **URL**: https://apify.com/parseforge/rest-countries-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Education, Travel, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 1,000 result items

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/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

![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true)

## 🌍 REST Countries Reference Data Scraper

> 🚀 **Pull rich reference data on every country worldwide: capital, currency, flag, languages, region, timezone, and 30+ more fields per country.**

> 🕒 **Last updated:** 2026-05-07 · **📊 40 fields** per record · **250 countries** · capital, currencies, languages, region, demonyms, calling code, TLD, area, population, flags, coat-of-arms, timezones, borders, IDD

The **REST Countries Reference Data Scraper** pulls rich metadata on every country in the world from the REST Countries open dataset. Output includes official + common names, capital, currencies, languages, region/subregion, calling code, top-level domain, area, population, flag image, coat-of-arms, timezones, borders, IDD codes, demonym, FIFA code, and 20+ other fields.

The dataset covers **all 250 countries and territories**. Filters run server-side, so a single run can isolate every country in Europe, every nation that uses the Euro, every Spanish-speaking country, or every country whose capital starts with a specific letter.

| 🎯 Target Audience | 💡 Primary Use Cases |
|---|---|
| Travel platforms, e-commerce checkout, education tools, SaaS product UIs, journalists, ML pipelines | Country-dropdown UIs, currency conversion lookups, telephone-code autocomplete, learning-app fact cards, geo-aware product features |

---

### 📋 What the REST Countries Reference Data Scraper does

Five filtering workflows in a single run:

- 🌐 **All countries.** Default mode pulls every recognized country and territory.
- 🔍 **Lookup by name.** Search by full or partial country name in any language.
- 🆔 **Code lookup.** ISO-2 or ISO-3 codes; multi-country runs supported.
- 🌎 **Region + subregion.** Africa / Americas / Asia / Europe / Oceania filtering.
- 💱 **Currency or language.** Filter by currency code or by spoken language.

> 💡 **Why it matters:** clean, server-side filtering and fresh data on every run.

---
### 🎬 Full Demo

_🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset._

---

### ⚙️ Input

<table>
<thead>
<tr><th>Input</th><th>Type</th><th>Default</th><th>Behavior</th></tr>
</thead>
<tbody>
<tr><td><code>maxItems</code></td><td>integer</td><td><code>10</code></td><td>Records to return. Free plan caps at 10, paid plan up to 1,000,000.</td></tr>
<tr><td><code>mode</code></td><td>string</td><td><code>"all"</code></td><td>all, name, code, region, subregion, currency, language, capital.</td></tr>
<tr><td><code>value</code></td><td>string</td><td><code>""</code></td><td>Lookup value for the chosen mode.</td></tr>
</tbody>
</table>

**Example: all 250 countries.**

```json
{
    "maxItems": 250,
    "mode": "all"
}
````

**Example: every Euro-zone country.**

```json
{
    "maxItems": 50,
    "mode": "currency",
    "value": "EUR"
}
```

***

### 📊 Output

Each record contains **40 fields**. Download as CSV, Excel, JSON, or XML.

#### 🧾 Schema

| Field | Type | Example |
|---|---|---|
| 🏳️ `flagPng` | string | `"https://flagcdn.com/w320/de.png"` |
| 🏷️ `flagEmoji` | string | `"🇩🇪"` |
| 📛 `name` | string | `"Germany"` |
| 📛 `nameOfficial` | string | `"Federal Republic of Germany"` |
| 🆔 `cca2` | string | `"DE"` |
| 🆔 `cca3` | string | `"DEU"` |
| 🆔 `ccn3` | string | `"276"` |
| 🏛️ `capital` | string | `"Berlin"` |
| 🌎 `region` | string | `"Europe"` |
| 🌎 `subregion` | string | `"Western Europe"` |
| 💱 `currenciesText` | string | `"Euro (EUR)"` |
| 🗣️ `languagesText` | string | `"German"` |
| 📞 `callingCode` | string | `"+49"` |
| 🌐 `tld` | string | `".de"` |
| 👥 `population` | number | `83000000` |
| 📐 `areaKm2` | number | `357114` |
| 🕒 `timezones` | array | `["UTC+01:00"]` |
| 🛂 `borders` | array | `["AUT","BEL","CZE","DNK","FRA","LUX","NLD","POL","CHE"]` |
| 🗺️ `capitalLat` | number | `52.52` |
| 🗺️ `capitalLng` | number | `13.41` |

#### 📦 Sample records

<details>
<summary><strong>🇩🇪 Germany</strong></summary>

```json
{"name":"Germany","cca2":"DE","cca3":"DEU","capital":"Berlin","region":"Europe","subregion":"Western Europe","population":83000000,"currenciesText":"Euro (EUR)","callingCode":"+49","tld":".de"}
```

</details>

<details>
<summary><strong>🇯🇵 Japan</strong></summary>

```json
{"name":"Japan","cca2":"JP","cca3":"JPN","capital":"Tokyo","region":"Asia","subregion":"Eastern Asia","population":125800000,"currenciesText":"Japanese yen (JPY)","callingCode":"+81"}
```

</details>

***

### ✨ Why choose this Actor

| | Capability |
|---|---|
| 🌐 | **All 250 countries.** Recognized states plus territories with full metadata. |
| 🆔 | **Multiple ID systems.** ISO-2, ISO-3, ISO numeric, FIFA, IOC, CIOC. |
| 💱 | **Currency + language joins.** Direct mapping for product localization. |
| ⚡ | **Fast.** 250 countries in under 30 seconds. |
| 🆓 | **No auth.** Open dataset, no API key required. |

***

### 📈 How it compares to alternatives

| Approach | Cost | Coverage | Refresh | Filters | Setup |
|---|---|---|---|---|---|
| **⭐ This Actor** | $5 free credit | **250** countries | Live per run | name, code, region, currency, language | ⚡ 2 min |
| Hand-curated CSVs | Free | Stale, partial | Manual | Limited | 🐢 Maintenance |
| Country code APIs (paid) | $20+/month | Often US-centric | Live | Yes | 🐢 Account |
| Wikipedia scraping | Free | All | Live | DIY | 🐢 Days |

***

### 🚀 How to use

1. 📝 **Sign up.** [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) (takes 2 minutes).
2. 🌐 **Open the Actor.** Find the REST Countries Reference Data Scraper on the Apify Store.
3. 🎯 **Set input.** Pick filters and `maxItems`.
4. 🚀 **Run it.** Click **Start**.
5. 📥 **Download.** Grab results in the **Dataset** tab as CSV, Excel, JSON, or XML.

> ⏱️ Total time from signup to dataset: **3-5 minutes.** No coding required.

***

### 💼 Business use cases

<table>
<tr>
<td width="50%" valign="top">

#### 🛒 E-commerce + SaaS

- Country-dropdown UIs with flag emoji
- Currency conversion lookups
- Phone-code autocomplete on signup
- Tax-region routing

</td>
<td width="50%" valign="top">

#### ✈️ Travel Apps

- Country fact cards in itinerary builders
- Capital + timezone in trip planners
- Border-country recommendations
- Calling code per destination

</td>
</tr>
<tr>
<td width="50%" valign="top">

#### 🎓 Education

- Geography quiz apps
- Lecture material with current data
- Reproducible coursework with versioned snapshots
- Civic literacy datasets

</td>
<td width="50%" valign="top">

#### 📰 Journalism + Research

- Country-context boxes for stories
- Sourcing demographic facts
- Corpus-building for global news
- Population + GDP-class joins

</td>
</tr>
</table>

***

### 🔌 Automating REST Countries Reference Data Scraper

Control the scraper programmatically:

- 🟢 **Node.js.** Install the `apify-client` NPM package.
- 🐍 **Python.** Use the `apify-client` PyPI package.
- 📚 See the [Apify API documentation](https://docs.apify.com/api/v2) for full details.

The [Apify Schedules feature](https://docs.apify.com/platform/schedules) lets you trigger this Actor on any cron interval.

***

### 🌟 Beyond business use cases

Data like this powers more than commercial workflows.

<table>
<tr>
<td width="50%">

#### 🎓 Research and academia

- Cross-country panel data construction
- Reproducible reference snapshots
- Course materials
- Translation studies (alt names)

</td>
<td width="50%">

#### 🎨 Personal and creative

- Personal travel dashboards
- Side projects with country data
- Trivia apps and games
- Hobbyist visualization projects

</td>
</tr>
<tr>
<td width="50%">

#### 🤝 Non-profit and civic

- Cultural-literacy outreach
- Civic education resources
- NGO geography datasets
- Open-data contributions

</td>
<td width="50%">

#### 🧪 Experimentation

- Prototype localization features
- Test country-aware product flows
- Train geo-classification models
- Build map overlays

</td>
</tr>
</table>

***

### 🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt in the AI of your choice:

- 💬 [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20REST%20Countries%20Reference%20Data%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🧠 [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20REST%20Countries%20Reference%20Data%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🔍 [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20REST%20Countries%20Reference%20Data%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🅒 [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20REST%20Countries%20Reference%20Data%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)

***

### ❓ Frequently Asked Questions

#### 🧩 How does it work?

Pick a mode (all, name, code, region, subregion, currency, language, or capital) and supply the relevant value. The Actor queries the public REST Countries dataset and emits one record per country.

#### 📊 How many fields per record?

40, including official + common names, ISO codes, capital, currencies, languages, region, calling code, TLD, population, area, flag, coat-of-arms, timezones, borders, demonym, and more.

#### 🌐 Is this the v3 dataset?

Yes. Uses the v3.1 REST Countries dataset, the current canonical version.

#### 🏳️ Are flags + coats-of-arms included?

Yes. Both PNG and SVG URLs are returned for each record.

#### 🔄 How fresh is the data?

Live per run. The REST Countries dataset is community-maintained and updates regularly.

#### ⚖️ Is this data free to use commercially?

Yes. The REST Countries project publishes under the Mozilla Public License which permits commercial reuse.

#### 🔁 Can I schedule runs?

Yes. Use Apify Schedules for any cron interval.

#### 💳 Do I need a paid Apify plan?

No. The free plan covers preview runs (10 records). A paid plan unlocks higher item counts and scheduling.

#### 🆘 What if a run fails?

Apify retries transient errors. Partial datasets are preserved.

#### 🆔 Why are some country codes missing?

CIOC, FIFA, and IOC codes only exist for sovereign states recognized by the relevant body. Territories and dependencies often have null.

***

### 🔌 Integrate with any app

REST Countries Reference Data Scraper connects to any cloud service via [Apify integrations](https://apify.com/integrations):

- [**Make**](https://docs.apify.com/platform/integrations/make) - Automate multi-step workflows
- [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Connect with 5,000+ apps
- [**Slack**](https://docs.apify.com/platform/integrations/slack) - Get run notifications
- [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe data into your warehouse
- [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits
- [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export datasets to Sheets

***

### 🔗 Recommended Actors

- [**🌐 GeoNames Places + Postal Codes**](https://apify.com/parseforge/geonames-places-scraper) - 12M+ places with admin hierarchy, lat/lng, alternate names
- [**🌍 Public Holidays Worldwide**](https://apify.com/parseforge/public-holidays-scraper) - Public holidays for 100+ countries by year
- [**🌏 World Bank Funded Projects**](https://apify.com/parseforge/worldbank-projects-scraper) - World Bank-financed development projects 1947 to present
- [**🌍 Open-Meteo Weather**](https://apify.com/parseforge/open-meteo-weather-scraper) - Global weather forecasts and 80 years of historical climate
- [**📚 Wikidata Entity Search**](https://apify.com/parseforge/wikidata-entity-search-scraper) - 100M+ open knowledge-graph entities

> 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more reference-data scrapers.

***

**🆘 Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) to request a new scraper, propose a custom data project, or report an issue.

***

> **⚠️ Disclaimer:** this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by the REST Countries project, its maintainers, or any sovereign nation. All trademarks mentioned are the property of their respective owners. Only publicly available open data is collected.

# Actor input Schema

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

Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000

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

How to look up country records.

## `value` (type: `string`):

Value for the chosen lookup. By mode: name = country name (e.g. `Spain`); code = ISO-2 or ISO-3 codes, semicolon-separated (e.g. `US;FR;JP` or `USA;FRA;JPN`); region = one of `Africa`, `Americas`, `Asia`, `Europe`, `Oceania`, `Antarctic`; subregion = one of `Northern Africa`, `Sub-Saharan Africa`, `Northern America`, `Caribbean`, `South America`, `Central America`, `Central Asia`, `Eastern Asia`, `South-Eastern Asia`, `Southern Asia`, `Western Asia`, `Eastern Europe`, `Northern Europe`, `Southern Europe`, `Western Europe`, `Australia and New Zealand`, `Melanesia`, `Micronesia`, `Polynesia`; currency = 3-letter ISO 4217 code (e.g. `EUR`, `USD`, `JPY`, `GBP`); language = English language name (e.g. `Spanish`, `English`, `French`, `Mandarin`); capital = capital city name (e.g. `Tokyo`, `London`, `Brasília`). Ignored when mode is `all`.

## Actor input object example

```json
{
  "maxItems": 10,
  "mode": "all"
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# 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 = {
    "maxItems": 10,
    "mode": "all",
    "value": ""
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/rest-countries-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 = {
    "maxItems": 10,
    "mode": "all",
    "value": "",
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/rest-countries-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 '{
  "maxItems": 10,
  "mode": "all",
  "value": ""
}' |
apify call parseforge/rest-countries-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "REST Countries Reference Data Scraper",
        "description": "Pull rich reference data on every country: official + common names, capital, currencies, languages, region, demonym, calling code, top-level domain, area, population, flag, coat-of-arms, timezones, borders, IDD. Filter by name, code, region, or currency.",
        "version": "1.0",
        "x-build-id": "NvyChmHBQGb8bee73"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/parseforge~rest-countries-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-parseforge-rest-countries-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/parseforge~rest-countries-scraper/runs": {
            "post": {
                "operationId": "runs-sync-parseforge-rest-countries-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/parseforge~rest-countries-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-parseforge-rest-countries-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",
                "properties": {
                    "maxItems": {
                        "title": "Max Items",
                        "minimum": 1,
                        "maximum": 1000000,
                        "type": "integer",
                        "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
                    },
                    "mode": {
                        "title": "Lookup mode",
                        "enum": [
                            "all",
                            "name",
                            "code",
                            "region",
                            "subregion",
                            "currency",
                            "language",
                            "capital"
                        ],
                        "type": "string",
                        "description": "How to look up country records.",
                        "default": "all"
                    },
                    "value": {
                        "title": "Lookup value",
                        "type": "string",
                        "description": "Value for the chosen lookup. By mode: name = country name (e.g. `Spain`); code = ISO-2 or ISO-3 codes, semicolon-separated (e.g. `US;FR;JP` or `USA;FRA;JPN`); region = one of `Africa`, `Americas`, `Asia`, `Europe`, `Oceania`, `Antarctic`; subregion = one of `Northern Africa`, `Sub-Saharan Africa`, `Northern America`, `Caribbean`, `South America`, `Central America`, `Central Asia`, `Eastern Asia`, `South-Eastern Asia`, `Southern Asia`, `Western Asia`, `Eastern Europe`, `Northern Europe`, `Southern Europe`, `Western Europe`, `Australia and New Zealand`, `Melanesia`, `Micronesia`, `Polynesia`; currency = 3-letter ISO 4217 code (e.g. `EUR`, `USD`, `JPY`, `GBP`); language = English language name (e.g. `Spanish`, `English`, `French`, `Mandarin`); capital = capital city name (e.g. `Tokyo`, `London`, `Brasília`). Ignored when mode is `all`."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
