SK Telecom

SK Telecom Resident API

The Resident API from SK Telecom — 3 operation(s) for resident.

GitHub OpenAPI

Operations 3

GET /resident/subway-use-rate/stat/monthly/apts/{kaptCode} 지하철 이용 비율 #
GET /resident/age/stat/monthly/apts/{kaptCode} 거주자 평균 나이 #
GET /resident/demo-feature/stat/monthly/apts/{kaptCode} 거주자 특징 #

Documentation

📖
Documentation
https://openapi.sk.com/products/detail?svcSeq=67
📖
APIReference
https://ax-tts-skopenapi.readme.io/reference/text-to-speech-tts
📖
GettingStarted
https://ax-tts-skopenapi.readme.io/reference/getting-started-with-ax-tts-api
📖
Documentation
https://openapi.sk.com/products/detail?svcSeq=50
📖
APIReference
https://nugufacecan-skopenapi.readme.io/reference/face-detect-1
📖
Documentation
https://openapi.sk.com/products/detail?svcSeq=56
📖
APIReference
https://puzzle-skopenapi.readme.io/reference/poicongestionrltm
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/sk-telecom/refs/heads/main/rate-limits/sk-telecom-rate-limits.yml
📖
Documentation
https://openapi.sk.com/products/detail?svcSeq=66
📖
APIReference
https://puzzle-skopenapi.readme.io/reference/apts
📖
Documentation
https://openapi.sk.com/
📖
APIReference
https://meta-skopenapi.readme.io/reference/lpr-1
📖
APIReference
https://ovs-skopenapi.readme.io/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/sk-telecom/refs/heads/main/openapi/sk-telecom-resident-api-openapi.yml

Other Resources

🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/sk-telecom/refs/heads/main/llms/sk-telecom-ax-tts-llms.txt
🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/sk-telecom/refs/heads/main/llms/sk-telecom-nugufacecan-llms.txt
🔗
ErrorCatalog
https://nugufacecan-skopenapi.readme.io/reference/error-codes
🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/sk-telecom/refs/heads/main/llms/sk-telecom-puzzle-llms.txt
🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/sk-telecom/refs/heads/main/llms/sk-telecom-meta-llms.txt
🔗
ErrorCatalog
https://meta-skopenapi.readme.io/reference/error-code-2
🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/sk-telecom/refs/heads/main/llms/sk-telecom-ovs-llms.txt
🔗
Deprecation
https://openapi.sk.com/support/notice/detailView?ntiSeq=357

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/sk-telecom-resident-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

sk-telecom-resident-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: 주거 생활 Resident API
  version: '1.0'
