Taiwan Company Registry — GCIS UBN Lookup

Look up Taiwan companies by Unified Business Number (UBN / 統一編號) using the official GCIS OData API. Returns company name, status, setup date, and business items as structured JSON. No login, no token, no scraping.

---

What this Actor does

This Actor accepts one or more Taiwan Unified Business Numbers (UBN / 統一編號) and queries the Taiwan GCIS OData API for each number. Results are pushed to an Apify Dataset as English-key JSON records.

For each UBN, the Actor returns:

• Company name in Traditional Chinese
• Company status code and description
• Company status normalized to English (Active / Dissolved / Revoked)
• Setup date in original ROC calendar format
• Setup date converted to ISO 8601 format
• Business items, including industry codes and descriptions in Traditional Chinese
• A found flag indicating whether the UBN was matched
• Source metadata: sourceName, sourceUrl, retrievedAt

---

Output limits and cost control

This Actor supports maxItems to limit the number of dataset records produced in a run.

The Actor also respects Apify's paid dataset item limit when it is provided by the platform. The effective output limit is the minimum of:

• maxItems
• Apify's paid dataset item limit, if present
• the Actor's internal hard cap

This helps keep runs predictable and prevents the Actor from producing more paid dataset items than intended.

Input

{
  "businessAccountingNumbers": ["20828393", "22099131"],
  "maxItems": 100
}

Field	Type	Required	Description
businessAccountingNumbers	array of strings	Yes	Taiwan Unified Business Numbers (UBN / 統一編號). 1–100 values per run.
maxItems	integer	No	Maximum number of dataset records to output. Default: 100. Maximum: 1000.

Notes:

• Each value should be an 8-digit string.
• Values shorter than 8 digits are left-padded with zeros automatically.
• Maximum 100 numbers per run in v0.
• maxItems limits how many dataset records are produced, regardless of how many UBNs are provided.

---

Output

Each UBN produces one record in the Dataset, unless the run reaches the effective output limit.

Found

{
  "businessAccountingNumber": "22099131",
  "found": true,
  "companyNameZh": "台灣積體電路製造股份有限公司",
  "companyStatus": "01",
  "companyStatusDesc": "核准設立",
  "companyStatusEn": "Active",
  "setupDateRoc": "0760221",
  "setupDateIso": "1987-02-21",
  "businessItems": [
    {
      "seq": "0001",
      "code": "CC01080",
      "descZh": "電子零組件製造業"
    }
  ],
  "sourceName": "Taiwan GCIS OData API",
  "sourceUrl": "https://data.gcis.nat.gov.tw/od/data/api/236EE382-4942-41A9-BD03-CA0709025E7C",
  "retrievedAt": "2026-06-30T14:38:24.448Z"
}

Not found

{
  "businessAccountingNumber": "00000000",
  "found": false,
  "sourceName": "Taiwan GCIS OData API",
  "sourceUrl": "https://data.gcis.nat.gov.tw/od/data/api/236EE382-4942-41A9-BD03-CA0709025E7C",
  "retrievedAt": "2026-06-30T14:38:24.448Z"
}

---

What this Actor does not do

This Actor is intentionally limited.

It does not:

• Scrape websites
• Use proxies
• Use browser automation
• Require login, cookies, or tokens
• Enrich records from third-party sources
• Collect representative names
• Collect directors or shareholders
• Collect phone numbers
• Collect emails
• Collect personal profile data
• Generate sales messages
• Crawl external websites

---

Data source

This Actor uses the official Taiwan GCIS OData API.

Source:

Taiwan GCIS OData API
https://data.gcis.nat.gov.tw/od/data/api/236EE382-4942-41A9-BD03-CA0709025E7C

The Actor stores this source metadata in each Dataset record.

---

Limitations

• This Actor supports UBN lookup only.
• Company name search is not supported in v0.
• Additional GCIS endpoints are intentionally out of scope for v0.
• Business item descriptions (descZh) are returned in Traditional Chinese as provided by the source. No English translation is performed in v0.
• The Actor queries one UBN per API request. For large batches, total run time scales with the number of inputs.
• The GCIS API may be temporarily unavailable. Failed requests are counted in errorCount in the run summary.

---

Run summary

After each run, a summary is saved to the Key-Value Store under the key RUN_SUMMARY.

{
  "totalInput": 2,
  "requestedMaxItems": 100,
  "effectiveMaxItems": 100,
  "actorMaxPaidDatasetItems": 16979,
  "totalItems": 2,
  "foundCount": 2,
  "notFoundCount": 0,
  "errorCount": 0,
  "skippedDueToLimit": 0,
  "retrievedAt": "2026-06-30T14:38:24.448Z"
}

The exact value of actorMaxPaidDatasetItems may vary by run depending on Apify's paid dataset item limit.

Summary fields:

Field	Description
totalInput	Number of UBNs provided in the input.
requestedMaxItems	Requested output limit from maxItems, defaulting to 100 if omitted.
effectiveMaxItems	Final output limit used by the Actor.
actorMaxPaidDatasetItems	Apify paid dataset item limit, if provided by the platform.
totalItems	Number of Dataset records actually produced.
foundCount	Number of matched UBN records.
notFoundCount	Number of UBNs not found in the source API.
errorCount	Number of API lookup errors.
skippedDueToLimit	Number of input UBNs skipped after the output limit was reached.
retrievedAt	Timestamp when the summary was written.

---

Development status

• v0 is implemented as a UBN lookup Actor.
• The Actor currently supports lookup by Business Accounting Number only.
• Company name search and additional GCIS endpoints are intentionally out of scope for v0.
• The Actor is published and maintained as a conservative official-API lookup Actor.