{"openapi":"3.1.0","info":{"title":"최저가e심 공개 API","version":"1.0.0","description":"해외여행 eSIM·유심 판매처 가격(네이버 스마트스토어)을 매일 수집·검증한 데이터. 읽기 전용, 인증 없음. 응답의 cite 값으로 출처를 밝혀 주세요(CC BY 4.0).","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"contact":{"name":"케이코인(KCOIN)","email":"wmask@naver.com","url":"https://pyungyo.com/esim"}},"servers":[{"url":"https://pyungyo.com/esim"}],"paths":{"/api/v1/countries":{"get":{"operationId":"listCountries","summary":"나라 목록","responses":{"200":{"description":"나라 목록","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"잘못된 요청"},"404":{"description":"없음"},"429":{"description":"요청이 너무 많음 (IP 당 분당 120건)"}}}},"/api/v1/prices":{"get":{"operationId":"findPrices","summary":"나라·일수별 판매처 가격","parameters":[{"name":"country","in":"query","required":true,"description":"나라 key(japan) 또는 한글 이름(일본)","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"이용 일수 1~30","schema":{"type":"integer","minimum":1,"maximum":30,"default":3}},{"name":"type","in":"query","required":false,"description":"요금제 종류","schema":{"type":"string","enum":["unlimited","daily","total"],"default":"unlimited"}},{"name":"gb","in":"query","required":false,"description":"daily: 하루 용량, total: 기간 총 용량 (GB)","schema":{"type":"number"}},{"name":"form","in":"query","required":false,"description":"esim 또는 usim(실물 유심, 배송비 포함가)","schema":{"type":"string","enum":["esim","usim"],"default":"esim"}},{"name":"sort","in":"query","required":false,"description":"무제한 목록 정렬","schema":{"type":"string","enum":["reviews","price"],"default":"reviews"}},{"name":"limit","in":"query","required":false,"description":"판매처 수 1~30","schema":{"type":"integer","default":10}},{"name":"bundles","in":"query","required":false,"description":"1 이면 1+1 묶음 포함","schema":{"type":"string","enum":["0","1"]}}],"responses":{"200":{"description":"판매처 목록과 화면 최저가","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"잘못된 요청"},"404":{"description":"없음"},"429":{"description":"요청이 너무 많음 (IP 당 분당 120건)"}}}},"/api/v1/cheapest":{"get":{"operationId":"cheapestCountries","summary":"나라별 무제한 최저가 순위","parameters":[{"name":"days","in":"query","required":false,"description":"이용 일수","schema":{"type":"integer","default":3}},{"name":"form","in":"query","required":false,"description":"esim|usim","schema":{"type":"string","default":"esim"}},{"name":"limit","in":"query","required":false,"description":"나라 수 1~60","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"나라별 최저가","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"잘못된 요청"},"404":{"description":"없음"},"429":{"description":"요청이 너무 많음 (IP 당 분당 120건)"}}}},"/api/v1/trend":{"get":{"operationId":"priceTrend","summary":"최근 기록 가격 추세","parameters":[{"name":"country","in":"query","required":true,"description":"나라","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"1·3·5·7·10·15·30","schema":{"type":"integer","default":3}},{"name":"form","in":"query","required":false,"description":"esim|usim","schema":{"type":"string","default":"esim"}}],"responses":{"200":{"description":"일별 최저가 이력과 판단","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"잘못된 요청"},"404":{"description":"없음"},"429":{"description":"요청이 너무 많음 (IP 당 분당 120건)"}}}},"/api/v1/sellers":{"get":{"operationId":"sellerProfile","summary":"판매처 운영 지표","parameters":[{"name":"name","in":"query","required":true,"description":"판매처 이름 (예: 말톡)","schema":{"type":"string"}}],"responses":{"200":{"description":"가격 변경·품절 지표와 최저가 칸","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"잘못된 요청"},"404":{"description":"없음"},"429":{"description":"요청이 너무 많음 (IP 당 분당 120건)"}}}}}}