Korea Libraries KR

Export one bounded page of official Korean library records for finding opening hours, closed days and reading seats. This Actor uses the national library standard dataset and its OpenAPI, not a library website scraper. The DCAT metadata says 이용허락범위 제한 없음.

Input

No API key needed: the Actor uses its approved key for this OpenAPI by default. Optionally bring your own approved serviceKey to use your own quota. The catalog lists free automatic approval, 10,000 development requests and the fixed HTTPS endpoint https://api.data.go.kr/openapi/tn_pubr_public_lbrry_api. Your optional key uses the secret input field; neither key is bundled, logged or written to the dataset. Encoded and decoded keys are accepted. Working example: {"maxItems":1,"pageNo":0}. maxItems defaults to 1 (1–200), pageNo defaults to 0 (0–1000), and optional libraryName and province use the documented LBRRY_NM and CTPRVN_NM filters. Exactly one source page is requested per run; the approved daily quota is shared by no-key users and quota exhaustion fails explicitly.

Output

Each dataset item contains name, libraryType, roadAddress, latitude, longitude, closedDays, weekday/Saturday/holiday opening and closing times, readingSeats and officialSource. Missing or invalid optional numbers become null; time and closed-day descriptions remain as published, including 00:00 values. There is no generated library ID: the official response field table has no ID. Personal phone numbers and unrelated source fields are discarded. The dataset describes source records, not live availability or a guaranteed update schedule.

An empty page emits no dataset records and no charge event. API authentication, quota, HTTP, JSON and response-shape failures fail explicitly without disclosing a key.

Pricing

Pay per event records-100: USD $0.10 for each started block of 100 emitted rows (1–100 = one event, 101–200 = two, 0 = none). The source API itself is free; this covers Apify normalization/execution. Accepted events are not settled payments. See docs/pricing.md.

Local checks

Run npm install, npm test, npm run typecheck:tests, npm run build, and apify validate-schema in this directory. Fixtures are synthetic records using field names and example values from the official response table; the JSON envelope is based on the sibling national-standard-data Actor and is exercised over local HTTP. No live key or authenticated API receipt is stored.