# Taiwan Government Data API (`lentic_clockss/taiwan-data-search`) Actor Search 53 Taiwan government data sources — TWSE/TPEx stock market, FDA medicines and food safety, CDC disease surveillance, MOENV air quality (AQI, PM2.5, UV), HACCP compliance, and NPO registry. Official data from Taiwan regulatory agencies. - **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:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 official Taiwan government data sources** in a single API call — TWSE and TPEx stock market data, FDA medicines and food safety compliance, CDC disease surveillance, MOENV environmental monitoring (AQI, PM2.5, UV index), HACCP certification, kindergarten directories, and NPO registries. All data comes directly from Taiwan government agencies through the SIP Public Data Gateway. ### What is Taiwan Government Data Search? Taiwan Government Data Search is an Apify Actor that queries official Taiwan government databases across business, health, compliance, and environmental domains. Instead of navigating TWSE, TFDA, CDC, and MOENV portals separately, you search them all at once — in Chinese or English. The Actor calls the **SIP Public Data Gateway** — a unified API that normalizes responses from 53 Taiwan data products. No browser, no scraping — just HTTPS API calls to official government sources. ### Why use Taiwan Government Data Search? - **One search, 53 sources** — Query stock market, pharmaceutical, disease surveillance, and environmental data simultaneously - **Official government data** — All sources are public databases from TWSE, TFDA, CDC Taiwan, and MOENV - **Chinese and English support** — Search in Traditional Chinese (台積電) or English (TSMC) — SIP handles both - **Real-time environmental data** — AQI, PM2.5, UV index from MOENV monitoring stations across Taiwan - **Compliance coverage** — HACCP certifications, pesticide bans, GMO approvals, food safety training, ESG governance - **No upstream API keys** — SIP handles all government API authentication; you only need one SIP key #### Use cases | Who | What | |-----|------| | **Equity researchers** | Access TWSE/TPEx listed company data, monthly revenue, dividends, PE ratios | | **Pharmaceutical companies** | Search FDA drug safety alerts, controlled substances, clinical trial statistics | | **Food industry compliance** | Monitor HACCP sanctions, pesticide limits, GMO approvals, food additive licenses | | **Environmental consultants** | Track AQI, PM2.5, industrial emissions, EIA reports, environmental violations | | **Healthcare analysts** | Access CDC dengue, influenza, TB surveillance data and FDA pharmacy directories | | **ESG analysts** | Query TWSE ESG governance data, GHG emissions, environmental permits | ### What data can Taiwan Government Data Search extract? | Source | Data type | Example fields | |--------|-----------|----------------| | TWSE listed companies | Taiwan Stock Exchange companies | company_name, stock_code, industry | | TWSE monthly revenue | Listed company revenue reports | company, revenue, period | | TWSE dividends | Cash and stock dividend data | company, dividend_type, amount | | TPEx listed companies | OTC market companies | company_name, stock_code | | TPEx monthly revenue | OTC company revenue | company, revenue, period | | FDA medicines/pharmacies | Licensed pharmacies and drug data | pharmacy_name, address, license | | FDA GMP factories | GMP-certified manufacturers | factory_name, product_type, city | | FDA drug safety alerts | Drug safety notifications | drug_name, alert_type, date | | FDA HACCP manufacturers | HACCP-certified food businesses | company, category, cert_date | | FDA HACCP sanctions | Food safety violations | company, violation, penalty | | FDA pesticide limits/bans | Pesticide MRL and banned substances | substance, crop, limit_ppm | | FDA GMO approved | Approved GMO products | product, applicant, approval_date | | CDC influenza | Weekly influenza surveillance | week, cases, positive_rate | | CDC dengue | Recent dengue fever cases | district, cases, onset_date | | CDC tuberculosis | TB surveillance data | county, cases, rate | | MOENV AQI | Real-time air quality index | station, aqi, pm25, pm10, o3 | | MOENV PM2.5 | Fine particulate monitoring | station, pm25, date | | MOENV UV index | Ultraviolet radiation index | station, uv_index, date | | MOENV water quality | River and groundwater monitoring | site, parameter, value | | MOENV violations | Environmental violations | company, violation_type, fine | | MOENV GHG emissions | Greenhouse gas emission reports | company, co2e, sector | | Kindergarten directory | Licensed kindergartens | name, city, capacity | | NPO registry | Registered nonprofits | org_name, type, city | ### How to search Taiwan data 1. Open the Actor in Apify Console 2. Enter search terms in Chinese or English (e.g. "台積電", "TSMC", "口罩") 3. Select data categories — business and health are enabled by default 4. Click **Start** — the Actor queries all enabled sources in parallel 5. Download results as JSON, CSV, or Excel #### Example input ```json { "searchTerms": ["台積電", "鴻海"], "includeBusiness": true, "includeHealth": false, "includeCompliance": false, "includeEnvironment": false, "maxResultsPerSource": 50 } ```` ### Output ```json { "company_name": "台灣積體電路製造股份有限公司", "stock_code": "2330", "industry": "半導體業", "_product_id": "tw_twse_listed_companies", "_source": "twse_listed_companies", "_search_term": "台積電", "_collected_at": "2026-04-08T14:00:00Z" } ``` ### How much does it cost? Pay-per-event pricing at $3.00 per 1,000 records returned. - **Quick stock lookup** (1 term, business only): ~$0.01–0.05 - **Comprehensive scan** (5 terms, all 53 sources): ~$1.00–5.00 No browser overhead. Control costs with `maxResultsPerSource`. ### Data sources (53 Taiwan products) | Category | Sources | Count | |----------|---------|-------| | Business & stock market | TWSE listed/revenue/dividends/income, TPEx listed/revenue/PE, customs brokers, labor brokers | 9 | | Health & pharma | FDA medicines/pharmacies/GMP/GDP/clinical trials/drug alerts/health foods/additives/nutrition, CDC dengue/influenza/TB/imported cases | 16 | | Compliance & regulatory | FDA HACCP/pesticides/GMO/cosmetics/food safety, MOENV permits/emissions/violations/EIA, kindergarten, NPO, ESG, food regulations, restaurants | 22 | | Environmental monitoring | AQI real-time, PM2.5, UV index, river water quality, groundwater quality | 5 | ### FAQ **Does it support Chinese search terms?** Yes. SIP passes search terms directly to Taiwan government APIs. Most APIs support Traditional Chinese (繁體中文). English terms also work for many sources (e.g. company names, chemical substances). **How real-time is the environmental data?** MOENV AQI and PM2.5 update hourly. UV index updates daily. Water quality data is periodic (monthly/quarterly). **What about TWSE after-hours data?** TWSE/TPEx data reflects the latest published information from the exchanges. Revenue data updates monthly. Dividend and PE data update after corporate announcements. **Can I monitor food safety violations?** Yes. Enable the Compliance category and search for a company name or food product. HACCP sanctions, pesticide violations, and import inspection results are all searchable. ### Use as MCP Tool (AI Agent Integration) This Actor works as an MCP tool — AI agents (Claude, GPT, Cursor) can discover and run it automatically. #### Quick setup (Claude Desktop / Cursor / VS Code) Add to your MCP config: ```json { "mcpServers": { "apify": { "url": "https://mcp.apify.com", "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" } } } } ``` Then ask your AI: *"Search for 台積電 in Taiwan government databases"* #### Direct API call ```python from apify_client import ApifyClient client = ApifyClient("YOUR_APIFY_TOKEN") run = client.actor("lentic_clockss/taiwan-data-search").call( run_input={"searchTerms": ["台積電"], "maxResultsPerSource": 50} ) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) ``` ### Other Data API Actors - [US Business Entity Data API](https://apify.com/lentic_clockss/us-business-entity-search) - [EU Business & Company Registry API](https://apify.com/lentic_clockss/eu-business-data-search) - [Japan Government Data API](https://apify.com/lentic_clockss/japan-government-data-search) - [Singapore Government Data API](https://apify.com/lentic_clockss/singapore-government-data-search) # 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 '' with your token const client = new ApifyClient({ 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 '' with your token. client = ApifyClient("") # 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 " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Taiwan Government Data API", "description": "Search 53 Taiwan government data sources — TWSE/TPEx stock market, FDA medicines and food safety, CDC disease surveillance, MOENV air quality (AQI, PM2.5, UV), HACCP compliance, and NPO registry. Official data from Taiwan regulatory agencies.", "version": "0.1", "x-build-id": "bvVvA3bQQIt0BVF2q" }, "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", "required": [ "searchTerms" ], "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.", "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 } } } } } } } } } } ```