datagokr — 공공데이터포털 검색을 더 쉽게 (find data.go.kr datasets easily)

[공공데이터포털 검색 (datagokr)] 전체 데이터를 사용자 컴퓨터로 받는 방법을 알려줍니다. 서버가 파일을 대신 저장하진 않고 주소·요청값·절차를 돌려줍니다. Get client-side download instructions (URL, params, steps). The server never stores files. 반환: access_kind, url 또는 post_url/get_url, params, version_keys(파일 버전), message(절차), page_url. 예: '15028200 전체 JSON 받는 법', '15000001 원본 파일 다운로드 주소'

[공공데이터포털 검색 (datagokr)] 주제 없이 컬럼만 조건일 때(query는 빈 문자열로 고정됨). 주제가 있으면 search(query, fields=...)를 쓰세요. Find datasets with ALL given columns and no topic; for a topic use search(query, fields=...). names에 적은 컬럼을 전부 가진 데이터셋만 나옵니다(필드명 역색인). dtype/org로 좁힐 수 있고 n은 최대 20. 반환: id, title, org_nm, dtype, access_kind, page_url, rank, matched_fields(일치한 컬럼), last_probe_ok.

[공공데이터포털 검색 (datagokr)] 실제 첫 행 보기. STD_FILE·PORTAL_FILE(첨부 있으면)은 키 없이 첫 행을 줍니다. PORTAL_FILE 첨부 미리보기 실패 시 API 대체 조회에 본인 X-DataGoKr-Key가 필요할 수 있음(키는 반환·저장 안 함). 서울·경기의 확인된 공개 경로는 키 없이 최대5행. 그 밖의 OPEN_API→request_templates, LINK→url, STD 하위행→parent_id. Preview standard data and portal attachments without a key. API fallback may require the caller's X-DataGoKr-Key. Keys are never returned or stored. API/link/subset responses give access guidance. 반환: ok(true=처리됨, false=포털이 지금 응답 안 함→잠시 후 재시도), data{columns, rows}(rows는 columns 순서의 값 배열, 최대 50컬럼·20행), total, truncated, source_note, 또는 안내 필드(url/parent_id/request_templates/message/page_url/access_guide). 지역 API가 확인되면 service_name/request_format도 반환. data가 있으면 실제 행을 받은 것. ok=false: retry later. data means actual rows, as value arrays in columns order (up to 50 columns/20 rows).

[공공데이터포털 검색 (datagokr)] (로컬 datagokr 패키지 전용) 조회·신청·다운로드에 필요한 원본 메타데이터를 돌려줍니다. 일반 사용에서는 show를 쓰세요. Allowlisted raw metadata for the local datagokr client; prefer `show` for normal use. 반환: id/title/list_title/org_nm, dtype/access_kind, page_url/external_url, parent_id, versions/version_keys, examples(요청 템플릿), std_meta, api_sample. 내부 상태는 제외하고, 서버에서 신청하거나 저장하지 않습니다.

[공공데이터포털 검색 (datagokr)] 주제로 공공데이터를 찾습니다. "전국 주차장", "재난문자 API", "서울 병원 위치"처럼 뭘 찾는지 한 줄로 주세요. Search Korean public datasets by topic in one line. - 주제+컬럼 조건('서울 병원 중 위도·경도 있는 것')은 `fields=['위도','경도']`를 같이 주세요. 컬럼만 조건이면 `fields` 툴. - dtype(API/FILE)·org(기관)를 주면 더 정확합니다. 결과가 이상하면 필터를 빼고 다시 검색하세요. - 비슷한 데이터셋은 주제별로 접어서 줍니다(group=True). 접힌 것은 group_ids의 id를 show로 펼치세요. n은 최대 20. - 인기·맛집·추천 같은 평가는 공공데이터에 없습니다. 목록(인허가·시설)과 대리지표(매출·유동인구)로 나눠 2~3회 검색하세요. - 지역 자료가 없으면 region_fallback(전국 자료)을 쓰세요. 한 번 검색으로 끝내지 말고 show로 컬럼을 확인하세요. 반환: results[{id, title, org_nm, dtype, page_url, desc_short, top_columns, group_ids, access_note}], summary, region_gap/region_fallback, scope_warning.

[공공데이터포털 검색 (datagokr)] 검색에서 고른 데이터셋의 구조와 접근 방법을 봅니다. Inspect a dataset's schema and access methods. 반환: id, title, org_nm, category, dtype, access_kind, page_url, portal_updated, columns(최대 50), operations, operation_names, examples, n_versions, version_keys(최신 3개), note, access_guide(인증·받는 절차), truncated(잘린 항목과 전체 개수), more(후속 조회법). 응답은 약 20KB 이내로 잘림. operations가 많은 API는 show(id, operation='기능명 또는 operation_seq')로 한 기능만 전체 보기. Responses are trimmed to about 20KB; select an operation by name or sequence for its full fields. 쓸 만하면 get_preview로 실제 첫 행을 확인하세요.