Korea Benefits Eligibility

Find Korean public-data records by region and topic. Examples: Gangneung libraries, Busan Jung-gu parking, Jeju tourism. A region word is read as an administrative area (abbreviations work); the rest is matched against record content and dataset names. The response echoes exactly how it was read in `interpreted`. Use it for what-is-where questions. / 지역과 주제로 공공데이터 레코드를 찾습니다. 예: 강릉 도서관 · 부산 중구 주차장 · 제주 관광. 「어디에 무엇이 있나」를 물을 때 씁니다. 해석 결과는 interpreted 에 밝힙니다.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What to find. Region plus topic works best, e.g. Suwon library. / 찾을 말. 지역 + 주제 형태를 권장합니다."
    },
    "limit": {
      "type": "integer",
      "description": "Max records (default 20, max 200). / 최대 건수",
      "default": 20
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

See at a glance what kinds of data we hold for one Korean city or district, and how many records of each. Good as a first look before planning a trip or a site survey. Returns counts per dataset kind, so you can then drill in with search_data. / 한 시군구에 어떤 자료가 몇 건씩 있는지 한눈에 봅니다. 여행 계획이나 현장 조사 전에 먼저 훑어볼 때 씁니다. 자세한 레코드는 search_data 로 이어서 찾습니다.

{
  "type": "object",
  "properties": {
    "sido": {
      "type": "string",
      "description": "Province or metropolitan city, e.g. Jeju. / 시도"
    },
    "sigungu": {
      "type": "string",
      "description": "City or district (optional), e.g. Jeju-si. / 시군구 (선택)"
    }
  },
  "required": [
    "sido"
  ],
  "additionalProperties": false
}

Korean districts where several kinds of data overlap. Check here first to see which regions we can actually answer about. / 자료가 여러 종류 겹쳐 있는 시군구 목록입니다. 어느 지역에 대해 답할 수 있는지 먼저 확인할 때 씁니다.

{
  "type": "object",
  "properties": {
    "minAxes": {
      "type": "integer",
      "description": "Minimum number of overlapping dataset kinds (default 2). / 최소 자료 종류 수",
      "default": 2
    }
  },
  "additionalProperties": false
}

Current nationwide Korean temperature, humidity and wind, plus weather warnings that are IN EFFECT RIGHT NOW. Based on the KMA ultra-short-term observation. These are observations, not a forecast, so it cannot answer about tomorrow. / 기상청 초단기실황 + 현재 발효 중인 특보. 예보가 아니라 관측값입니다. 지금 날씨·특보를 물을 때 씁니다(내일 날씨는 답하지 못합니다).

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Search the entire data.go.kr catalogue — INCLUDING datasets we have not loaded yet. Use it when search_data comes back empty, to find out whether such data exists at all and where to get it. / 공공데이터포털 대장 전체 검색. 아직 적재하지 않은 자료도 나옵니다. search_data 결과가 비었을 때, 그런 자료가 있기는 한지와 어디서 받는지 확인할 때 씁니다.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Text to match against dataset names. / 자료 이름으로 찾을 말"
    },
    "type": {
      "type": "string",
      "description": "API | FILE | LINKED | STD (optional) / 자료 유형(선택)"
    },
    "limit": {
      "type": "integer",
      "description": "Max records (default 20, max 200). / 최대 건수",
      "default": 20
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

The datasets we have actually loaded, with record counts. Check what we can answer from. / 실제로 적재해 둔 자료 목록과 건수입니다. 무엇으로 답할 수 있는지 확인할 때 씁니다.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Part of a dataset name (optional). Empty means the full list. / 자료 이름 일부(선택)"
    }
  },
  "additionalProperties": false
}

Search-demand ranking. It is an index relative to an anchor (libraries), NOT an absolute search volume. Use it to compare what people look for more, for market or topic research. / 검색 수요 순위. 앵커 대비 상대 지수이며 절대 검색량이 아닙니다. 시장·주제 조사에서 무엇을 더 많이 찾는지 비교할 때 씁니다.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max records (default 30, max 500). / 최대 건수",
      "default": 30
    },
    "heldOnly": {
      "type": "boolean",
      "description": "Keep only topics we actually hold data for. / 우리가 실제로 자료를 가진 주제만 추립니다",
      "default": false
    }
  },
  "additionalProperties": false
}

Find Korean government benefit programmes a person may be eligible for. Filters all 10,956 original records of the Ministry of the Interior and Safety Bojogeum24 registry by age, income bracket, household type and personal traits. A programme that does not state a condition is treated as UNRESTRICTED, not as excluded — so the fewer conditions you give, the more results you get. WARNING: the final entitlement decision belongs to the administering agency. This is a candidate list. / 보조금24 원본 10,956건에서 자격 조건으로 걸러 줍니다. 최종 수급 여부는 소관 기관이 정합니다.

{
  "type": "object",
  "properties": {
    "age": {
      "type": "integer",
      "minimum": 0,
      "maximum": 130,
      "description": "Age in years. Omit to apply no age condition. / 나이(만). 생략하면 조건을 걸지 않습니다"
    },
    "gender": {
      "type": "string",
      "enum": [
        "남성",
        "여성"
      ],
      "description": "Gender (optional). / 성별. 생략 가능"
    },
    "income": {
      "type": "string",
      "enum": [
        "중위소득 51~75%",
        "중위소득 0~50%",
        "중위소득 101~200%",
        "중위소득 76~100%",
        "중위소득 200% 초과"
      ],
      "description": "Household median-income bracket. OMIT it if you do not know — guessing drops programmes that would have matched. / 모르면 생략하십시오. 찍으면 맞는 제도가 빠집니다"
    },
    "household": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "다자녀가구",
          "해당사항없음",
          "신규전입",
          "무주택세대",
          "확대가족",
          "북한이탈주민",
          "다문화가족",
          "1인가구",
          "한부모가정/조손가정"
        ]
      },
      "description": "Household types (multiple allowed). / 가구 유형(복수 가능)"
    },
    "traits": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "예비부모/난임",
          "출산/입양",
          "임산부",
          "질병/질환자",
          "국가보훈대상자",
          "장애인",
          "대학생/대학원생",
          "해당사항없음",
          "구직자/실업자",
          "근로자/직장인",
          "중학생",
          "초등학생",
          "고등학생",
          "어업인",
          "농업인",
          "임업인",
          "축산업인"
        ]
      },
      "description": "Personal traits (multiple allowed): life stage, occupation, school level, health. / 대상 특성(복수 가능)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Max records (default 20). / 최대 건수(기본 20)"
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "How many to skip (pagination). / 건너뛸 건수(페이지네이션)"
    }
  },
  "additionalProperties": false
}

See how to apply for one benefit programme: what it provides, the application deadline, required documents, contact point and the law it rests on. Use the id returned by benefits_match. / 지원내용·신청기한·구비서류·문의처·근거법령을 봅니다.

{
  "type": "object",
  "properties": {
    "serviceId": {
      "type": "string",
      "description": "benefits_match 결과의 서비스ID"
    }
  },
  "required": [
    "serviceId"
  ],
  "additionalProperties": false
}

The full list of classification values used for eligibility matching, with what each means. Read this when you do not know what to put into benefits_match. / 자격 판정에 쓰는 분류 값의 전체 목록과 뜻.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}