rtr.pbs.gov.tw APIrtr.pbs.gov.tw ↗
Access real-time road conditions across Taiwan from the Police Broadcasting Service. Filter by region or highway. Live accident, congestion, and hazard data.
curl -X GET 'https://api.parse.bot/scraper/0ffc8282-b83d-4780-b5e0-10ac06bc8cff/get_road_conditions?limit=3' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetches all real-time road conditions from the Police Broadcasting Service. Returns paginated results ordered by most recent update time.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results to return. |
{
"type": "object",
"fields": {
"data": "array of road condition records, each containing number, category, uptime, date, time, source, area, location, and info",
"status": "string indicating success"
},
"sample": {
"data": [
{
"area": "北部",
"date": "2026-05-11",
"info": "新北市-鶯歌區中山高架橋往國華路方向.外+部分人行道.隔音牆增設工程.時間:5/12~5/20.每日0930~1600(遇雨順延)",
"time": "17:46",
"number": "11505110279",
"source": "新北市政府養護工程處",
"uptime": "今天 15:01",
"category": "道路施工",
"location": "新北市-鶯歌區"
}
],
"status": "success"
}
}About the rtr.pbs.gov.tw API
The PBS Taiwan Road Conditions API exposes live traffic and road incident data from the Police Broadcasting Service (rtr.pbs.gov.tw) across 3 endpoints. Each record returns 8 structured fields including category, area, location, and info describing the condition. The get_road_conditions_by_region endpoint lets you filter by named region such as 北部 or 南部, while get_road_conditions_by_highway narrows results to a specific highway like 國道1號.
What the API Returns
All three endpoints return arrays of road condition records sourced from the Police Broadcasting Service's real-time feed, aggregated via road.ioi.tw. Every record includes: number (record identifier), category (incident type), uptime (freshness indicator), date, time, source (reporting agency), area (geographic area), location (specific road location), and info (free-text description of the condition). Results are ordered by most recent update time.
Filtering by Region and Highway
get_road_conditions_by_region accepts a region parameter using either Chinese region names (北部, 中部, 南部, 東部, 國道, 全區) or their single-letter codes (N, M, S, E, F). This makes it straightforward to isolate conditions for a specific part of Taiwan. get_road_conditions_by_highway accepts a highway string — for example 國道1號 or 國道3號 — and performs a keyword match against records, useful when monitoring a specific freeway corridor.
Pagination and Volume Control
All three endpoints accept an optional limit integer parameter that caps the number of records returned. When omitted, the default result set is returned ordered by recency. There is no explicit offset or cursor parameter in the current API surface, so limit is the primary tool for controlling response volume. The get_road_conditions endpoint fetches the full cross-Taiwan feed without any region or highway filter applied.
- Display a live incident map for Taiwan highways using the
areaandlocationfields - Send push alerts to drivers when new conditions appear on a watched highway via
get_road_conditions_by_highway - Build a regional dashboard for northern or southern Taiwan using
get_road_conditions_by_regionwith 北部 or 南部 - Log historical road condition records by polling the API and storing
date,time, andcategoryfields - Filter and surface only freeway incidents by querying the 國道 region code
- Aggregate incident frequency by
categorytype across all regions to identify recurring hazard patterns - Feed real-time road data into a route-planning tool to flag active disruptions along a selected corridor
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does the Police Broadcasting Service provide an official developer API?+
What does the `info` field contain, and is it machine-parseable?+
info field is a free-text Chinese-language string describing the specific road condition — for example, lane closures, accident details, or hazard descriptions. It is not structured into sub-fields, so parsing specific attributes from it requires your own text processing.Does the API cover city streets and provincial roads, or only national freeways?+
Is there a way to paginate through results beyond the first page?+
limit parameter to cap result count but does not include an offset, page number, or cursor parameter. All three endpoints return results ordered by most recent update time, so the freshest records are always at the top of the response. You can fork the API on Parse and revise it to add offset-based pagination if your use case requires deeper result sets.Can I filter conditions by incident category, such as accidents only?+
category field is present in every response record and can be filtered client-side after retrieval. You can fork the API on Parse and revise it to add a category query parameter that pre-filters the result set server-side.