LifestylePlatform secret

Korea Address Search

juso.go.kr

Official road-name address search and conversion provider.

Tier: 🥉 Bronze
Reward: ₩15,000
Auth: Platform secret
Operations: 2
Working now: 1 contributor
Status: Open

Scope

Exposes the national road-name address service. Callers search addresses with free-form keywords and receive standardized road-name addresses, lot-number equivalents, and postal codes.

Expected operations

search-addressesSearch addressesreadDifficulty: easy

Return standardized addresses matching a keyword, with road-name and lot-number renderings plus postal code.

Inputs

keywordstringrequired

Suggested surface — propose changes in your submission if the upstream differs.

Acceptance criteria

Provider scaffolded from the public @apifuse/provider-sdk
All listed operations implemented with Zod/Standard Schema input & output
Each operation declares exactly one of healthCheck or healthCheckUnsupported
Real upstream fixture data included where applicable
bun run check and bun run test pass
Auth, credential, and env-secret behavior documented (no real secrets committed)

Evidence to submit

Workspace repository and main commit link
SDK version/tag and the create command used
Operation list with input/output summaries
Health coverage table per operation
bun run check and bun run test output

Ready to claim?

Submit a claim. Your workspace will be prepared after confirmation.

Claiming a bounty requires a GitHub sign-in.

Outputs

addressesroad_addresslot_addresspostal_codebuilding_nameprovincedistricttotal_count

Acceptance

Every match carries both the road-name and lot-number renderings of the same address, never one without the other.
Postal codes are the five-digit national standard, and pagination totals let consumers plan result traversal.

Auth required for this operation.

get-address-detailGet address coordinatesreadDifficulty: medium

Return the geographic coordinates and administrative codes for one standardized road-name address.

Inputs

road_addressstringrequired
Standardized road-name address from search results
서울특별시 중구 세종대로 110

Outputs

road_addresslatitudelongitudedistrict_codebuilding_management_number

Acceptance

Coordinates are converted to standard decimal WGS84 degrees rather than the raw projected grid values.