# Rtr Pbs — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Check real-time road conditions across Taiwan's highways and regions to plan safer routes and avoid traffic disruptions. Get live updates on accidents, congestion, and hazardous conditions reported by the Police Broadcasting Service.

**Category:** Maps & Geospatial | **Website:** [rtr.pbs.gov.tw/](https://rtr.pbs.gov.tw/) | **Docs:** [parse.bot/marketplace/9b9cf401-3557-4c48-8b58-ef0373088edd/rtr-pbs-gov-tw-api](https://parse.bot/marketplace/9b9cf401-3557-4c48-8b58-ef0373088edd/rtr-pbs-gov-tw-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-rtr-pbs-gov-tw-api-9b9cf401/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_road_conditions

Fetches all real-time road conditions from the Police Broadcasting Service. Returns records ordered by most recent update time. The limit parameter caps total items returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rtr-pbs-gov-tw-api-9b9cf401/get_road_conditions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### get_road_conditions_by_highway

Fetches road conditions filtered by a specific highway name via keyword search. Returns records whose location or info fields match the highway name.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `highway` | string | Yes | Highway name to search for (e.g. 國道1號, 國道3號). |
| `limit` | integer | No | Maximum number of results to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rtr-pbs-gov-tw-api-9b9cf401/get_road_conditions_by_highway \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"highway":"<string>","limit":"<integer>"}'
```

### get_road_conditions_by_region

Fetches road conditions filtered by region. Returns records for the specified area of Taiwan. Supports both Chinese region names and single-letter codes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return. |
| `region` | string | Yes | Region name or code. Accepted values: 北部, 中部, 南部, 東部, 國道, 全區, N, M, S, E, F. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rtr-pbs-gov-tw-api-9b9cf401/get_road_conditions_by_region \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","region":"<string>"}'
```