# 🇹🇼 Taiwan MOEA Company Registry · 商工登記統一編號查詢 (`nexgendata/taiwan-moea-company-registry`) Actor Pull Taiwan corporate registry records (公司登記) from the MOEA Department of Commerce Government Company Information System (GCIS) keyless OData endpoint — 統一編號 lookup, capital, registration date, status, address, industry codes, representative. - **URL**: https://apify.com/nexgendata/taiwan-moea-company-registry.md - **Developed by:** [NexGenData](https://apify.com/nexgendata) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $20.00 / 1,000 company 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 MOEA Company Registry — GCIS Business Entity Lookup > **Look up any Taiwan company by 統一編號 (unified business number) — name, registration date, status, and full MOEA industry-code list — from the keyless GCIS OData endpoint.** The lightweight slice of the data that powers `findbiz.nat.gov.tw`, but as clean JSON, programmatically queryable, no key, no captcha, no Cloudflare. The Ministry of Economic Affairs Department of Commerce **Government Company Information System (GCIS / 商工登記公示資料查詢服務)** is the statutory corporate registry for Taiwan under **Company Act §393**. Every limited company, share-issuing corporation, and branch office incorporated in Taiwan is publicly listed here with capital, registration date, registered address, industry classification, and current responsible person. This actor talks **directly to the open-data OData endpoint at `data.gcis.nat.gov.tw/od/data/api/`** — no consumer-portal scraping, no Cloudflare, no captcha, no API key. The endpoint is published under the **Taiwan Open Government Data License v1** (CC BY 4.0 equivalent — full commercial reuse permitted with attribution). --- ### ⚡ What you get Per company record (verified live against TSMC `22099131`, Foxconn `04541302`, MediaTek `84149961`, Uni-President `73251209`, Taiwan Mobile `97176270`, 7-Eleven Taiwan `22555003`, Taiwan Cement `11913502`, Far EasTone `97179430`): | Field | Type | Description | |---|---|---| | `unified_business_number` | string | 8-digit 統一編號 — Taiwan unified business number | | `company_name_tc` | string | 公司名稱 — full registered name in Traditional Chinese | | `company_name_en` | string \| null | English / romanized name (enriched from curated Top-12 (verified live against GCIS at build time) lookup) | | `registration_date` | string \| null | 設立日期 — incorporation date (ROC year auto-converted to ISO YYYY-MM-DD) | | `status` | string | normalized: `active` / `dissolved` / `other` / `unknown` | | `status_code` | string | raw MOEA status code (`01` = 核准設立, `05` = 解散, `08` = 撤銷登記, etc.) | | `status_description_tc` | string | 公司狀態 description in Traditional Chinese | | `industry_codes` | array | 所營事業 — array of `{code, description_tc}` MOEA business item codes (full unabbreviated list, often 100+ entries for large conglomerates) | | `capital_TWD` | int \| null | 資本總額 — authorized capital, only when GCIS surfaces it (see note below) | | `capital_paid_in_TWD` | int \| null | 實收資本額 — paid-in capital, only when GCIS surfaces it (see note below) | | `last_change_date` | string \| null | 最後核准變更日期 — last MOEA approval-of-change date, when present | | `address` | string \| null | 公司所在地 — registered office address, when present | | `city` | string \| null | extracted Taiwan city / county (台北市 / 新竹市 / 高雄市 / 新竹縣 etc.) | | `representative_name` | string \| null | 負責人 — current responsible person (法定代表人), when present | | `source_dataset_oid` | string | GCIS dataset OID `236EE382-4942-41A9-BD03-CA0709025E7C` (auditable provenance) | | `source_url` | string | exact OData URL used for the fetch (reproducible by anyone) | | `fetched_at` | string | UTC ISO 8601 fetch timestamp | **ROC year handling** — Taiwan corporate registries record dates in **民國年 / ROC year format** (0760221 = ROC 76, Feb 21 = 1987-02-21). This actor auto-converts every date to ISO 8601 Gregorian so your downstream pipeline doesn't need to know about the calendar. **Field-availability note** — the keyless GCIS open-data slice (dataset OID `236EE382-4942-41A9-BD03-CA0709025E7C`) surfaces the **statutory disclosure core**: BAN, registered Traditional Chinese name, status code + description, incorporation date, and the **full unabbreviated MOEA industry-code list** (with Traditional Chinese descriptions). The richer fields `capital_TWD`, `address`, `representative_name`, `last_change_date` are returned **only when the upstream record includes them** — the keyless dataset selectively exposes them for some companies, and not others. Where absent, the actor returns `null` rather than fabricating. The fuller capital + address + 負責人 record (with line-by-line authoritative provenance) for any individual company is consultable at `findbiz.nat.gov.tw` (consumer portal, Cloudflare-walled to scrapers but freely usable from a browser). --- ### 🎯 Use cases 1. **B2B SaaS go-to-market in Taiwan** — segment Taiwan target accounts by industry code (CC01080 = electronic components manufacturing for semiconductor TAM), validate trade-name → 統一編號 before outreach, enrich CRM with capital tier (>NT$1B = enterprise, NT$100M-1B = mid-market, ` 之過濾條件**。模糊比對 (`substringof()`, `like`)、公司名稱搜尋皆會回傳 HTTP 400 或結構化中文錯誤 (`$filter參數有誤、請查明後繼續。`)。若需公司名稱搜尋，請至 `findbiz.nat.gov.tw` 取得 8 位數統一編號後再以 `company_id` 輸入本爬蟲。 **資料更新頻率：** GCIS 開放資料每日同步自商業司公司登記主檔；本爬蟲每次執行皆即時抓取最新登記資料 (非快取)。 **法規依據：** 公司法 §393 (法定揭露) · 商業登記法 §19 · 政府資訊公開法 §7 · 個人資料保護法 §6 (法人資料非個資範疇，現任負責人姓名為法定揭露項目)。 *** ### 🛠 How it works 1. **Slug resolution** — `company_id` (8-digit 統一編號) takes precedence; falls back to a curated Top-12 (verified live against GCIS at build time) Taiwan-company lookup (Traditional Chinese, English, common romanization → BAN) for `company_name_filter`. 2. **Single OData GET per company** — `GET https://data.gcis.nat.gov.tw/od/data/api/236EE382-4942-41A9-BD03-CA0709025E7C?$format=json&$filter=Business_Accounting_NO eq `. Polite User-Agent with contact email. 20 s timeout. 0.4 s gap between requests (well under the 1 req/sec gentle-pace convention). 3. **Field normalization** — raw GCIS keys (`Business_Accounting_NO`, `Company_Name`, `Capital_Stock_Amount`, `Paid_In_Capital_Amount`, `Company_Setup_Date`, `Company_Status`, `Company_Status_Desc`, `Company_Location`, `Responsible_Name`, `Cmp_Business[]`) mapped to a stable 16-field schema. ROC date format (民國年 `0760221`) auto-converted to ISO `1987-02-21`. Status code (`01`/`03`/`04`/`05`/`06`/`07`/`08`/`10`) normalized to `active` / `dissolved` / `other`. 4. **Post-fetch filters** — industry code, city, status applied client-side (the keyless endpoint doesn't support server-side filtering on these fields). 5. **Graceful guidance rows** — invalid BAN format, unresolved name, or fetch errors emit a structured `{guidance: true, kind, message}` row rather than silently returning zero records. The actor never crashes on bad input. *** ### ❓ FAQ **Q: Why is `company_name_filter` limited to a Top-60 curated list?** A: The keyless GCIS OData endpoint **only supports `Business_Accounting_NO eq <8-digit>` as a filter** — free-text name search returns HTTP 400 or `$filter參數有誤、請查明後繼續。`. The MOEA consumer portal `findbiz.nat.gov.tw` that supports free-text name search is **Cloudflare-walled to datacenter IPs** (verified 403 from the build host). To stay within the keyless / no-Cloudflare lane, this actor ships a curated lookup of well-known Taiwan companies (TSMC / Foxconn / MediaTek / Uni-President / Taiwan Mobile / Far EasTone / 7-Eleven Taiwan / Taiwan Cement etc.) for name → BAN resolution. **Each curated entry is verified live against GCIS at build time** — we only ship name-to-BAN mappings whose GCIS-returned `Company_Name` matches the canonical entity. For any other company, pass the 8-digit `company_id` directly — that path is unrestricted across the GCIS registry. **Q: How do I find a company's 8-digit 統一編號?** A: Free at `findbiz.nat.gov.tw` (MOEA business search portal) — type the company name, the result page shows the 統一編號. That's the value to pass as `company_id`. **Q: What does `status_code` mean?** A: MOEA status codes per the Company Act registration framework: `01` = 核准設立 (active), `03` = 撤銷 (rescinded), `04` = 廢止 (abolished), `05` = 解散 (dissolved), `06` = 命令解散 (compulsory dissolution by command), `07` = 裁定解散 (court-ordered dissolution), `08` = 撤銷登記 (registration revoked), `10` = 廢止公司登記 (company registration abolished). This actor normalizes them into `active` / `dissolved` / `other` for downstream filtering. **Q: Why are `capital_TWD`, `address`, and `representative_name` often null for big TWSE-listed companies?** A: The keyless GCIS open-data dataset (OID `236EE382-4942-41A9-BD03-CA0709025E7C`) selectively publishes these fields — they appear on the records of many smaller / mid-cap companies but are deliberately blanked on the largest TWSE-listed conglomerates (TSMC, Foxconn, MediaTek, etc.) in this slice. The fuller capital / address / 負責人 record for any individual company is consultable at `findbiz.nat.gov.tw` (consumer portal). The actor returns `null` rather than fabricating — `industry_codes` and `registration_date` are always present, and the source\_url field is auditable for any downstream consumer that wants to cross-check. **Q: Are dissolved/廢止 companies included?** A: Default `status_filter: "active"` excludes them. Pass `status_filter: "all"` or `status_filter: "dissolved"` to include / target them — useful for AML/sanctions screening and trade-name conflict checks. **Q: Does the actor surface representatives' personal info?** A: Only the **registered 負責人 (responsible person) name** — a statutorily disclosed field under Company Act §393 (法人登記事項). No phone, no email, no ID number. Treating the 負責人 name as personal data is incorrect under Taiwan's 個人資料保護法 §6 — it's a corporate-registration disclosure item. *** ### ⚖️ Legal & data sources - **Source:** Ministry of Economic Affairs Department of Commerce **Government Company Information System (商工登記公示資料查詢服務 / GCIS)** at `data.gcis.nat.gov.tw/od/data/api/236EE382-4942-41A9-BD03-CA0709025E7C`. Dataset OID `236EE382-4942-41A9-BD03-CA0709025E7C` (`公司登記 / Company Registration`). - **License:** **政府資料開放授權條款 1.0** (Taiwan Open Government Data License v1) — equivalent to Creative Commons Attribution 4.0 International. Commercial reuse permitted with attribution to 經濟部商業司. - **Statutory basis:** Company Act §393 (法定揭露 / statutory disclosure obligation), Business Registration Act §19, Freedom of Government Information Act §7. - **No PII:** Only statutorily disclosed corporate-registration fields (BAN, name, capital, address, status, industry codes, 負責人 name). No personal phone numbers, emails, ID numbers, or shareholder lists. - **Polite identification:** Every request carries `User-Agent: NexGenData Taiwan MOEA GCIS Actor (hello@thenextgennexus.com)` and a 0.4 s pace gap. - **Findbiz consumer portal NOT touched:** `findbiz.nat.gov.tw` (the Cloudflare-walled consumer UI) is deliberately not scraped — this actor only uses the open-data API path. *** ### 🔗 Related Actors Cross-jurisdictional corporate-registry coverage from the NexGenData fleet — pair these for global counterparty diligence: - 🇸🇬 **[Singapore ACRA Company Lookup](https://apify.com/nexgendata/singapore-acra-company-lookup)** — Singapore Accounting & Corporate Regulatory Authority BizFile registry lookup. - 🇮🇳 **[India MCA Companies Registry (via OGD)](https://apify.com/nexgendata/ogd-india-companies-registry)** — India Ministry of Corporate Affairs registry via the Open Government Data Platform. - 🌐 **[Business Registration Lookup](https://apify.com/nexgendata/business-registration-lookup)** — multi-jurisdiction US + EU + APAC corporate registry aggregator. - 🇯🇵 **[Japan EDINET Insider Filings](https://apify.com/nexgendata/japan-edinet-insider-filings)** — Japan FSA EDINET large-shareholder & insider disclosures (XBRL). - 🇹🇼 **[TWSE Stock Screener](https://apify.com/nexgendata/twse-stock-screener)** — Taiwan Stock Exchange + TPEx mainboard equity screener (TSE + OTC quotes). - 🇰🇷 **[KOSPI Stock Screener](https://apify.com/nexgendata/kospi-stock-screener)** — Korea Exchange KOSPI / KOSDAQ equity screener. - 🇯🇵 **[TSE Japan Stock Screener](https://apify.com/nexgendata/tse-japan-stock-screener)** — Tokyo Stock Exchange equity screener (Prime / Standard / Growth). - 🌏 **[APAC IPO Calendar Sweep](https://apify.com/nexgendata/apac-ipo-calendar-sweep)** — Japan + Korea + Hong Kong + Taiwan IPO pipeline. - 🧰 **[Company Enrichment Tool](https://apify.com/nexgendata/company-enrichment-tool)** — multi-source company-data enrichment (registries + web). *** ### 🆘 Troubleshooting - **`guidance.kind=name_not_resolved`** — your `company_name_filter` isn't in the curated Top-12 (verified live against GCIS at build time). Look up the 8-digit 統一編號 at `findbiz.nat.gov.tw` and pass it as `company_id`. Reach out at hello@thenextgennexus.com if you'd like specific companies added to the curated lookup. - **`guidance.kind=invalid_company_id`** — Taiwan unified business numbers are exactly 8 digits. Strip dashes / spaces / leading characters. Leading zeros matter: pass `04541302` (Foxconn), not `4541302`. - **`guidance.kind=fetch_error`** — transient GCIS server issue (the upstream sometimes returns `系統忙碌中、請稍後再試一次` under load). Re-run the actor; per-record fetch is idempotent. - **`status` returns `unknown`** — some older registry entries (pre-1980 incorporation) have absent or non-standard `Company_Status` codes. The full raw value is preserved in `status_code` for downstream inspection. *** *Built by [NexGenData](https://apify.com/nexgendata) — programmatic access to public corporate-registry, financial-disclosure, and government-procurement data across APAC + EU + US. Contact: hello@thenextgennexus.com.* # Actor input Schema ## `company_name_filter` (type: `string`): Optional. Looks up a Taiwan company by name from the curated lookup (TSMC, Foxconn, MediaTek, Uni-President, Taiwan Mobile, Far EasTone, 7-Eleven Taiwan, Taiwan Cement, etc. — verified live against GCIS) in Traditional Chinese (台積電), English (TSMC), or common romanization (tsmc). The keyless GCIS OData endpoint does NOT support free-text name search — only Business\_Accounting\_NO eq <8-digit>. If you need a company outside the curated list, pass company\_id with the 8-digit 統一編號 instead. Unmatched names emit a structured guidance row pointing at company\_id. ## `company_id` (type: `string`): Optional. The 8-digit Taiwan unified business number (統一編號) — e.g. 22099131 (TSMC), 04541302 (Foxconn), 84149961 (MediaTek). When set, this is the primary lookup key — GCIS returns one company per BAN. Leading zeros are auto-padded if you pass a shorter integer string. To look up your target company's BAN, search free at findbiz.nat.gov.tw (MOEA business search portal). ## `industry_code_filter` (type: `string`): Optional. Filter results post-fetch by MOEA business item code (e.g. CC01080 = 電子零組件製造業 / electronic components manufacturing) or Traditional Chinese industry-name keyword (e.g. 半導體, 銀行, 航運). The GCIS OData endpoint does NOT support server-side filtering on industry — this filter is applied client-side after fetching the curated top-N companies. ## `city_filter` (type: `string`): Optional. Filter results post-fetch by Taiwan city or county (台北市, 新北市, 新竹市, 新竹縣, 高雄市, 台中市, 台南市, 桃園市, etc.). Matched against the company's registered address (Company\_Location). 臺/台 variants normalized. ## `status_filter` (type: `string`): Filter by registration status. 'active' = 核准設立 only (default). 'dissolved' = 撤銷/廢止/解散/裁定解散/命令解散. 'all' = no status filter (include both active and dissolved entities). ## `max_records` (type: `integer`): Maximum number of company records to emit (1–2000). When neither company\_name\_filter nor company\_id is set, the actor samples the curated well-known Taiwan companies (TSMC, Foxconn, MediaTek, Uni-President, etc.) up to this cap. When company\_id is set, exactly one record is fetched. ## Actor input object example ```json { "company_name_filter": "台積電", "status_filter": "active", "max_records": 200 } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "company_name_filter": "台積電", "company_id": "", "industry_code_filter": "", "city_filter": "", "status_filter": "active", "max_records": 200 }; // Run the Actor and wait for it to finish const run = await client.actor("nexgendata/taiwan-moea-company-registry").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "company_name_filter": "台積電", "company_id": "", "industry_code_filter": "", "city_filter": "", "status_filter": "active", "max_records": 200, } # Run the Actor and wait for it to finish run = client.actor("nexgendata/taiwan-moea-company-registry").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 '{ "company_name_filter": "台積電", "company_id": "", "industry_code_filter": "", "city_filter": "", "status_filter": "active", "max_records": 200 }' | apify call nexgendata/taiwan-moea-company-registry --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=nexgendata/taiwan-moea-company-registry", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "🇹🇼 Taiwan MOEA Company Registry · 商工登記統一編號查詢", "description": "Pull Taiwan corporate registry records (公司登記) from the MOEA Department of Commerce Government Company Information System (GCIS) keyless OData endpoint — 統一編號 lookup, capital, registration date, status, address, industry codes, representative.", "version": "0.0", "x-build-id": "1izGBcGzaMEpiaw7I" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nexgendata~taiwan-moea-company-registry/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nexgendata-taiwan-moea-company-registry", "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/nexgendata~taiwan-moea-company-registry/runs": { "post": { "operationId": "runs-sync-nexgendata-taiwan-moea-company-registry", "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/nexgendata~taiwan-moea-company-registry/run-sync": { "post": { "operationId": "run-sync-nexgendata-taiwan-moea-company-registry", "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": { "company_name_filter": { "title": "Company name (Traditional Chinese, English, or romanization)", "type": "string", "description": "Optional. Looks up a Taiwan company by name from the curated lookup (TSMC, Foxconn, MediaTek, Uni-President, Taiwan Mobile, Far EasTone, 7-Eleven Taiwan, Taiwan Cement, etc. — verified live against GCIS) in Traditional Chinese (台積電), English (TSMC), or common romanization (tsmc). The keyless GCIS OData endpoint does NOT support free-text name search — only Business_Accounting_NO eq <8-digit>. If you need a company outside the curated list, pass company_id with the 8-digit 統一編號 instead. Unmatched names emit a structured guidance row pointing at company_id." }, "company_id": { "title": "Unified Business Number (統一編號, 8 digits)", "type": "string", "description": "Optional. The 8-digit Taiwan unified business number (統一編號) — e.g. 22099131 (TSMC), 04541302 (Foxconn), 84149961 (MediaTek). When set, this is the primary lookup key — GCIS returns one company per BAN. Leading zeros are auto-padded if you pass a shorter integer string. To look up your target company's BAN, search free at findbiz.nat.gov.tw (MOEA business search portal)." }, "industry_code_filter": { "title": "Industry code or industry-name keyword (MOEA business item)", "type": "string", "description": "Optional. Filter results post-fetch by MOEA business item code (e.g. CC01080 = 電子零組件製造業 / electronic components manufacturing) or Traditional Chinese industry-name keyword (e.g. 半導體, 銀行, 航運). The GCIS OData endpoint does NOT support server-side filtering on industry — this filter is applied client-side after fetching the curated top-N companies." }, "city_filter": { "title": "Taiwan city / county (Traditional Chinese)", "type": "string", "description": "Optional. Filter results post-fetch by Taiwan city or county (台北市, 新北市, 新竹市, 新竹縣, 高雄市, 台中市, 台南市, 桃園市, etc.). Matched against the company's registered address (Company_Location). 臺/台 variants normalized." }, "status_filter": { "title": "Company status", "enum": [ "active", "dissolved", "all" ], "type": "string", "description": "Filter by registration status. 'active' = 核准設立 only (default). 'dissolved' = 撤銷/廢止/解散/裁定解散/命令解散. 'all' = no status filter (include both active and dissolved entities).", "default": "active" }, "max_records": { "title": "Maximum records to push", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum number of company records to emit (1–2000). When neither company_name_filter nor company_id is set, the actor samples the curated well-known Taiwan companies (TSMC, Foxconn, MediaTek, Uni-President, etc.) up to this cap. When company_id is set, exactly one record is fetched.", "default": 200 } } }, "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 } } } } } } } } } } ```