servers:
- url: https://apis.openapi.sk.com/puzzle/residence
security:
- sec0: []
tags:
- name: Resident
paths:
  /resident/subway-use-rate/stat/monthly/apts/{kaptCode}:
    get:
      tags:
      - Resident
      summary: 지하철 이용 비율
      description: '* 특정 아파트 주민 중 최근 3개월 동안 지하철을 이용한 주민의 비율을 제공합니다.

        '
      operationId: aptsubwayuserate
      parameters:
      - $ref: '#/components/parameters/ContentTypeJson'
      - $ref: '#/components/parameters/AppKey'
      - $ref: '#/components/parameters/KaptCode'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    $ref: '#/components/schemas/ResponseStatus'
                  contents:
                    $ref: '#/components/schemas/AptSubwayUseRateStatMonthly'
              examples:
                Result:
                  value: "{\n  \"status\": {\n    \"code\": \"00\",\n    \"message\": \"success\",\n    \"totalCount\": 1\n  },\n  \"contents\": [\n    {\n      \"kaptCode\": \"A13805002\",\n      \"kaptName\": \"올림픽선수기자촌아파트\",\n      \"stat\": {\n        \"rate\": 21.523\n      },\n      \"yearMonth\": \"202304\",\n      \"statStartDate\": \"20230201\",\n      \"statEndDate\": \"20230430\"\n    }\n  ]\n}"
        '400':
          $ref: '#/paths/~1meta~1apts/get/responses/400'
        '401':
          $ref: '#/paths/~1meta~1apts/get/responses/401'
        '403':
          $ref: '#/paths/~1meta~1apts/get/responses/403'
        '404':
          $ref: '#/paths/~1meta~1apts/get/responses/404'
        '429':
          $ref: '#/paths/~1meta~1apts/get/responses/429'
        '500':
          $ref: '#/paths/~1meta~1apts/get/responses/500'
        '504':
          $ref: '#/paths/~1meta~1apts/get/responses/504'
      deprecated: false
  /resident/age/stat/monthly/apts/{kaptCode}:
    get:
      tags:
      - Resident
      summary: 거주자 평균 나이
      description: '* 특정 아파트 주민의 평균 나이를 제공합니다.

        '
      operationId: aptresidentage
      parameters:
      - $ref: '#/components/parameters/ContentTypeJson'
      - $ref: '#/components/parameters/AppKey'
      - $ref: '#/components/parameters/KaptCode'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    $ref: '#/components/schemas/ResponseStatus'
                  contents:
                    $ref: '#/components/schemas/AptResidentDemoStatMonthly'
              examples:
                Result:
                  value: "{\n  \"status\": {\n    \"code\": \"00\",\n    \"message\": \"success\",\n    \"totalCount\": 1\n  },\n  \"contents\": [\n    {\n      \"kaptCode\": \"A13805002\",\n      \"kaptName\": \"올림픽선수기자촌아파트\",\n      \"stat\": [\n        {\n          \"gender\": \"male\",\n          \"avgAge\": 47.10608552631579,\n          \"ctpAvgAge\": 46.71051679606173,\n          \"sigAvgAge\": 46.36388996628577\n        },\n        {\n          \"gender\": \"female\",\n          \"avgAge\": 46.66177669111654,\n          \"ctpAvgAge\": 47.22532359178899,\n          \"sigAvgAge\": 46.16058659909418\n        }\n      ],\n      \"yearMonth\": \"202304\",\n      \"statStartDate\": \"20230201\",\n      \"statEndDate\": \"20230430\"\n    }\n  ]\n}"
        '400':
          $ref: '#/paths/~1meta~1apts/get/responses/400'
        '401':
          $ref: '#/paths/~1meta~1apts/get/responses/401'
        '403':
          $ref: '#/paths/~1meta~1apts/get/responses/403'
        '404':
          $ref: '#/paths/~1meta~1apts/get/responses/404'
        '429':
          $ref: '#/paths/~1meta~1apts/get/responses/429'
        '500':
          $ref: '#/paths/~1meta~1apts/get/responses/500'
        '504':
          $ref: '#/paths/~1meta~1apts/get/responses/504'
      deprecated: false
  /resident/demo-feature/stat/monthly/apts/{kaptCode}:
    get:
      tags:
      - Resident
      summary: 거주자 특징
      description: '* 동일 시도 대비 해당 아파트 주민 구성의 비율이 높은 Life stage(영유아, 초등학생, 중학생, 고등학생, 대학생, 1인가구, 신혼부부, 시니어) 값을 제공합니다.

        '
      operationId: aptresidentdemo
      parameters:
      - $ref: '#/components/parameters/ContentTypeJson'
      - $ref: '#/components/parameters/AppKey'
      - $ref: '#/components/parameters/KaptCode'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    $ref: '#/components/schemas/ResponseStatus'
                  contents:
                    $ref: '#/components/schemas/AptResidentFeatureStatMonthly'
              examples:
                Result:
                  value: "{\n  \"status\": {\n    \"code\": \"00\",\n    \"message\": \"success\",\n    \"totalCount\": 1\n  },\n  \"contents\": [\n    {\n      \"kaptCode\": \"A13805002\",\n      \"kaptName\": \"올림픽선수기자촌아파트\",\n      \"stat\": [\n        {\n          \"feature\": \"대학생\",\n          \"lift\": 1.44\n        },\n        {\n          \"feature\": \"고등학생\",\n          \"lift\": 1.31\n        },\n        {\n          \"feature\": \"중학생\",\n          \"lift\": 1.24\n        },\n        {\n          \"feature\": \"60+\",\n          \"lift\": 1.06\n        }\n      ],\n      \"yearMonth\": \"202304\",\n      \"statStartDate\": \"20230201\",\n      \"statEndDate\": \"20230430\"\n    }\n  ]\n}"
        '400':
          $ref: '#/paths/~1meta~1apts/get/responses/400'
        '401':
          $ref: '#/paths/~1meta~1apts/get/responses/401'
        '403':
          $ref: '#/paths/~1meta~1apts/get/responses/403'
        '404':
          $ref: '#/paths/~1meta~1apts/get/responses/404'
        '429':
          $ref: '#/paths/~1meta~1apts/get/responses/429'
        '500':
          $ref: '#/paths/~1meta~1apts/get/responses/500'
        '504':
          $ref: '#/paths/~1meta~1apts/get/responses/504'
      deprecated: false
