# Taiwan Government Data API (`lentic_clockss/taiwan-data-search`) Actor

Search Taiwan market, health, environment, nonprofit, and public-data sources in one run. Get structured Taiwan records fast.

- **URL**: https://apify.com/lentic\_clockss/taiwan-data-search.md
- **Developed by:** [kane liu](https://apify.com/lentic_clockss) (community)
- **Categories:** Lead generation, MCP servers
- **Stats:** 5 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$2.00 / 1,000 data records

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## Taiwan Government Data Search

**Search 53 Taiwan public data sources in one query — TWSE and TPEx market data, FDA health and food-safety records, CDC disease surveillance, MOENV monitoring, nonprofit registries, and more.**

- ✅ Search **53 Taiwan public data sources** across business, health, compliance, and environment
- ✅ Get listed company data, monthly revenue, FDA permits and alerts, CDC surveillance, AQI and PM2.5, ESG governance, and nonprofit registry records
- ✅ Covers **9 business**, **16 health**, **23 compliance**, and **5 environment** sources
- ✅ Export results as **Excel, CSV, or JSON**, or connect it to Apify MCP, API, Make, n8n, and Zapier
- ✅ Current Apify listing is **pay per usage**, so you can start with small runs and scale only when the workflow proves useful

Taiwan public-sector data is spread across TWSE, TPEx, FDA, CDC, MOENV, education datasets, nonprofit registries, and a long list of separate agency endpoints. If you want to check a listed company, review food or pharma compliance records, monitor disease surveillance, or pull environmental indicators, the usual workflow means searching multiple government portals one by one. This Actor turns that process into one searchable dataset you can export or automate.

---

### What you can do with it

#### 1. Search Taiwan listed companies, market disclosures, and broker registries in one run

When you look up a Taiwan company, you often need more than one source. A listed issuer may appear in TWSE company lists, monthly revenue data, dividend records, financial-income disclosures, or TPEx OTC datasets. On top of that, some workflows also need customs broker or labor broker registries. This Actor lets you search the active business set together.

To run this, all you fill in are a search term, the business category toggle, and how many results you want per source.

**What you enter:**

| What | Example |
| --- | --- |
| Search term | `台積電` or `TSMC` |
| Categories | Business only |
| How many results | `50` per source |

Click Start. The Actor queries the active Taiwan business sources and returns matching records:

**What you get back:**

| Source | Example fields |
| --- | --- |
| TWSE listed companies | Stock code, company name, market status, industry, listing category |
| TWSE monthly revenue | Company code, company name, monthly revenue, reporting period |
| TWSE dividends | Company code, company name, dividend type, cash or stock amount |
| TPEx datasets | Company code, OTC company name, revenue or valuation fields |
| Broker registries | License or registry identifiers, broker name, city, status |

This is useful for market research, issuer screening, investment operations, and business verification workflows where one search term needs to fan out across multiple Taiwan registry and market datasets.

<details>
<summary>📋 For developers: JSON input/output</summary>

```json
Input:
{
  "searchTerms": ["台積電"],
  "includeBusiness": true,
  "includeHealth": false,
  "includeCompliance": false,
  "includeEnvironment": false,
  "maxResultsPerSource": 50
}

Output:
{
  "stock_code": "2330",
  "name": "台灣積體電路製造股份有限公司",
  "category": "上市",
  "status": "正常交易",
  "_source": "twse_listed_companies",
  "_search_term": "台積電"
}
````

</details>

***

#### 2. Search FDA pharmaceutical, pharmacy, and CDC health surveillance data together

Taiwan health data is spread across Taiwan FDA and Taiwan CDC datasets rather than one unified health database. This Actor searches the active health group, which includes pharmacies, GMP and GDP registries, food additive licenses, health-food permits, clinical trial statistics, drug safety alerts, and CDC surveillance datasets such as dengue, influenza, tuberculosis, and imported cases.

That gives you a practical starting point when you want to discover whether a company, product, place, or health topic appears across the current public Taiwan health set.

**What you enter:**

| What | Example |
| --- | --- |
| Search term | `流感`, `influenza`, `台北`, `pharmacy` |
| Categories | Health only |
| How many results | `50` per source |

**What you get back:**

| Source | Example fields |
| --- | --- |
| FDA pharmacies | Pharmacy name, address, city, license data |
| FDA GMP or GDP registries | Factory or merchant name, certification status, location |
| FDA health and nutrition permits | Product name, permit id, category, approval status |
| CDC surveillance datasets | Case counts, disease category, reporting period, region |

This is useful for healthcare market research, pharmacovigilance support, disease-monitoring workflows, and AI search tasks that need one search layer across multiple Taiwan health-related sources.

<details>
<summary>📋 For developers: JSON input/output</summary>

```json
Input:
{
  "searchTerms": ["influenza"],
  "includeBusiness": false,
  "includeHealth": true,
  "includeCompliance": false,
  "includeEnvironment": false,
  "maxResultsPerSource": 50
}

Output:
{
  "name": "Influenza-like illness surveillance",
  "category": "CDC surveillance",
  "status": "Published",
  "_source": "cdc_influenza_surveillance",
  "_search_term": "influenza"
}
```

</details>

***

#### 3. Review food-safety, ESG, permits, NPO, and regulatory compliance data in one workflow

The compliance group is the broadest part of this Actor. It currently includes 23 active sources spanning FDA food-safety and training records, HACCP manufacturers and sanctions, GMO approvals, pesticide limits, cosmetics additives, kindergarten directories, MOENV emissions and violations, ESG governance disclosures, nonprofit registry data, and more.

Instead of treating compliance as one narrow regulator workflow, this Actor lets you search the wider Taiwan regulatory surface that companies, institutions, and analysts often need in practice.

**What you enter:**

| What | Example |
| --- | --- |
| Search term | `餐飲`, `HACCP`, `school`, `基金會`, `排放` |
| Categories | Compliance only |
| How many results | `50` per source |

**What you get back:**

| Source | Example fields |
| --- | --- |
| FDA HACCP and food-safety records | Manufacturer name, training or sanction status, location |
| FDA GMO, pesticide, and regulation datasets | Product or regulatory item, category, rule or approval detail |
| TWSE ESG governance | Issuer name, governance or sustainability disclosure fields |
| MOENV regulatory datasets | Permit, emission, violation, or EIA-related records |
| NPO and education registries | Organization or school name, city, registration metadata |

This is useful for compliance screening, supplier checks, ESG and sustainability research, civil-society discovery, and regulatory intelligence across multiple Taiwan agencies.

<details>
<summary>📋 For developers: JSON input/output</summary>

```json
Input:
{
  "searchTerms": ["HACCP"],
  "includeBusiness": false,
  "includeHealth": false,
  "includeCompliance": true,
  "includeEnvironment": false,
  "maxResultsPerSource": 50
}

Output:
{
  "name": "Example Food Manufacturer",
  "category": "HACCP manufacturer",
  "city": "Taichung",
  "status": "Certified",
  "_source": "fda_haccp_manufacturers",
  "_search_term": "HACCP"
}
```

</details>

***

#### 4. Monitor AQI, PM2.5, UV, river water, and groundwater indicators

If your workflow is specifically environmental monitoring, you can turn on the environment group and search the current Taiwan monitoring set directly. The active environment group includes AQI realtime data, PM2.5, UV index, river water quality sites, and groundwater quality data.

This is useful when you want to pull public Taiwan monitoring signals without navigating each MOENV endpoint manually.

**What you enter:**

| What | Example |
| --- | --- |
| Search term | `台北`, `Taipei`, `AQI`, `Kaohsiung` |
| Categories | Environment only |
| How many results | `50` per source |

**What you get back:**

| Source | Example fields |
| --- | --- |
| AQI realtime | Station, county or city, AQI value, status, timestamp |
| PM2.5 | Monitoring station, concentration, area |
| UV index | Station or area name, UV level, date |
| River and groundwater | Monitoring site, region, water-quality fields |

This is a practical fit for environmental dashboards, public monitoring workflows, urban analysis, and AI assistants that need structured Taiwan environment results from official public sources.

<details>
<summary>📋 For developers: JSON input/output</summary>

```json
Input:
{
  "searchTerms": ["Taipei"],
  "includeBusiness": false,
  "includeHealth": false,
  "includeCompliance": false,
  "includeEnvironment": true,
  "maxResultsPerSource": 50
}

Output:
{
  "name": "Taipei Station",
  "category": "AQI",
  "city": "Taipei",
  "status": "Moderate",
  "_source": "moenv_aqi_realtime",
  "_search_term": "Taipei"
}
```

</details>

***

#### 5. Use it from ChatGPT, Claude, or no-code automation

This Actor also works as a Taiwan public-data search layer inside AI assistants and automation systems. Instead of teaching each workflow how to query TWSE, FDA, CDC, MOENV, and registry datasets separately, you can use one Actor as the Taiwan search layer.

Connect it once through Apify MCP, API, or a no-code platform, then ask for the results you need:

**What you enter:**

| What | Example |
| --- | --- |
| Search term | `台積電` |
| Categories | Business + compliance |
| Result limit | `25` |

**What your assistant or automation gets back:**

| Source | Returned data |
| --- | --- |
| TWSE and TPEx | Structured issuer and disclosure rows |
| ESG and regulatory sources | Governance or compliance matches |
| FDA and CDC | Health or safety-related rows if that category is enabled |

That makes it useful for internal AI assistants, cross-regulator entity search, scheduled monitoring flows, and spreadsheet-based research workflows.

<details>
<summary>📋 For developers: MCP / JSON input/output</summary>

```json
MCP tool call:
{
  "tool": "apify_actor_run",
  "actor_id": "lentic_clockss/taiwan-data-search",
  "input": {
    "searchTerms": ["台積電"],
    "includeBusiness": true,
    "includeHealth": false,
    "includeCompliance": true,
    "includeEnvironment": false,
    "maxResultsPerSource": 25
  }
}
```

</details>

***

### How to use (no code required)

1. Click **"Try for Free"** at the top of this page
2. Type one or more search terms in Chinese or English — company names, places, products, diseases, regulators, or topic keywords
3. Choose which categories to search: business, health, compliance, and environment
4. Set how many results you want per source
5. Click **Start** — the Actor queries the enabled Taiwan public data sources and returns the results in the Dataset tab

You can then export the results as **Excel, CSV, or JSON**.

This Actor uses the SIP Public Data Gateway and queries the active public Taiwan source set over HTTP. No browser setup, no per-source integration work, and no need to open each agency portal manually.

Because the Actor is listed as **pay per usage**, it is straightforward to start with a small exploratory run, validate that the source mix is useful, and then expand the workflow.

***

### What you get back

Each result comes back as one row in a dataset. The exact columns vary by source family, because a TWSE issuer record, a CDC surveillance row, an FDA permit entry, and a realtime AQI row do not share the same schema.

Across the dataset, you will typically see:

- `_product_id`
- `_source`
- `_search_term`
- `_collected_at`

Then source-specific fields such as:

- **Business**: stock code, company name, category, revenue, dividends, broker identifiers
- **Health**: pharmacy or facility name, permit or license id, specialty, disease category, reporting period
- **Compliance**: manufacturer or organization name, certification, sanction, ESG, permit, violation, registry metadata
- **Environment**: station name, city, AQI or PM2.5 values, UV level, monitoring-site metadata

Every row tells you which source it came from and which search term matched. That makes it easy to filter by source family, split exports by regulator, or merge the results into downstream workflows.

***

### Coverage

This Actor currently searches **53 active Taiwan public data sources**:

| Category | Count | Coverage |
| --- | --- | --- |
| **Business** | 9 | TWSE listed companies, TWSE disclosures, TPEx datasets, customs brokers, labor brokers |
| **Health** | 16 | FDA pharmacies, GMP and GDP registries, health-food and nutrition permits, clinical trials, drug safety alerts, CDC surveillance |
| **Compliance** | 23 | FDA food-safety and training sources, ESG governance, MOENV permits and violations, kindergartens, NPO registry, regulatory datasets |
| **Environment** | 5 | AQI realtime, PM2.5, UV index, river water quality, groundwater quality |

The current active maps in the Actor are:

- `9 business sources`
- `16 health sources`
- `23 compliance sources`
- `5 environment sources`

That mix matters, because this Actor is not just one Taiwan registry. It is a combined Taiwan public-data search layer across multiple agencies and source types.

***

### Pricing

This Actor is currently listed on Apify as **pay per usage**.

The safest place to check the current commercial terms is the live pricing tab:

- https://apify.com/lentic\_clockss/taiwan-data-search/pricing

If you want to control spend, the easiest approach is to:

- search only the categories you need
- start with one or two search terms
- lower `maxResultsPerSource` for exploratory runs

***

### Connect to your tools

You can use this Actor directly in the Apify UI, or connect it to automation and AI workflows:

| Platform | How to connect |
| --- | --- |
| **Apify UI** | Run it directly and export results |
| **Apify API** | Trigger runs and fetch datasets programmatically |
| **Make.com** | Use the Actor ID `lentic_clockss/taiwan-data-search` |
| **n8n / Zapier / ChatGPT / Claude** | Use the same Actor ID via Apify MCP or API |

<details>
<summary>📋 For developers: examples</summary>

```python
from langchain_apify import ApifyActorsTool

tool = ApifyActorsTool("lentic_clockss/taiwan-data-search")
result = tool.invoke({
    "searchTerms": ["台積電"],
    "includeBusiness": True,
    "includeHealth": False,
    "includeCompliance": True,
    "includeEnvironment": False,
    "maxResultsPerSource": 20
})
```

</details>

***

### Related Actors

- [**Japan Government Data Search**](https://apify.com/lentic_clockss/japan-government-data-search) — Japanese public data across procurement and catalogs
- [**Singapore Government Data Search**](https://apify.com/lentic_clockss/singapore-government-data-search) — Singapore public data search
- [**India Government Data Search**](https://apify.com/lentic_clockss/india-data-search) — India public data across multiple source families
- [**Global Company Search**](https://apify.com/lentic_clockss/global-company-search) — registry search across many countries

→ [apify.com/lentic\_clockss](https://apify.com/lentic_clockss)

***

### Also Available

- **Direct API**: `https://opendata.best/api/v1/data`
- **Postman Collection**: [Fork and test](https://www.postman.com/kaneliu10/sip-data-products-api)
- **GitHub**: [Collection source files](https://github.com/kaneliu120/sip-api-collections)

# Actor input Schema

## `searchTerms` (type: `array`):

Keywords to search in Chinese or English (e.g. '台積電', 'TSMC', '口罩', 'influenza'). Each term is searched across all enabled Taiwan data sources in parallel.

## `includeBusiness` (type: `boolean`):

Search TWSE/TPEx listed companies, monthly revenue, dividends, PE ratios, ESG governance, customs brokers, and labor brokers (9 sources).

## `includeHealth` (type: `boolean`):

Search FDA medicines, pharmacies, GMP factories, GDP merchants, clinical trials, drug safety alerts, food additives, health foods, special nutrition, CDC dengue/influenza/TB/imported cases (16 sources).

## `includeCompliance` (type: `boolean`):

Search FDA food safety (HACCP, pesticides, GMO, cosmetics), kindergarten directory, MOENV permits/emissions/violations/EIA, NPO registry, TWSE ESG, food regulations, and excellent restaurants (22 sources).

## `includeEnvironment` (type: `boolean`):

Search real-time and near-real-time environmental data: AQI air quality, PM2.5 fine particles, UV index, river water quality, groundwater quality (5 sources).

## `maxResultsPerSource` (type: `integer`):

Maximum records to return per data source (gateway caps at 200).

## Actor input object example

```json
{
  "searchTerms": [
    "台積電"
  ],
  "includeBusiness": true,
  "includeHealth": true,
  "includeCompliance": false,
  "includeEnvironment": false,
  "maxResultsPerSource": 50
}
```

# Actor output Schema

## `records` (type: `string`):

Dataset containing stock market, health, compliance, and environmental data from 53 Taiwan government sources.

# 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 = {
    "searchTerms": [
        "台積電"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("lentic_clockss/taiwan-data-search").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 = { "searchTerms": ["台積電"] }

# Run the Actor and wait for it to finish
run = client.actor("lentic_clockss/taiwan-data-search").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 '{
  "searchTerms": [
    "台積電"
  ]
}' |
apify call lentic_clockss/taiwan-data-search --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=lentic_clockss/taiwan-data-search",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Taiwan Government Data API",
        "description": "Search Taiwan market, health, environment, nonprofit, and public-data sources in one run. Get structured Taiwan records fast.",
        "version": "0.1",
        "x-build-id": "ZDzLxsdTde2pKjOIC"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/lentic_clockss~taiwan-data-search/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-lentic_clockss-taiwan-data-search",
                "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/lentic_clockss~taiwan-data-search/runs": {
            "post": {
                "operationId": "runs-sync-lentic_clockss-taiwan-data-search",
                "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/lentic_clockss~taiwan-data-search/run-sync": {
            "post": {
                "operationId": "run-sync-lentic_clockss-taiwan-data-search",
                "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": {
                    "searchTerms": {
                        "title": "Search terms",
                        "type": "array",
                        "description": "Keywords to search in Chinese or English (e.g. '台積電', 'TSMC', '口罩', 'influenza'). Each term is searched across all enabled Taiwan data sources in parallel.",
                        "default": [
                            "台積電"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "includeBusiness": {
                        "title": "Include business & stock market data",
                        "type": "boolean",
                        "description": "Search TWSE/TPEx listed companies, monthly revenue, dividends, PE ratios, ESG governance, customs brokers, and labor brokers (9 sources).",
                        "default": true
                    },
                    "includeHealth": {
                        "title": "Include health & pharmaceutical data",
                        "type": "boolean",
                        "description": "Search FDA medicines, pharmacies, GMP factories, GDP merchants, clinical trials, drug safety alerts, food additives, health foods, special nutrition, CDC dengue/influenza/TB/imported cases (16 sources).",
                        "default": true
                    },
                    "includeCompliance": {
                        "title": "Include compliance & regulatory data",
                        "type": "boolean",
                        "description": "Search FDA food safety (HACCP, pesticides, GMO, cosmetics), kindergarten directory, MOENV permits/emissions/violations/EIA, NPO registry, TWSE ESG, food regulations, and excellent restaurants (22 sources).",
                        "default": false
                    },
                    "includeEnvironment": {
                        "title": "Include environmental monitoring",
                        "type": "boolean",
                        "description": "Search real-time and near-real-time environmental data: AQI air quality, PM2.5 fine particles, UV index, river water quality, groundwater quality (5 sources).",
                        "default": false
                    },
                    "maxResultsPerSource": {
                        "title": "Max results per source",
                        "minimum": 1,
                        "maximum": 200,
                        "type": "integer",
                        "description": "Maximum records to return per data source (gateway caps at 200).",
                        "default": 50
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
