{"openapi":"3.1.0","info":{"title":"평생요금제닷컴 알뜰폰 요금제 API","version":"2.1.0","description":"한국 알뜰폰(MVNO) 요금제를 통신사 공식 홈페이지 기준(하루 5번 확인)으로 조회합니다. 인증 없음·읽기 전용. 출처 표기(CC BY 4.0): \"평생요금제닷컴(pyungyo.com) 집계, 기준 시각\". 가입 전 통신사 화면에서 최종 금액을 확인하세요.","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/deed.ko"},"contact":{"url":"https://pyungyo.com/about/"}},"servers":[{"url":"https://pyungyo.com"}],"externalDocs":{"url":"https://pyungyo.com/developers/"},"components":{"schemas":{"Plan":{"type":"object","properties":{"id":{"type":"string","description":"요금제 id"},"type":{"type":"string","description":"lifetime=평생 할인 · flat=정가 · limited=한정 가입 · period=기간 할인 · nodate=종료일 없는 할인"},"brand":{"type":"string","description":"알뜰폰 통신사"},"name":{"type":"string","description":"요금제 이름(통신사 표기 그대로)"},"mno":{"type":"string","description":"통신망 SKT·KT·LGU"},"network":{"type":"string","description":"LTE·5G"},"fee":{"type":"number","description":"월 요금(원, VAT 포함)"},"listFee":{"type":"number","description":"정가"},"promoMonths":{"type":["number","null"],"description":"기간 할인 개월"},"afterFee":{"type":["number","null"],"description":"기간 할인 뒤 요금"},"dataGb":{"type":["number","null"],"description":"기본 데이터 GB"},"dailyDataGb":{"type":"number","description":"매일 데이터 GB"},"dataUnlimited":{"type":"boolean","description":"데이터 무제한"},"qosKbps":{"type":"number","description":"다 쓴 뒤 속도 kbps"},"voiceMin":{"type":["number","null"],"description":"통화 분"},"voiceUnlimited":{"type":"boolean","description":"통화 무제한"},"smsCount":{"type":["number","null"],"description":"문자 건"},"smsUnlimited":{"type":"boolean","description":"문자 무제한"},"extraCallKind":{"type":["string","null"],"description":"부가통화 구분(separate=따로 제공, included=기본통화 내, none=과금)"},"extraCallMin":{"type":["number","null"],"description":"부가통화 별도 제공 분"},"usimFree":{"type":"boolean","description":"요금제 원문 유심 무료 여부"},"tetheringGb":{"type":"number","description":"테더링 가능 한도 GB (0=미표시·불가)"},"bundleInternet":{"type":"boolean","description":"인터넷 결합 혜택 표시 여부"},"bundleMobile":{"type":"boolean","description":"가족·모바일 결합 혜택 표시 여부"},"dataSharing":{"type":"boolean","description":"데이터 쉐어링 가능 표시 여부"},"noCondition":{"type":"boolean","description":"의무사용·유지기간 등 가입 조건 없음 여부"},"signupUntil":{"type":["string","null"],"description":"가입 기한(한정)"},"feeSince":{"type":"string","description":"지금 요금이 시작된 날"},"evidence":{"type":"string","description":"통신사 화면 원문 근거"},"sourceUrl":{"type":"string","description":"통신사 공식 주소"},"pageUrl":{"type":"string","description":"평생요금제닷컴 상세 주소"},"checkedAt":{"type":"string","description":"확인 시각"}}}}},"paths":{"/api/v1/search":{"get":{"operationId":"searchPlansByText","summary":"한국어 그대로 요금제 검색","description":"예: \"KT망 10GB 1만원 이하\", \"월 1만원 이하 데이터 많은 거\", \"데이터 무제한 5G\", \"유심 무료\", \"선착순 한정\". 읽어 낸 조건(interpreted)도 함께 돌려줍니다.","parameters":[{"name":"q","in":"query","required":true,"description":"한국어 검색어","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1~50, 기본 10","schema":{"type":"number"}},{"name":"format","in":"query","required":false,"description":"text 로 주면 사람이 읽는 글(text/plain)","schema":{"type":"string","enum":["json","text"]}}],"responses":{"200":{"description":"검색 결과","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","description":"출처"},"attribution":{"type":"string","description":"인용 표기"},"license":{"type":"string","description":"이용 조건(CC BY 4.0)"},"asOf":{"type":"string","description":"기준 시각(UTC ISO)"},"interpreted":{"type":"object","description":"읽어 낸 조건"},"total":{"type":"number","description":"조건에 맞는 개수"},"plans":{"type":"array","items":{"$ref":"#/components/schemas/Plan"}}}}},"text/plain":{"schema":{"type":"string"}}}}}}},"/api/v1/plans":{"get":{"operationId":"searchPlans","summary":"조건으로 요금제 검색 (월 요금 낮은 순·데이터 많은 순)","parameters":[{"name":"type","in":"query","required":false,"description":"lifetime=평생 할인·정가(기본) / limited=선착순·기한 한정 가입 / period=N개월 기간 할인 / nodate=종료일 안 적힌 할인 / all=전부","schema":{"type":"string","enum":["lifetime","limited","period","nodate","all"]}},{"name":"dataMin","in":"query","required":false,"description":"한 달 데이터 최소 GB (매일 제공은 30일치로 계산, 무제한 포함)","schema":{"type":"number"}},{"name":"dataUnlimited","in":"query","required":false,"description":"데이터 무제한만","schema":{"type":"boolean"}},{"name":"dailyData","in":"query","required":false,"description":"매일 추가 데이터(예: 매일 2GB)를 따로 주는 요금제만","schema":{"type":"boolean"}},{"name":"qosMin","in":"query","required":false,"description":"데이터 다 쓴 뒤 최소 속도 kbps (예: 1000=1Mbps, 3000=3Mbps, 5000=5Mbps)","schema":{"type":"number"}},{"name":"feeMax","in":"query","required":false,"description":"월 요금 상한(원, VAT 포함)","schema":{"type":"number"}},{"name":"mno","in":"query","required":false,"description":"빌려 쓰는 통신망","schema":{"type":"string","enum":["SKT","KT","LGU"]}},{"name":"network","in":"query","required":false,"description":"network","schema":{"type":"string","enum":["LTE","5G"]}},{"name":"voiceUnlimited","in":"query","required":false,"description":"통화 무제한만","schema":{"type":"boolean"}},{"name":"voiceMin","in":"query","required":false,"description":"통화 최소 분","schema":{"type":"number"}},{"name":"smsUnlimited","in":"query","required":false,"description":"문자 무제한만","schema":{"type":"boolean"}},{"name":"extraCallMin","in":"query","required":false,"description":"부가통화(전국대표번호 15XX·050·영상통화)를 따로 이 분 이상 주는 요금제만 — 공식 화면에 분이 적힌 것만 (예: 300)","schema":{"type":"number"}},{"name":"usimFree","in":"query","required":false,"description":"요금제에 \"유심 무료\"가 공식 원문으로 적힌 요금제만","schema":{"type":"boolean"}},{"name":"tetheringMin","in":"query","required":false,"description":"공식 홈페이지에 테더링(핫스팟) 한도가 적힌 요금제 중 한 달 테더링 가능 최소 GB (1=테더링 한도 표시 전체)","schema":{"type":"number"}},{"name":"bundle","in":"query","required":false,"description":"결합 혜택 원문이 있는 요금제 (internet=인터넷·유선 결합, mobile=가족·모바일 결합, any=둘 중 하나 이상)","schema":{"type":"string","enum":["internet","mobile","any"]}},{"name":"dataSharing","in":"query","required":false,"description":"데이터 쉐어링 가능 원문이 적힌 요금제만","schema":{"type":"boolean"}},{"name":"noCondition","in":"query","required":false,"description":"최소 사용량·개통 초기 유지 기간 등 가입 조건이 하나도 없는 요금제만","schema":{"type":"boolean"}},{"name":"brand","in":"query","required":false,"description":"알뜰폰 통신사 이름 일부 (예: 이야기, 프리티, 헬로)","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"fee=월 요금 낮은 순(기본), data=데이터 많은 순","schema":{"type":"string","enum":["fee","data"]}},{"name":"limit","in":"query","required":false,"description":"1~50, 기본 10","schema":{"type":"number"}},{"name":"format","in":"query","required":false,"description":"text 로 주면 사람이 읽는 글(text/plain)","schema":{"type":"string","enum":["json","text"]}}],"responses":{"200":{"description":"검색 결과","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","description":"출처"},"attribution":{"type":"string","description":"인용 표기"},"license":{"type":"string","description":"이용 조건(CC BY 4.0)"},"asOf":{"type":"string","description":"기준 시각(UTC ISO)"},"total":{"type":"number","description":"조건에 맞는 개수"},"plans":{"type":"array","items":{"$ref":"#/components/schemas/Plan"}}}}},"text/plain":{"schema":{"type":"string"}}}}}}},"/api/v1/plans/{id}":{"get":{"operationId":"getPlan","summary":"요금제 하나 (세부 조건·가격 기록·고객센터)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"format","in":"query","required":false,"description":"text 로 주면 사람이 읽는 글(text/plain)","schema":{"type":"string","enum":["json","text"]}}],"responses":{"200":{"description":"요금제","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","description":"출처"},"attribution":{"type":"string","description":"인용 표기"},"license":{"type":"string","description":"이용 조건(CC BY 4.0)"},"asOf":{"type":"string","description":"기준 시각(UTC ISO)"},"plan":{"$ref":"#/components/schemas/Plan"}}}},"text/plain":{"schema":{"type":"string"}}}},"404":{"description":"없는 요금제(판매 종료이거나 id 가 다름)"}}}},"/api/v1/plans/{id}/history":{"get":{"operationId":"getPlanPriceHistory","summary":"요금제 가격 기록","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"가격 기록","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","description":"출처"},"attribution":{"type":"string","description":"인용 표기"},"license":{"type":"string","description":"이용 조건(CC BY 4.0)"},"asOf":{"type":"string","description":"기준 시각(UTC ISO)"},"history":{"type":"object","description":"recordStart·points[{date,fee}]"}}}},"text/plain":{"schema":{"type":"string"}}}},"404":{"description":"없음"}}}},"/api/v1/cheapest":{"get":{"operationId":"cheapestByData","summary":"데이터 구간별 최저 평생요금제","parameters":[{"name":"mno","in":"query","required":false,"description":"빌려 쓰는 통신망","schema":{"type":"string","enum":["SKT","KT","LGU"]}},{"name":"network","in":"query","required":false,"description":"network","schema":{"type":"string","enum":["LTE","5G"]}},{"name":"voiceUnlimited","in":"query","required":false,"description":"통화 무제한만","schema":{"type":"boolean"}},{"name":"qosMin","in":"query","required":false,"description":"데이터 다 쓴 뒤 최소 속도 kbps (예: 1000=1Mbps, 3000=3Mbps, 5000=5Mbps)","schema":{"type":"number"}},{"name":"usimFree","in":"query","required":false,"description":"요금제에 \"유심 무료\"가 공식 원문으로 적힌 요금제만","schema":{"type":"boolean"}},{"name":"format","in":"query","required":false,"description":"text 로 주면 사람이 읽는 글(text/plain)","schema":{"type":"string","enum":["json","text"]}}],"responses":{"200":{"description":"구간별 최저","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","description":"출처"},"attribution":{"type":"string","description":"인용 표기"},"license":{"type":"string","description":"이용 조건(CC BY 4.0)"},"asOf":{"type":"string","description":"기준 시각(UTC ISO)"},"tiers":{"type":"array","items":{"type":"object","properties":{"dataMinGb":{"type":"number","description":"데이터 하한 GB"},"plan":{"$ref":"#/components/schemas/Plan"}}}}}}},"text/plain":{"schema":{"type":"string"}}}}}}},"/api/v1/stats":{"get":{"operationId":"marketStats","summary":"알뜰폰 요금제 전체 통계 (기간 할인 종료 후 인상액·망별·조건별)","parameters":[{"name":"format","in":"query","required":false,"description":"text 로 주면 사람이 읽는 글(text/plain)","schema":{"type":"string","enum":["json","text"]}}],"responses":{"200":{"description":"통계","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","description":"출처"},"attribution":{"type":"string","description":"인용 표기"},"license":{"type":"string","description":"이용 조건(CC BY 4.0)"},"asOf":{"type":"string","description":"기준 시각(UTC ISO)"},"counts":{"type":"object","description":"종류별 개수"},"periodDiscountSummary":{"type":"object","description":"기간 할인 종료 후 인상액·할인 개월"},"networks":{"type":"array","description":"망별 최저가·중앙값"}}}},"text/plain":{"schema":{"type":"string"}}}}}}},"/api/v1/ssal":{"get":{"operationId":"ssalEvents","summary":"알뜰폰 사은품·체감가(쌀먹) 남는 돈 계산표","parameters":[{"name":"brand","in":"query","required":false,"description":"알뜰폰 통신사 이름 일부 (예: 이야기, 프리티, 헬로)","schema":{"type":"string"}},{"name":"mno","in":"query","required":false,"description":"빌려 쓰는 통신망","schema":{"type":"string","enum":["SKT","KT","LGU"]}},{"name":"minNet","in":"query","required":false,"description":"최소 남는 돈(원)","schema":{"type":"number"}},{"name":"excludeReferral","in":"query","required":false,"description":"친구추천 링크 가입 제외","schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"description":"1~50, 기본 10","schema":{"type":"number"}},{"name":"format","in":"query","required":false,"description":"text 로 주면 사람이 읽는 글(text/plain)","schema":{"type":"string","enum":["json","text"]}}],"responses":{"200":{"description":"쌀먹 계산표","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","description":"출처"},"attribution":{"type":"string","description":"인용 표기"},"license":{"type":"string","description":"이용 조건(CC BY 4.0)"},"asOf":{"type":"string","description":"기준 시각(UTC ISO)"},"plusCount":{"type":"number","description":"플러스 조합 수"},"rows":{"type":"array","description":"사은품 남는 돈 행 목록"}}}},"text/plain":{"schema":{"type":"string"}}}}}}},"/api/v1/changes":{"get":{"operationId":"recentPriceChanges","summary":"최근 월 요금이 바뀐 요금제","parameters":[{"name":"days","in":"query","required":false,"description":"1~60, 기본 7","schema":{"type":"number"}},{"name":"direction","in":"query","required":false,"description":"up=오른 것만, down=내린 것만","schema":{"type":"string","enum":["up","down","both"]}},{"name":"type","in":"query","required":false,"description":"lifetime=평생 할인·정가(기본) / limited=선착순·기한 한정 가입 / period=N개월 기간 할인 / nodate=종료일 안 적힌 할인 / all=전부","schema":{"type":"string","enum":["lifetime","limited","period","nodate","all"]}},{"name":"mno","in":"query","required":false,"description":"빌려 쓰는 통신망","schema":{"type":"string","enum":["SKT","KT","LGU"]}},{"name":"network","in":"query","required":false,"description":"network","schema":{"type":"string","enum":["LTE","5G"]}},{"name":"dataMin","in":"query","required":false,"description":"한 달 데이터 최소 GB (매일 제공은 30일치로 계산, 무제한 포함)","schema":{"type":"number"}},{"name":"brand","in":"query","required":false,"description":"알뜰폰 통신사 이름 일부 (예: 이야기, 프리티, 헬로)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"오름·내림 각각 최대 1~100, 기본 30","schema":{"type":"number"}},{"name":"format","in":"query","required":false,"description":"text 로 주면 사람이 읽는 글(text/plain)","schema":{"type":"string","enum":["json","text"]}}],"responses":{"200":{"description":"바뀐 요금제","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","description":"출처"},"attribution":{"type":"string","description":"인용 표기"},"license":{"type":"string","description":"이용 조건(CC BY 4.0)"},"asOf":{"type":"string","description":"기준 시각(UTC ISO)"},"up":{"type":"array","description":"오른 것"},"down":{"type":"array","description":"내린 것"}}}},"text/plain":{"schema":{"type":"string"}}}}}}},"/api/v1/carriers":{"get":{"operationId":"listCarriers","summary":"알뜰폰 통신사 목록 (개수·최저가·고객센터·유심 안내)","parameters":[{"name":"format","in":"query","required":false,"description":"text 로 주면 사람이 읽는 글(text/plain)","schema":{"type":"string","enum":["json","text"]}}],"responses":{"200":{"description":"통신사","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","description":"출처"},"attribution":{"type":"string","description":"인용 표기"},"license":{"type":"string","description":"이용 조건(CC BY 4.0)"},"asOf":{"type":"string","description":"기준 시각(UTC ISO)"},"carriers":{"type":"array","description":"통신사"}}}},"text/plain":{"schema":{"type":"string"}}}}}}},"/api/v1/index":{"get":{"operationId":"priceIndex","summary":"월별 알뜰폰 요금지수 (데이터 구간별 중앙값·최저값)","parameters":[{"name":"format","in":"query","required":false,"description":"text 로 주면 사람이 읽는 글(text/plain)","schema":{"type":"string","enum":["json","text"]}}],"responses":{"200":{"description":"요금지수","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","description":"출처"},"attribution":{"type":"string","description":"인용 표기"},"license":{"type":"string","description":"이용 조건(CC BY 4.0)"},"asOf":{"type":"string","description":"기준 시각(UTC ISO)"},"index":{"type":"object","description":"요금지수"}}}},"text/plain":{"schema":{"type":"string"}}}}}}},"/api/v1/meta":{"get":{"operationId":"meta","summary":"개수·기준 시각·주소 안내","responses":{"200":{"description":"안내","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","description":"출처"},"attribution":{"type":"string","description":"인용 표기"},"license":{"type":"string","description":"이용 조건(CC BY 4.0)"},"asOf":{"type":"string","description":"기준 시각(UTC ISO)"},"count":{"type":"number","description":"요금제 수"}}}},"text/plain":{"schema":{"type":"string"}}}}}}}}}