components:
  schemas:
    FeatureLift:
      type: object
      properties:
        feature:
          type: string
          description: demo feature
        lift:
          type: number
          description: lift
      required:
      - feature
      - lift
    ResponseStatus:
      type: object
      description: 응답 상태입니다.
      properties:
        code:
          type: string
          description: '응답 코드입니다.

            00: 성공

            '
        message:
          type: string
          description: '요청(request) 성공 여부 메시지입니다.

            success: 성공.

            '
        totalCount:
          type: integer
          description: 검색 결과 데이터 건수입니다.
    AptResidentDemoStatMonthly:
      type: object
      properties:
        kaptCode:
          type: string
          description: 아파트 코드(국토부 기준)
        kaptName:
          type: string
          description: 아파트 이름(국토부 기준)
        stat:
          description: 통계 데이터
          type: array
          items:
            $ref: '#/components/schemas/DemoStat'
        yearMonth:
          type: string
          description: 기준 월
        statStartDate:
          type: string
          description: 통계 시작일
        statEndDate:
          type: string
          description: 통계 종료일
      required:
      - kaptCode
      - kaptName
      - stat
      - yearMonth
      - statStartDate
      - statEndDate
    DemoStat:
      type: object
      properties:
        gender:
          type: string
          description: 성별
        avgAge:
          type: number
          description: 평균연령
        ctpAvgAge:
          type: number
          description: 시도 평균연령
        sigAvgAge:
          type: number
          description: 시군구 평균연령
      required:
      - gender
      - avgAge
      - ctpAvgAge
      - sigAvgAge
    AptResidentFeatureStatMonthly:
      type: object
      properties:
        kaptCode:
          type: string
          description: 아파트 코드(국토부 기준)
        kaptName:
          type: string
          description: 아파트 이름(국토부 기준)
        stat:
          description: 통계 데이터
          type: array
          items:
            $ref: '#/components/schemas/FeatureLift'
        yearMonth:
          type: string
          description: 기준 월
        statStartDate:
          type: string
          description: 통계 시작일
        statEndDate:
          type: string
          description: 통계 종료일
      required:
      - kaptCode
      - kaptName
      - stat
      - yearMonth
      - statStartDate
      - statEndDate
    AptSubwayUseRateStatMonthly:
      type: object
      properties:
        kaptCode:
          type: string
          description: 아파트 코드(국토부 기준)
        kaptName:
          type: string
          description: 아파트 이름(국토부 기준)
        stat:
          description: 통계 데이터
          allOf:
          - $ref: '#/components/schemas/Rate'
        yearMonth:
          type: string
          description: 기준 월
        statStartDate:
          type: string
          description: 통계 시작일
        statEndDate:
          type: string
          description: 통계 종료일
      required:
      - kaptCode
      - kaptName
      - stat
      - yearMonth
      - statStartDate
      - statEndDate
    Rate:
      type: object
      properties:
        rate:
          type: number
          description: rate
      required:
      - rate
  parameters:
    ContentTypeJson:
      name: Content-Type
      description: application/json
      in: header
      required: true
      schema:
        type: string
        default: application/json
    KaptCode:
      name: kaptCode
      in: path
      description: 아파트 코드입니다. 국토교통부 공동주택관리정보시스템 기준입니다.
      schema:
        type: string
        default: A13805002
      required: true
    AppKey:
      name: appKey
      in: header
      description: <a href="https://openapi.sk.com/mypage/project/" target="_blank">대시보드>앱</a>>앱키(appKey) 탭에서 조회
      required: true
      schema:
        type: string
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      x-default: e8wHh2tya84M88aReEpXCa5XTQf3xgo01aZG39k5
      name: appkey
x-readme:
  headers: []
  explorer-enabled: true
  proxy-enabled: true
  samples-enabled: true
x-readme-fauxas: true