{"openapi":"3.0.3","info":{"title":"입지맵 상권 예보 API","version":"20260630","description":"도로명 단위 상권 점수 공개 API. 분기 1회 갱신(자료 2026-06-30 회차). 시간당 호출 제한이 있으며 대량 수집용이 아니다. 이 예보는 공공데이터(소상공인시장진흥공단 상가(상권)정보, 국토교통부, 온비드) 통계를 입지맵이 자동 요약한 데이터 브리핑으로, 투자·창업 자문이 아닙니다. 임대료·권리금 실제 금액은 다루지 않습니다.","contact":{"url":"https://ipjimap.com"}},"servers":[{"url":"https://ipjimap.com"}],"paths":{"/api/search":{"get":{"operationId":"searchRoad","summary":"도로명(길 이름) 검색","description":"\"동교로38길\" 또는 \"마포구 양화로\"처럼 길 이름을 넣으면 맞는 도로명과 점수를 돌려준다.","parameters":[{"name":"q","in":"query","required":true,"description":"길 이름(1~40자)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"최대 30","schema":{"type":"integer","default":20}}],"responses":{"200":{"description":"hits[] (code, n 도로명, sido, sgg, s 점포수, a 활성도, h HOT, g 등급, c 증감률, ty 상권유형, gt 성장단계)"}}}},"/api/road":{"get":{"operationId":"getRoad","summary":"도로 하나의 상세 점수","parameters":[{"name":"code","in":"query","required":true,"description":"도로명코드(숫자 6~14자리, search 결과의 code)","schema":{"type":"string"}}],"responses":{"200":{"description":"도로 객체"},"404":{"description":"목록에 없음"}}}},"/api/rank":{"get":{"operationId":"rankRoads","summary":"순위 — 지난 분기에 뜬 길(hot, 다음 분기 예보 아님)·입지 종합(top)·상승(growth)·하락(decline)·공급률(supply)·질적성장(quality)","parameters":[{"name":"mode","in":"query","required":false,"description":"hot | top | growth | decline | supply | quality | act","schema":{"type":"string","enum":["hot","top","growth","decline","supply","quality","act"]}},{"name":"sido","in":"query","required":false,"description":"시도 짧은 이름(서울·경기·부산 …)","schema":{"type":"string"}},{"name":"sgg","in":"query","required":false,"description":"시군구(마포구·수원시 팔달구 …)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"최대 10","schema":{"type":"integer","default":10,"maximum":10}}],"responses":{"200":{"description":"hits[] 순위 목록"}}}},"/api/regions":{"get":{"operationId":"listRegions","summary":"시도·시군구 목록(점포 20곳 이상 도로가 있는 곳)","responses":{"200":{"description":"sido[], sgg{}"}}}},"/api/near":{"get":{"operationId":"nearRoads","summary":"좌표에서 가까운 길","parameters":[{"name":"lat","in":"query","required":true,"description":"위도(33~39)","schema":{"type":"number"}},{"name":"lon","in":"query","required":true,"description":"경도(124~132)","schema":{"type":"number"}}],"responses":{"200":{"description":"거리순 목록"}}}},"/api/health":{"get":{"operationId":"health","summary":"상태·회차","responses":{"200":{"description":"ok, roads, quarter"}}}}}}