# Czech Company Registry Scraper — ARES B2B Leads (`logiover/czech-company-registry-scraper`) Actor

Scrape ARES — the Czech Republic's official company registry (Ministry of Finance). Get IČO, VAT (DIČ), legal form, CZ-NACE industry, full address, dates & active status. Filter by name, IČO, legal form, NACE, municipality & postcode. No login, no API key.

- **URL**: https://apify.com/logiover/czech-company-registry-scraper.md
- **Developed by:** [Logiover](https://apify.com/logiover) (community)
- **Categories:** Lead generation, Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.99 / 1,000 results

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

<div align="center">

## 🇨🇿 ARES Scraper — Czech Company Registry & B2B Leads

#### Scrape ARES — the Czech Republic's official company registry (Ministry of Finance). Get IČO, VAT (DIČ), legal form, CZ-NACE industry, full address, dates & active status. No login, no API key.

<br>

![No login](https://img.shields.io/badge/✓_No_login-no_API_key-2ea44f?style=for-the-badge)
![Official data](https://img.shields.io/badge/🇨🇿_Official-open_registry-1f6feb?style=for-the-badge)
![High volume](https://img.shields.io/badge/📦_Up_to-1k_per_query-1f6feb?style=for-the-badge)
![Leads](https://img.shields.io/badge/🎯_Czech-B2B_leads-9333ea?style=for-the-badge)
![Export](https://img.shields.io/badge/Export-JSON·CSV·Excel·API-f59e0b?style=for-the-badge)

<br>

**Pull a clean, structured list of Czech companies straight from the official ARES register — filter by industry, municipality, legal form or postcode and export IČO, VAT, legal form, full address and dates.**
The fast, no-code way to build targeted **Czech B2B lead lists** and a full **Czech business database** at scale.

</div>

---

### 📌 Overview

The **ARES Scraper** turns **ares.gov.cz** — the **Administrativní registr ekonomických subjektů**, the Czech Ministry of Finance's official registry of economic subjects — into an analysis-ready dataset. It reads directly from the **ARES REST API** (`ares.gov.cz/ekonomicke-subjekty-v-be`), the same open data the registry publishes, so there is **no login, no API key and no captcha**.

For every Czech company you get the **IČO, VAT number (DIČ), legal form, CZ-NACE industry code(s), full registered address (street, city, city part, district, region, postcode), establishment & termination dates and an active flag** — clean, structured B2B lead data.

Perfect for **Czech B2B lead generation**, sales prospecting, market research, CRM enrichment, KYC / compliance and competitor mapping — exported to **CSV, Excel, JSON** or pushed to Google Sheets and your CRM via API.

> ✅ Combine a **CZ-NACE code + municipality** filter and raise `maxResults` to assemble a large, targeted Czech prospect list in a single run.

---

### ❓ What does the ARES / Czech company registry scraper do?

It queries the official **ARES vyhledat (search) API** with your filters, flattens the nested JSON into clean spreadsheet-ready columns, de-dupes by IČO and paginates automatically within ARES's per-query window. You set filters in a simple form; you get a structured dataset back — no code, no registry account, no API integration work.

---

### ✨ Features

| | Feature | Description |
|---|---|---|
| 🎯 | **Czech B2B lead data** | IČO, company name, VAT (DIČ), legal form, CZ-NACE industry and full registered address. |
| 🔎 | **Rich filtering** | Search by company name, IČO, legal form code (s.r.o., a.s.…), CZ-NACE industry code, municipality and postcode. |
| ⚖️ | **Legal form & status** | Legal form code + active / terminated flag with establishment and termination dates — ideal for KYC and lead quality. |
| 🏢 | **Full address** | Street, building number, city, city part, district (okres), region (kraj), postcode and country — broken into clean columns. |
| 🔢 | **Lookup by IČO** | Pass one or many IČO numbers to pull official registry records for known companies. |
| 📦 | **Bulk export** | Up to ~1,000 companies per query, auto-paginated; export to JSON, CSV, Excel, HTML or pull via API & webhooks. |
| 🔓 | **No API key needed** | Reads the official open ARES REST API — no login, no key, no signup, no captcha. |

---

### 📊 What data you get

One clean row per company. Verified output fields:

| Field | Description |
|-------|-------------|
| `ico` | Czech business ID (IČO) |
| `vat` | VAT number (DIČ), when registered |
| `name` | Registered company name (obchodní jméno) |
| `legalFormCode` / `legalFormText` | Legal form code (právní forma) and its description |
| `establishedDate` | Date of establishment (datum vzniku) |
| `terminatedDate` | Date of termination (datum zániku), when ended |
| `updatedDate` | Last update date in ARES (datum aktualizace) |
| `naceCodes` | All CZ-NACE industry codes (`;`-joined) |
| `nacePrimary` | Primary CZ-NACE industry code |
| `address` | Full registered address (textová adresa) |
| `street` | Street and building number |
| `city` / `cityPart` | Municipality and city part |
| `district` / `region` | District (okres) and region (kraj) |
| `zip` | Postcode (PSČ) |
| `country` | Country (název státu) |
| `isActive` | `true` if the company has no termination date |
| `url` | Direct ARES detail URL for the company |
| `scrapedAt` | ISO timestamp of the run |

---

### 🚀 How to use

1. Open the actor and set your **filters** (industry, municipality, legal form, postcode, etc.) — or just type a company name in `obchodniJmeno`.
2. Set `maxResults`.
3. Run, then **export** the dataset to CSV, Excel, JSON or Google Sheets.

#### Input fields

| Field | Type | Description |
|-------|------|-------------|
| `obchodniJmeno` | string | Free-text company name search, e.g. `software`, `technologie` |
| `ico` | string | One IČO, or several comma-separated, e.g. `45274649,27082440` |
| `pravniForma` | string | Legal form code(s): `112` s.r.o., `121` a.s., `101` sole trader… |
| `czNace` | string | CZ-NACE code(s), e.g. `6201` (software), `7311` (advertising) |
| `kodObce` | integer | Municipality code, e.g. `554782` Praha, `582786` Brno |
| `psc` | integer | Registered-address postcode (digits only), e.g. `11000` |
| `nazevObce` | string | Municipality name, e.g. `Praha`, `Brno` |
| `maxResults` | integer | Cap (default `200`, `0` = unlimited; ARES caps each query at ~1k) |
| `useProxy` | boolean | Route through Apify Proxy (datacenter). Default `true` |
| `proxyConfiguration` | object | Proxy override |

#### Example scenarios

**1) Software companies in Prague**
```json
{
  "czNace": "6201",
  "kodObce": 554782,
  "maxResults": 1000
}
````

**2) Joint-stock companies (a.s.) by name**

```json
{
  "obchodniJmeno": "energie",
  "pravniForma": "121",
  "maxResults": 500
}
```

**3) Look up specific companies by IČO**

```json
{
  "ico": "45274649,27082440,00006947"
}
```

***

### 📦 Example output

```json
{
  "ico": "27082440",
  "vat": "CZ27082440",
  "name": "Příklad technologie s.r.o.",
  "legalFormCode": "112",
  "legalFormText": "Společnost s ručením omezeným",
  "establishedDate": "2004-03-15",
  "terminatedDate": null,
  "updatedDate": "2025-07-31",
  "naceCodes": "6201;6202",
  "nacePrimary": "6201",
  "address": "Nad Šárkou 1209/76, 16000 Praha",
  "street": "Nad Šárkou 1209",
  "city": "Praha",
  "cityPart": "Praha 6",
  "district": "Praha-západ",
  "region": "Hlavní město Praha",
  "zip": "16000",
  "country": "Česká republika",
  "isActive": "true",
  "url": "https://ares.gov.cz/ekonomicke-subjekty/27082440",
  "scrapedAt": "2026-06-08T00:00:00.000Z"
}
```

Export to CSV, Excel, JSON or XML, push to Google Sheets / your CRM, or pull via the Apify API and webhooks.

***

### 🎯 Use cases

- **B2B lead generation** — build targeted Czech prospect lists by industry + municipality with IČO, VAT and address.
- **Sales prospecting** — filter active firms by legal form, region and NACE code.
- **Market research** — count and profile companies by CZ-NACE code, region and establishment date.
- **KYC / compliance & due diligence** — verify IČO, VAT (DIČ) and active / terminated status.
- **Competitor mapping** — survey every company in a vertical or town and benchmark form and status.
- **CRM enrichment** — look companies up by IČO and append official registry fields.

***

### ❓ FAQ

#### Is there a free ARES API?

Yes. The Czech Ministry of Finance publishes **ARES** as a fully open, free REST API (`ares.gov.cz/ekonomicke-subjekty-v-be`) — no key, no login, no signup. This actor is a friendly, filterable export layer on top of it: set filters in a form, run, and download a clean dataset with pagination handled and nested fields flattened.

#### How do I export Czech company data to Excel?

Every run writes one row per company to a dataset you can export to **Excel, CSV, JSON or HTML**, or pull via the Apify API. Set your filters (industry, municipality, legal form, etc.), run, and use the **Export** button to download an `.xlsx` / `.csv` of the whole Czech company segment.

#### Does it include company emails and phone numbers?

No — the ARES public search returns **official registry fields** (IČO, VAT, legal form, address, dates, NACE), which do **not** include email or phone. For contact enrichment, combine the IČO / company list this actor produces with a separate email-finding step.

#### How many companies can I get per query?

ARES caps each search at **1,000 results**. If your filters match more, the API refuses the query — the actor logs a clear "narrow your filters" warning and stops gracefully. To cover a larger segment, **split your run by municipality, legal form, NACE code or postcode** and combine the datasets.

#### Is scraping ares.gov.cz legal?

This actor reads only the **official open data** that the Czech Ministry of Finance publishes via its public ARES REST API — no login or circumvention involved. As always, credit the source (ARES / ares.gov.cz) and follow ARES's terms and applicable law for your specific use case.

#### How do I find legal form (právní forma) or CZ-NACE codes?

Common legal form codes: `112` s.r.o. (limited company), `121` a.s. (joint-stock), `101` sole trader (OSVČ). CZ-NACE codes follow the standard NACE numbering, e.g. `6201` computer programming, `7311` advertising, `4711` retail. You can also just use `obchodniJmeno` for a name search and read the `nacePrimary` / `legalFormCode` columns in the output.

#### Is this an ARES API alternative for bulk download?

Yes — it's the easiest **ARES API alternative** for non-developers: no code, automatic pagination, nested JSON flattened to columns, and direct export to CSV / Excel / JSON.

***

### 📈 Notes on coverage & limits

- **No contact details.** ARES is a legal registry: it returns IČO, VAT, legal form, address, dates and NACE — **not** email or phone. Use the IČO / name list as the seed for a separate contact-enrichment step.
- **~1,000 results per query.** The ARES search API hard-caps each query at **1,000 records**. For larger segments, **split your run by municipality, postcode, legal form or NACE code** and combine the datasets.
- **Main subjects.** This actor scrapes economic subjects from the ARES search endpoint; detailed sub-registers (VR, RŽP, etc.) are out of scope.

***

<div align="center">

**ARES Scraper · ARES API · Czech Company Registry Scraper · Czech Business Data · Czech B2B Leads · IČO Lookup · Czech Company Data Export · Ministry of Finance Registry Scraper · Scrape Czech Companies · Czech Company Database to CSV / Excel**

<sub>⚖️ Reads only the Czech Republic's official open registry data (ARES / Ministry of Finance). You are responsible for compliance with ARES's terms and applicable laws.</sub>

</div>

# Actor input Schema

## `obchodniJmeno` (type: `string`):

Free-text company name search, mapped to the ARES `obchodniJmeno` param. Leave empty to use the more specific filters below. Example: "software", "technologie", "stavební".

## `ico` (type: `string`):

Look up specific companies by Czech business ID (IČO). One 8-digit IČO, or several comma-separated, e.g. "45274649" or "45274649,27082440".

## `pravniForma` (type: `string`):

Restrict to a legal form code, e.g. 112 = s.r.o. (limited company), 121 = a.s. (joint-stock), 101 = sole trader (OSVČ). Comma-separate several. Leave empty for all.

## `czNace` (type: `string`):

Filter by CZ-NACE industry code, e.g. 6201 (computer programming), 7311 (advertising), 4711 (retail). Comma-separate several. Leave empty for all industries.

## `kodObce` (type: `integer`):

Filter by municipality code, e.g. 554782 = Praha, 582786 = Brno, 554821 = Ostrava. Leave empty for the whole country.

## `psc` (type: `integer`):

Filter by registered-address postcode (digits only, no space), e.g. 11000 (Praha 1), 60200 (Brno).

## `nazevObce` (type: `string`):

Filter by municipality name, e.g. "Praha", "Brno", "Plzeň". Use either this or the municipality code.

## `maxResults` (type: `integer`):

Stop after this many companies. 0 = unlimited (note: ARES hard-caps each query at 1000 results — narrow your filters by municipality / NACE / legal form to cover more).

## `useProxy` (type: `boolean`):

Route requests through Apify Proxy (datacenter by default). The ARES API is open, so you can turn this off to go direct, but keeping proxy on is stable and recommended.

## `proxyConfiguration` (type: `object`):

Apify Proxy settings. Datacenter is plenty for the open ARES API.

## Actor input object example

```json
{
  "obchodniJmeno": "software",
  "maxResults": 200,
  "useProxy": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `ico` (type: `string`):

Czech business ID (IČO)

## `vat` (type: `string`):

VAT number (DIČ), when registered

## `name` (type: `string`):

Registered company name (obchodní jméno)

## `legalFormCode` (type: `string`):

Legal form code (právní forma), e.g. 112, 121

## `legalFormText` (type: `string`):

Legal form description

## `establishedDate` (type: `string`):

Date of establishment (datum vzniku)

## `terminatedDate` (type: `string`):

Date of termination (datum zániku), when ended

## `updatedDate` (type: `string`):

Last update date in ARES (datum aktualizace)

## `naceCodes` (type: `string`):

All CZ-NACE industry codes, ';'-joined

## `nacePrimary` (type: `string`):

Primary CZ-NACE industry code

## `address` (type: `string`):

Full registered address (textová adresa)

## `street` (type: `string`):

Street and building number

## `city` (type: `string`):

Municipality / city (název obce)

## `cityPart` (type: `string`):

City part (název části obce)

## `district` (type: `string`):

District (okres)

## `region` (type: `string`):

Region (kraj)

## `zip` (type: `string`):

Postcode (PSČ)

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

Country (název státu)

## `isActive` (type: `string`):

Whether the company is active (no termination date)

## `url` (type: `string`):

ARES detail URL for this company

## `scrapedAt` (type: `string`):

Scraped at

# 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 = {
    "obchodniJmeno": "software"
};

// Run the Actor and wait for it to finish
const run = await client.actor("logiover/czech-company-registry-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 = { "obchodniJmeno": "software" }

# Run the Actor and wait for it to finish
run = client.actor("logiover/czech-company-registry-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 '{
  "obchodniJmeno": "software"
}' |
apify call logiover/czech-company-registry-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Czech Company Registry Scraper — ARES B2B Leads",
        "description": "Scrape ARES — the Czech Republic's official company registry (Ministry of Finance). Get IČO, VAT (DIČ), legal form, CZ-NACE industry, full address, dates & active status. Filter by name, IČO, legal form, NACE, municipality & postcode. No login, no API key.",
        "version": "1.0",
        "x-build-id": "SLZpgp73BqqAzgFj9"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/logiover~czech-company-registry-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-logiover-czech-company-registry-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/logiover~czech-company-registry-scraper/runs": {
            "post": {
                "operationId": "runs-sync-logiover-czech-company-registry-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/logiover~czech-company-registry-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-logiover-czech-company-registry-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": {
                    "obchodniJmeno": {
                        "title": "Company name (obchodní jméno)",
                        "type": "string",
                        "description": "Free-text company name search, mapped to the ARES `obchodniJmeno` param. Leave empty to use the more specific filters below. Example: \"software\", \"technologie\", \"stavební\"."
                    },
                    "ico": {
                        "title": "IČO (company ID)",
                        "type": "string",
                        "description": "Look up specific companies by Czech business ID (IČO). One 8-digit IČO, or several comma-separated, e.g. \"45274649\" or \"45274649,27082440\"."
                    },
                    "pravniForma": {
                        "title": "Legal form code (právní forma)",
                        "type": "string",
                        "description": "Restrict to a legal form code, e.g. 112 = s.r.o. (limited company), 121 = a.s. (joint-stock), 101 = sole trader (OSVČ). Comma-separate several. Leave empty for all."
                    },
                    "czNace": {
                        "title": "CZ-NACE industry code",
                        "type": "string",
                        "description": "Filter by CZ-NACE industry code, e.g. 6201 (computer programming), 7311 (advertising), 4711 (retail). Comma-separate several. Leave empty for all industries."
                    },
                    "kodObce": {
                        "title": "Municipality code (kód obce)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Filter by municipality code, e.g. 554782 = Praha, 582786 = Brno, 554821 = Ostrava. Leave empty for the whole country."
                    },
                    "psc": {
                        "title": "Postcode (PSČ)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Filter by registered-address postcode (digits only, no space), e.g. 11000 (Praha 1), 60200 (Brno)."
                    },
                    "nazevObce": {
                        "title": "Municipality name (název obce)",
                        "type": "string",
                        "description": "Filter by municipality name, e.g. \"Praha\", \"Brno\", \"Plzeň\". Use either this or the municipality code."
                    },
                    "maxResults": {
                        "title": "Max results",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Stop after this many companies. 0 = unlimited (note: ARES hard-caps each query at 1000 results — narrow your filters by municipality / NACE / legal form to cover more).",
                        "default": 200
                    },
                    "useProxy": {
                        "title": "Use Apify Proxy",
                        "type": "boolean",
                        "description": "Route requests through Apify Proxy (datacenter by default). The ARES API is open, so you can turn this off to go direct, but keeping proxy on is stable and recommended.",
                        "default": true
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Apify Proxy settings. Datacenter is plenty for the open ARES API.",
                        "default": {
                            "useApifyProxy": true
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
