{
  "openapi": "3.1.0",
  "info": {
    "title": "알뜰폰 요금지도 공개 API",
    "version": "1.0.0",
    "description": "인증 없는 읽기 전용 스냅샷 조회. IP당 분당 60회. 출처와 확인 시각을 표시하세요. 미지원 파라미터는 400. 실제 가입 조건은 통신사에서 최종 확인."
  },
  "servers": [
    {
      "url": "https://phone.apthow.com"
    }
  ],
  "externalDocs": {
    "url": "https://phone.apthow.com/developers/"
  },
  "paths": {
    "/api/v1/cheapest": {
      "get": {
        "operationId": "cheapestByData",
        "summary": "기본 데이터 구간별 현재·평생·12개월 최저가",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "데이터 응답 형식",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "text"
              ],
              "default": "json",
              "description": "데이터 응답 형식"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "정상 응답",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Cheapest"
                },
                "examples": {
                  "snapshot": {
                    "summary": "빌드 스냅샷 기반 예제. 현재 응답과 시점 차이가 있을 수 있습니다.",
                    "value": {
                      "source": "phone.apthow.com",
                      "service": "알뜰폰 요금지도",
                      "timezone": "Asia/Seoul",
                      "asOf": "2026-11-21T14:04:19+09:00",
                      "oldestCheckedAt": "2026-11-21T10:08:59+09:00",
                      "missingCheckedAt": 0,
                      "exportedAt": "2026-11-21T05:04:24+00:00",
                      "totalPlans": 3399,
                      "tiers": [
                        {
                          "dataMinGb": 1,
                          "cheapestCurrent": {
                            "id": "308",
                            "carrier": "KG모바일",
                            "carrierCode": "kgmobile",
                            "name": "[일반] 실속 (10GB/300분)",
                            "mno": "LGU",
                            "network": "LTE",
                            "dataGb": 10,
                            "dailyDataGb": null,
                            "qosKbps": null,
                            "voiceUnlimited": false,
                            "voice": "300분",
                            "sms": "100건",
                            "monthlyPrice": 10,
                            "discountMonths": null,
                            "monthlyPriceAfter": null,
                            "total12Months": null,
                            "pricingKnown": false,
                            "priceSteps": [],
                            "planType": "unknown",
                            "detailUrl": "https://phone.apthow.com/plans/kgmobile-308/",
                            "checkedAt": "2026-11-21T14:03:31+09:00"
                          },
                          "cheapestLifetime": {
                            "id": "1049282",
                            "carrier": "모나모바일",
                            "carrierCode": "monamobile",
                            "name": "북앤라이프_300분4.5G",
                            "mno": "LGU",
                            "network": "LTE",
                            "dataGb": 4.5,
                            "dailyDataGb": null,
                            "qosKbps": null,
                            "voiceUnlimited": false,
                            "voice": "300분",
                            "sms": "200건",
                            "monthlyPrice": 10,
                            "discountMonths": null,
                            "monthlyPriceAfter": null,
                            "total12Months": 120,
                            "pricingKnown": true,
                            "priceSteps": [
                              {
                                "until_month": null,
                                "monthly_fee": 10
                              }
                            ],
                            "planType": "lifetime",
                            "detailUrl": "https://phone.apthow.com/plans/monamobile-1049282/",
                            "checkedAt": "2026-11-21T14:03:58+09:00"
                          },
                          "cheapest12Month": {
                            "id": "1371",
                            "carrier": "프리티",
                            "carrierCode": "freet",
                            "name": "음성기본데이터10G",
                            "mno": "SKT",
                            "network": "LTE",
                            "dataGb": 10,
                            "dailyDataGb": null,
                            "qosKbps": null,
                            "voiceUnlimited": true,
                            "voice": "기본제공",
                            "sms": "기본제공",
                            "monthlyPrice": 10,
                            "discountMonths": 12,
                            "monthlyPriceAfter": 27500,
                            "total12Months": 120,
                            "pricingKnown": true,
                            "priceSteps": [
                              {
                                "until_month": 12,
                                "monthly_fee": 10
                              },
                              {
                                "until_month": null,
                                "monthly_fee": 27500
                              }
                            ],
                            "planType": "period",
                            "detailUrl": "https://phone.apthow.com/plans/freet-1371/",
                            "checkedAt": "2026-11-21T14:03:17+09:00"
                          }
                        },
                        {
                          "dataMinGb": 5,
                          "cheapestCurrent": {
                            "id": "308",
                            "carrier": "KG모바일",
                            "carrierCode": "kgmobile",
                            "name": "[일반] 실속 (10GB/300분)",
                            "mno": "LGU",
                            "network": "LTE",
                            "dataGb": 10,
                            "dailyDataGb": null,
                            "qosKbps": null,
                            "voiceUnlimited": false,
                            "voice": "300분",
                            "sms": "100건",
                            "monthlyPrice": 10,
                            "discountMonths": null,
                            "monthlyPriceAfter": null,
                            "total12Months": null,
                            "pricingKnown": false,
                            "priceSteps": [],
                            "planType": "unknown",
                            "detailUrl": "https://phone.apthow.com/plans/kgmobile-308/",
                            "checkedAt": "2026-11-21T14:03:31+09:00"
                          },
                          "cheapestLifetime": {
                            "id": "1852",
                            "carrier": "아이즈모바일",
                            "carrierCode": "eyes",
                            "name": "세이브머니유심(100분/5GB)",
                            "mno": "LGU",
                            "network": "LTE",
                            "dataGb": 5,
                            "dailyDataGb": null,
                            "qosKbps": null,
                            "voiceUnlimited": false,
                            "voice": "100분",
                            "sms": "50건",
                            "monthlyPrice": 550,
                            "discountMonths": null,
                            "monthlyPriceAfter": null,
                            "total12Months": 6600,
                            "pricingKnown": true,
                            "priceSteps": [
                              {
                                "until_month": null,
                                "monthly_fee": 550
                              }
                            ],
                            "planType": "lifetime",
                            "detailUrl": "https://phone.apthow.com/plans/eyes-1852/",
                            "checkedAt": "2026-11-21T14:03:28+09:00"
                          },
                          "cheapest12Month": {
                            "id": "1371",
                            "carrier": "프리티",
                            "carrierCode": "freet",
                            "name": "음성기본데이터10G",
                            "mno": "SKT",
                            "network": "LTE",
                            "dataGb": 10,
                            "dailyDataGb": null,
                            "qosKbps": null,
                            "voiceUnlimited": true,
                            "voice": "기본제공",
                            "sms": "기본제공",
                            "monthlyPrice": 10,
                            "discountMonths": 12,
                            "monthlyPriceAfter": 27500,
                            "total12Months": 120,
                            "pricingKnown": true,
                            "priceSteps": [
                              {
                                "until_month": 12,
                                "monthly_fee": 10
                              },
                              {
                                "until_month": null,
                                "monthly_fee": 27500
                              }
                            ],
                            "planType": "period",
                            "detailUrl": "https://phone.apthow.com/plans/freet-1371/",
                            "checkedAt": "2026-11-21T14:03:17+09:00"
                          }
                        },
                        {
                          "dataMinGb": 10,
                          "cheapestCurrent": {
                            "id": "308",
                            "carrier": "KG모바일",
                            "carrierCode": "kgmobile",
                            "name": "[일반] 실속 (10GB/300분)",
                            "mno": "LGU",
                            "network": "LTE",
                            "dataGb": 10,
                            "dailyDataGb": null,
                            "qosKbps": null,
                            "voiceUnlimited": false,
                            "voice": "300분",
                            "sms": "100건",
                            "monthlyPrice": 10,
                            "discountMonths": null,
                            "monthlyPriceAfter": null,
                            "total12Months": null,
                            "pricingKnown": false,
                            "priceSteps": [],
                            "planType": "unknown",
                            "detailUrl": "https://phone.apthow.com/plans/kgmobile-308/",
                            "checkedAt": "2026-11-21T14:03:31+09:00"
                          },
                          "cheapestLifetime": {
                            "id": "1542",
                            "carrier": "프리티",
                            "carrierCode": "freet",
                            "name": "5G 든든한200분10G",
                            "mno": "KT",
                            "network": "5G",
                            "dataGb": 10,
                            "dailyDataGb": null,
                            "qosKbps": null,
                            "voiceUnlimited": false,
                            "voice": "200분",
                            "sms": "200건",
                            "monthlyPrice": 2200,
                            "discountMonths": null,
                            "monthlyPriceAfter": null,
                            "total12Months": 26400,
                            "pricingKnown": true,
                            "priceSteps": [
                              {
                                "until_month": null,
                                "monthly_fee": 2200
                              }
                            ],
                            "planType": "lifetime",
                            "detailUrl": "https://phone.apthow.com/plans/freet-1542/",
                            "checkedAt": "2026-11-21T14:03:26+09:00"
                          },
                          "cheapest12Month": {
                            "id": "1371",
                            "carrier": "프리티",
                            "carrierCode": "freet",
                            "name": "음성기본데이터10G",
                            "mno": "SKT",
                            "network": "LTE",
                            "dataGb": 10,
                            "dailyDataGb": null,
                            "qosKbps": null,
                            "voiceUnlimited": true,
                            "voice": "기본제공",
                            "sms": "기본제공",
                            "monthlyPrice": 10,
                            "discountMonths": 12,
                            "monthlyPriceAfter": 27500,
                            "total12Months": 120,
                            "pricingKnown": true,
                            "priceSteps": [
                              {
                                "until_month": 12,
                                "monthly_fee": 10
                              },
                              {
                                "until_month": null,
                                "monthly_fee": 27500
                              }
                            ],
                            "planType": "period",
                            "detailUrl": "https://phone.apthow.com/plans/freet-1371/",
                            "checkedAt": "2026-11-21T14:03:17+09:00"
                          }
                        },
                        {
                          "dataMinGb": 15,
                          "cheapestCurrent": {
                            "id": "1746",
                            "carrier": "아이즈모바일",
                            "carrierCode": "eyes",
                            "name": "[S]울트라(300분/15GB)",
                            "mno": "SKT",
                            "network": "LTE",
                            "dataGb": 15,
                            "dailyDataGb": null,
                            "qosKbps": null,
                            "voiceUnlimited": false,
                            "voice": "300분",
                            "sms": "100건",
                            "monthlyPrice": 10,
                            "discountMonths": 7,
                            "monthlyPriceAfter": 25300,
                            "total12Months": 126570,
                            "pricingKnown": true,
                            "priceSteps": [
                              {
                                "until_month": 7,
                                "monthly_fee": 10
                              },
                              {
                                "until_month": null,
                                "monthly_fee": 25300
                              }
                            ],
                            "planType": "period",
                            "detailUrl": "https://phone.apthow.com/plans/eyes-1746/",
                            "checkedAt": "2026-11-21T14:03:18+09:00"
                          },
                          "cheapestLifetime": {
                            "id": "67438",
                            "carrier": "프리티",
                            "carrierCode": "freet",
                            "name": "(5G)더든든한200분15G",
                            "mno": "KT",
                            "network": "5G",
                            "dataGb": 15,
                            "dailyDataGb": null,
                            "qosKbps": null,
                            "voiceUnlimited": false,
                            "voice": "200분",
                            "sms": "100건",
                            "monthlyPrice": 3300,
                            "discountMonths": null,
                            "monthlyPriceAfter": null,
                            "total12Months": 39600,
                            "pricingKnown": true,
                            "priceSteps": [
                              {
                                "until_month": null,
                                "monthly_fee": 3300
                              }
                            ],
                            "planType": "lifetime",
                            "detailUrl": "https://phone.apthow.com/plans/freet-67438/",
                            "checkedAt": "2026-11-21T14:03:17+09:00"
                          },
                          "cheapest12Month": {
                            "id": "1520700",
                            "carrier": "프리티",
                            "carrierCode": "freet",
                            "name": "하나은행 200분15G",
                            "mno": "SKT",
                            "network": "LTE",
                            "dataGb": 15,
                            "dailyDataGb": null,
                            "qosKbps": null,
                            "voiceUnlimited": false,
                            "voice": "200분",
                            "sms": "100건",
                            "monthlyPrice": 2200,
                            "discountMonths": 12,
                            "monthlyPriceAfter": 17600,
                            "total12Months": 26400,
                            "pricingKnown": true,
                            "priceSteps": [
                              {
                                "until_month": 12,
                                "monthly_fee": 2200
                              },
                              {
                                "until_month": null,
                                "monthly_fee": 17600
                              }
                            ],
                            "planType": "period",
                            "detailUrl": "https://phone.apthow.com/plans/freet-1520700/",
                            "checkedAt": "2026-11-21T14:03:22+09:00"
                          }
                        },
                        {
                          "dataMinGb": 30,
                          "cheapestCurrent": {
                            "id": "1845",
                            "carrier": "아이즈모바일",
                            "carrierCode": "eyes",
                            "name": "[S]울트라(300분/30GB)",
                            "mno": "SKT",
                            "network": "LTE",
                            "dataGb": 30,
                            "dailyDataGb": null,
                            "qosKbps": null,
                            "voiceUnlimited": false,
                            "voice": "300분",
                            "sms": "100건",
                            "monthlyPrice": 990,
                            "discountMonths": 7,
                            "monthlyPriceAfter": 44000,
                            "total12Months": 226930,
                            "pricingKnown": true,
                            "priceSteps": [
                              {
                                "until_month": 7,
                                "monthly_fee": 990
                              },
                              {
                                "until_month": null,
                                "monthly_fee": 44000
                              }
                            ],
                            "planType": "period",
                            "detailUrl": "https://phone.apthow.com/plans/eyes-1845/",
                            "checkedAt": "2026-11-21T14:03:27+09:00"
                          },
                          "cheapestLifetime": {
                            "id": "1469",
                            "carrier": "프리티",
                            "carrierCode": "freet",
                            "name": "더든든한500분30G",
                            "mno": "SKT",
                            "network": "LTE",
                            "dataGb": 30,
                            "dailyDataGb": null,
                            "qosKbps": null,
                            "voiceUnlimited": false,
                            "voice": "500분",
                            "sms": "100건",
                            "monthlyPrice": 8580,
                            "discountMonths": null,
                            "monthlyPriceAfter": null,
                            "total12Months": 102960,
                            "pricingKnown": true,
                            "priceSteps": [
                              {
                                "until_month": null,
                                "monthly_fee": 8580
                              }
                            ],
                            "planType": "lifetime",
                            "detailUrl": "https://phone.apthow.com/plans/freet-1469/",
                            "checkedAt": "2026-11-21T14:03:16+09:00"
                          },
                          "cheapest12Month": {
                            "id": "1469",
                            "carrier": "프리티",
                            "carrierCode": "freet",
                            "name": "더든든한500분30G",
                            "mno": "SKT",
                            "network": "LTE",
                            "dataGb": 30,
                            "dailyDataGb": null,
                            "qosKbps": null,
                            "voiceUnlimited": false,
                            "voice": "500분",
                            "sms": "100건",
                            "monthlyPrice": 8580,
                            "discountMonths": null,
                            "monthlyPriceAfter": null,
                            "total12Months": 102960,
                            "pricingKnown": true,
                            "priceSteps": [
                              {
                                "until_month": null,
                                "monthly_fee": 8580
                              }
                            ],
                            "planType": "lifetime",
                            "detailUrl": "https://phone.apthow.com/plans/freet-1469/",
                            "checkedAt": "2026-11-21T14:03:16+09:00"
                          }
                        },
                        {
                          "dataMinGb": 50,
                          "cheapestCurrent": {
                            "id": "239",
                            "carrier": "KG모바일",
                            "carrierCode": "kgmobile",
                            "name": "[모요 전용] 통화, 데이터 마음대로 100GB+",
                            "mno": "LGU",
                            "network": "LTE",
                            "dataGb": 100,
                            "dailyDataGb": null,
                            "qosKbps": 5120,
                            "voiceUnlimited": true,
                            "voice": "무제한",
                            "sms": "무제한",
                            "monthlyPrice": 6500,
                            "discountMonths": null,
                            "monthlyPriceAfter": null,
                            "total12Months": null,
                            "pricingKnown": false,
                            "priceSteps": [],
                            "planType": "unknown",
                            "detailUrl": "https://phone.apthow.com/plans/kgmobile-239/",
                            "checkedAt": "2026-11-21T14:03:24+09:00"
                          },
                          "cheapestLifetime": {
                            "id": "1049643",
                            "carrier": "모나모바일",
                            "carrierCode": "monamobile",
                            "name": "5G_신한카드_기본95G안심3",
                            "mno": "LGU",
                            "network": "5G",
                            "dataGb": 95,
                            "dailyDataGb": null,
                            "qosKbps": 3072,
                            "voiceUnlimited": true,
                            "voice": "기본제공",
                            "sms": "기본제공",
                            "monthlyPrice": 24500,
                            "discountMonths": null,
                            "monthlyPriceAfter": null,
                            "total12Months": 294000,
                            "pricingKnown": true,
                            "priceSteps": [
                              {
                                "until_month": null,
                                "monthly_fee": 24500
                              }
                            ],
                            "planType": "lifetime",
                            "detailUrl": "https://phone.apthow.com/plans/monamobile-1049643/",
                            "checkedAt": "2026-11-21T14:04:07+09:00"
                          },
                          "cheapest12Month": {
                            "id": "2191849",
                            "carrier": "인스모바일",
                            "carrierCode": "insmobile",
                            "name": "인스 유심 스피드(5G) 95GB+",
                            "mno": "LGU",
                            "network": "5G",
                            "dataGb": 95,
                            "dailyDataGb": null,
                            "qosKbps": 3072,
                            "voiceUnlimited": true,
                            "voice": "기본제공",
                            "sms": "기본제공",
                            "monthlyPrice": 13970,
                            "discountMonths": null,
                            "monthlyPriceAfter": null,
                            "total12Months": 167640,
                            "pricingKnown": true,
                            "priceSteps": [
                              {
                                "until_month": null,
                                "monthly_fee": 13970
                              }
                            ],
                            "planType": "flat",
                            "detailUrl": "https://phone.apthow.com/plans/insmobile-2191849/",
                            "checkedAt": "2026-11-21T14:04:02+09:00"
                          }
                        },
                        {
                          "dataMinGb": 100,
                          "cheapestCurrent": {
                            "id": "239",
                            "carrier": "KG모바일",
                            "carrierCode": "kgmobile",
                            "name": "[모요 전용] 통화, 데이터 마음대로 100GB+",
                            "mno": "LGU",
                            "network": "LTE",
                            "dataGb": 100,
                            "dailyDataGb": null,
                            "qosKbps": 5120,
                            "voiceUnlimited": true,
                            "voice": "무제한",
                            "sms": "무제한",
                            "monthlyPrice": 6500,
                            "discountMonths": null,
                            "monthlyPriceAfter": null,
                            "total12Months": null,
                            "pricingKnown": false,
                            "priceSteps": [],
                            "planType": "unknown",
                            "detailUrl": "https://phone.apthow.com/plans/kgmobile-239/",
                            "checkedAt": "2026-11-21T14:03:24+09:00"
                          },
                          "cheapestLifetime": {
                            "id": "1805890",
                            "carrier": "아이즈모바일",
                            "carrierCode": "eyes",
                            "name": "[L]5G 아이즈팩 150GB+",
                            "mno": "LGU",
                            "network": "LTE",
                            "dataGb": 150,
                            "dailyDataGb": null,
                            "qosKbps": 5120,
                            "voiceUnlimited": true,
                            "voice": "기본제공",
                            "sms": "기본제공",
                            "monthlyPrice": 25000,
                            "discountMonths": null,
                            "monthlyPriceAfter": null,
                            "total12Months": 300000,
                            "pricingKnown": true,
                            "priceSteps": [
                              {
                                "until_month": null,
                                "monthly_fee": 25000
                              }
                            ],
                            "planType": "lifetime",
                            "detailUrl": "https://phone.apthow.com/plans/eyes-1805890/",
                            "checkedAt": "2026-11-21T14:03:33+09:00"
                          },
                          "cheapest12Month": {
                            "id": "2191853",
                            "carrier": "인스모바일",
                            "carrierCode": "insmobile",
                            "name": "인스 유심 스피드(5G) 125GB+",
                            "mno": "LGU",
                            "network": "5G",
                            "dataGb": 125,
                            "dailyDataGb": null,
                            "qosKbps": 5120,
                            "voiceUnlimited": true,
                            "voice": "기본제공",
                            "sms": "기본제공",
                            "monthlyPrice": 14190,
                            "discountMonths": null,
                            "monthlyPriceAfter": null,
                            "total12Months": 170280,
                            "pricingKnown": true,
                            "priceSteps": [
                              {
                                "until_month": null,
                                "monthly_fee": 14190
                              }
                            ],
                            "planType": "flat",
                            "detailUrl": "https://phone.apthow.com/plans/insmobile-2191853/",
                            "checkedAt": "2026-11-21T14:04:02+09:00"
                          }
                        }
                      ]
                    }
                  }
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "example": "알뜰폰 요금지도\n출처: phone.apthow.com\n상품별 확인 시각과 요금은 응답 참조"
              }
            }
          },
          "400": {
            "description": "잘못된 입력",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "없는 경로 또는 상품",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "405": {
            "description": "미지원 메서드",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "description": "IP별 분당 한도 초과. Retry-After 참조",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "description": "내부 오류",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "description": "스냅샷 또는 제한 저장소 사용 불가",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/meta": {
      "get": {
        "operationId": "catalogMetadata",
        "summary": "스냅샷 시각과 상품 수",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "데이터 응답 형식",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "text"
              ],
              "default": "json",
              "description": "데이터 응답 형식"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "정상 응답",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Meta"
                },
                "examples": {
                  "snapshot": {
                    "summary": "빌드 스냅샷 기반 예제. 현재 응답과 시점 차이가 있을 수 있습니다.",
                    "value": {
                      "source": "phone.apthow.com",
                      "service": "알뜰폰 요금지도",
                      "timezone": "Asia/Seoul",
                      "asOf": "2026-11-21T14:04:19+09:00",
                      "oldestCheckedAt": "2026-11-21T10:08:59+09:00",
                      "missingCheckedAt": 0,
                      "exportedAt": "2026-11-21T05:04:24+00:00",
                      "totalPlans": 3399
                    }
                  }
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "example": "알뜰폰 요금지도\n출처: phone.apthow.com\n상품별 확인 시각과 요금은 응답 참조"
              }
            }
          },
          "400": {
            "description": "잘못된 입력",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "없는 경로 또는 상품",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "405": {
            "description": "미지원 메서드",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "description": "IP별 분당 한도 초과. Retry-After 참조",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "description": "내부 오류",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "description": "스냅샷 또는 제한 저장소 사용 불가",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/plans": {
      "get": {
        "operationId": "searchPlans",
        "summary": "요금제 조건 검색",
        "parameters": [
          {
            "name": "dataMin",
            "in": "query",
            "required": false,
            "description": "월 기본 데이터 GB",
            "schema": {
              "type": "number",
              "minimum": 0,
              "maximum": 10000,
              "description": "월 기본 데이터 GB"
            }
          },
          {
            "name": "feeMax",
            "in": "query",
            "required": false,
            "description": "첫 월요금 상한 원, 0 유효",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 10000000,
              "description": "첫 월요금 상한 원, 0 유효"
            }
          },
          {
            "name": "mno",
            "in": "query",
            "required": false,
            "description": "통신망",
            "schema": {
              "type": "string",
              "enum": [
                "SKT",
                "KT",
                "LGU"
              ],
              "description": "통신망"
            }
          },
          {
            "name": "network",
            "in": "query",
            "required": false,
            "description": "통신 세대",
            "schema": {
              "type": "string",
              "enum": [
                "LTE",
                "5G"
              ],
              "description": "통신 세대"
            }
          },
          {
            "name": "qosMin",
            "in": "query",
            "required": false,
            "description": "최소 소진 후 속도 kbps",
            "schema": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000,
              "description": "최소 소진 후 속도 kbps"
            }
          },
          {
            "name": "voiceUnlimited",
            "in": "query",
            "required": false,
            "description": "true는 무제한 상품만, false는 제한 없음",
            "schema": {
              "type": "boolean",
              "description": "true는 무제한 상품만, false는 제한 없음"
            }
          },
          {
            "name": "planType",
            "in": "query",
            "required": false,
            "description": "할인 유형, 미확인을 기간 할인으로 추정하지 않음",
            "schema": {
              "type": "string",
              "enum": [
                "lifetime",
                "period",
                "flat",
                "unknown",
                "all"
              ],
              "default": "all",
              "description": "할인 유형, 미확인을 기간 할인으로 추정하지 않음"
            }
          },
          {
            "name": "carrier",
            "in": "query",
            "required": false,
            "description": "통신사 코드 또는 이름의 부분 일치",
            "schema": {
              "type": "string",
              "maxLength": 100,
              "description": "통신사 코드 또는 이름의 부분 일치"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "오름차순, null은 마지막, 동률 ID순",
            "schema": {
              "type": "string",
              "enum": [
                "monthly",
                "total12"
              ],
              "default": "monthly",
              "description": "오름차순, null은 마지막, 동률 ID순"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "페이지 크기",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20,
              "description": "페이지 크기"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "페이지 번호",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 1,
              "description": "페이지 번호"
            }
          },
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "데이터 응답 형식",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "text"
              ],
              "default": "json",
              "description": "데이터 응답 형식"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "정상 응답",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchResult"
                },
                "examples": {
                  "snapshot": {
                    "summary": "빌드 스냅샷 기반 예제. 현재 응답과 시점 차이가 있을 수 있습니다.",
                    "value": {
                      "source": "phone.apthow.com",
                      "service": "알뜰폰 요금지도",
                      "timezone": "Asia/Seoul",
                      "asOf": "2026-11-21T14:04:19+09:00",
                      "oldestCheckedAt": "2026-11-21T10:08:59+09:00",
                      "missingCheckedAt": 0,
                      "exportedAt": "2026-11-21T05:04:24+00:00",
                      "totalPlans": 3399,
                      "total": 3399,
                      "page": 1,
                      "limit": 2,
                      "pages": 1700,
                      "filters": {
                        "limit": 2,
                        "page": 1,
                        "sort": "monthly",
                        "planType": "all"
                      },
                      "plans": [
                        {
                          "id": "308",
                          "carrier": "KG모바일",
                          "carrierCode": "kgmobile",
                          "name": "[일반] 실속 (10GB/300분)",
                          "mno": "LGU",
                          "network": "LTE",
                          "dataGb": 10,
                          "dailyDataGb": null,
                          "qosKbps": null,
                          "voiceUnlimited": false,
                          "voice": "300분",
                          "sms": "100건",
                          "monthlyPrice": 10,
                          "discountMonths": null,
                          "monthlyPriceAfter": null,
                          "total12Months": null,
                          "pricingKnown": false,
                          "priceSteps": [],
                          "planType": "unknown",
                          "detailUrl": "https://phone.apthow.com/plans/kgmobile-308/",
                          "checkedAt": "2026-11-21T14:03:31+09:00"
                        },
                        {
                          "id": "309",
                          "carrier": "KG모바일",
                          "carrierCode": "kgmobile",
                          "name": "[일반] 실속 (7GB/300분)",
                          "mno": "LGU",
                          "network": "LTE",
                          "dataGb": 7,
                          "dailyDataGb": null,
                          "qosKbps": null,
                          "voiceUnlimited": false,
                          "voice": "300분",
                          "sms": "100건",
                          "monthlyPrice": 10,
                          "discountMonths": null,
                          "monthlyPriceAfter": null,
                          "total12Months": null,
                          "pricingKnown": false,
                          "priceSteps": [],
                          "planType": "unknown",
                          "detailUrl": "https://phone.apthow.com/plans/kgmobile-309/",
                          "checkedAt": "2026-11-21T14:03:31+09:00"
                        }
                      ]
                    }
                  }
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "example": "알뜰폰 요금지도\n출처: phone.apthow.com\n상품별 확인 시각과 요금은 응답 참조"
              }
            }
          },
          "400": {
            "description": "잘못된 입력",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "없는 경로 또는 상품",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "405": {
            "description": "미지원 메서드",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "description": "IP별 분당 한도 초과. Retry-After 참조",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "description": "내부 오류",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "description": "스냅샷 또는 제한 저장소 사용 불가",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/search": {
      "get": {
        "operationId": "searchPlansByKeyword",
        "summary": "통신사·상품명 키워드 부분 검색",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "키워드, 자연어 조건 해석 없음",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 100,
              "description": "키워드, 자연어 조건 해석 없음"
            }
          },
          {
            "name": "dataMin",
            "in": "query",
            "required": false,
            "description": "월 기본 데이터 GB",
            "schema": {
              "type": "number",
              "minimum": 0,
              "maximum": 10000,
              "description": "월 기본 데이터 GB"
            }
          },
          {
            "name": "feeMax",
            "in": "query",
            "required": false,
            "description": "첫 월요금 상한 원, 0 유효",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 10000000,
              "description": "첫 월요금 상한 원, 0 유효"
            }
          },
          {
            "name": "mno",
            "in": "query",
            "required": false,
            "description": "통신망",
            "schema": {
              "type": "string",
              "enum": [
                "SKT",
                "KT",
                "LGU"
              ],
              "description": "통신망"
            }
          },
          {
            "name": "network",
            "in": "query",
            "required": false,
            "description": "통신 세대",
            "schema": {
              "type": "string",
              "enum": [
                "LTE",
                "5G"
              ],
              "description": "통신 세대"
            }
          },
          {
            "name": "qosMin",
            "in": "query",
            "required": false,
            "description": "최소 소진 후 속도 kbps",
            "schema": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000,
              "description": "최소 소진 후 속도 kbps"
            }
          },
          {
            "name": "voiceUnlimited",
            "in": "query",
            "required": false,
            "description": "true는 무제한 상품만, false는 제한 없음",
            "schema": {
              "type": "boolean",
              "description": "true는 무제한 상품만, false는 제한 없음"
            }
          },
          {
            "name": "planType",
            "in": "query",
            "required": false,
            "description": "할인 유형, 미확인을 기간 할인으로 추정하지 않음",
            "schema": {
              "type": "string",
              "enum": [
                "lifetime",
                "period",
                "flat",
                "unknown",
                "all"
              ],
              "default": "all",
              "description": "할인 유형, 미확인을 기간 할인으로 추정하지 않음"
            }
          },
          {
            "name": "carrier",
            "in": "query",
            "required": false,
            "description": "통신사 코드 또는 이름의 부분 일치",
            "schema": {
              "type": "string",
              "maxLength": 100,
              "description": "통신사 코드 또는 이름의 부분 일치"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "오름차순, null은 마지막, 동률 ID순",
            "schema": {
              "type": "string",
              "enum": [
                "monthly",
                "total12"
              ],
              "default": "monthly",
              "description": "오름차순, null은 마지막, 동률 ID순"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "페이지 크기",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20,
              "description": "페이지 크기"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "페이지 번호",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 1,
              "description": "페이지 번호"
            }
          },
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "데이터 응답 형식",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "text"
              ],
              "default": "json",
              "description": "데이터 응답 형식"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "정상 응답",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchResult"
                },
                "examples": {
                  "snapshot": {
                    "summary": "빌드 스냅샷 기반 예제. 현재 응답과 시점 차이가 있을 수 있습니다.",
                    "value": {
                      "source": "phone.apthow.com",
                      "service": "알뜰폰 요금지도",
                      "timezone": "Asia/Seoul",
                      "asOf": "2026-11-21T14:04:19+09:00",
                      "oldestCheckedAt": "2026-11-21T10:08:59+09:00",
                      "missingCheckedAt": 0,
                      "exportedAt": "2026-11-21T05:04:24+00:00",
                      "totalPlans": 3399,
                      "total": 1,
                      "page": 1,
                      "limit": 2,
                      "pages": 1,
                      "filters": {
                        "limit": 2,
                        "page": 1,
                        "sort": "monthly",
                        "planType": "all",
                        "q": "[평생할인] 데이터 마음대로 (10GB+/100분)"
                      },
                      "plans": [
                        {
                          "id": "217",
                          "carrier": "KG모바일",
                          "carrierCode": "kgmobile",
                          "name": "[평생할인] 데이터 마음대로 (10GB+/100분)",
                          "mno": "LGU",
                          "network": "LTE",
                          "dataGb": 10,
                          "dailyDataGb": null,
                          "qosKbps": 1024,
                          "voiceUnlimited": false,
                          "voice": "100분",
                          "sms": "100건",
                          "monthlyPrice": 6500,
                          "discountMonths": null,
                          "monthlyPriceAfter": null,
                          "total12Months": 78000,
                          "pricingKnown": true,
                          "priceSteps": [
                            {
                              "until_month": null,
                              "monthly_fee": 6500
                            }
                          ],
                          "planType": "lifetime",
                          "detailUrl": "https://phone.apthow.com/plans/kgmobile-217/",
                          "checkedAt": "2026-11-21T14:03:20+09:00"
                        }
                      ]
                    }
                  }
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "example": "알뜰폰 요금지도\n출처: phone.apthow.com\n상품별 확인 시각과 요금은 응답 참조"
              }
            }
          },
          "400": {
            "description": "잘못된 입력",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "없는 경로 또는 상품",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "405": {
            "description": "미지원 메서드",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "description": "IP별 분당 한도 초과. Retry-After 참조",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "description": "내부 오류",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "description": "스냅샷 또는 제한 저장소 사용 불가",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/plans/{id}": {
      "get": {
        "operationId": "getPlanDetail",
        "summary": "요금제 상세",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "상품 ID",
            "schema": {
              "type": "string",
              "pattern": "^[1-9][0-9]*$",
              "description": "상품 ID"
            }
          },
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "데이터 응답 형식",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "text"
              ],
              "default": "json",
              "description": "데이터 응답 형식"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "정상 응답",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "required": [
                    "source",
                    "service",
                    "timezone",
                    "asOf",
                    "oldestCheckedAt",
                    "missingCheckedAt",
                    "exportedAt",
                    "totalPlans",
                    "plan"
                  ],
                  "properties": {
                    "source": {
                      "type": "string",
                      "description": "출처"
                    },
                    "service": {
                      "type": "string",
                      "description": "서비스명"
                    },
                    "timezone": {
                      "type": "string",
                      "description": "시간대"
                    },
                    "asOf": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "포함 상품 중 가장 최근 확인 시각"
                    },
                    "oldestCheckedAt": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "포함 상품 중 가장 오래된 확인 시각"
                    },
                    "missingCheckedAt": {
                      "type": "integer",
                      "description": "확인 시각 미확인 상품 수"
                    },
                    "exportedAt": {
                      "type": "string",
                      "description": "DB 내보내기 시각"
                    },
                    "totalPlans": {
                      "type": "integer",
                      "description": "전체 활성 스냅샷 상품 수"
                    },
                    "plan": {
                      "$ref": "#/components/schemas/Plan"
                    }
                  }
                },
                "examples": {
                  "snapshot": {
                    "summary": "빌드 스냅샷 기반 예제. 현재 응답과 시점 차이가 있을 수 있습니다.",
                    "value": {
                      "source": "phone.apthow.com",
                      "service": "알뜰폰 요금지도",
                      "timezone": "Asia/Seoul",
                      "asOf": "2026-11-21T14:04:19+09:00",
                      "oldestCheckedAt": "2026-11-21T10:08:59+09:00",
                      "missingCheckedAt": 0,
                      "exportedAt": "2026-11-21T05:04:24+00:00",
                      "totalPlans": 3399,
                      "plan": {
                        "id": "217",
                        "carrier": "KG모바일",
                        "carrierCode": "kgmobile",
                        "name": "[평생할인] 데이터 마음대로 (10GB+/100분)",
                        "mno": "LGU",
                        "network": "LTE",
                        "dataGb": 10,
                        "dailyDataGb": null,
                        "qosKbps": 1024,
                        "voiceUnlimited": false,
                        "voice": "100분",
                        "sms": "100건",
                        "monthlyPrice": 6500,
                        "discountMonths": null,
                        "monthlyPriceAfter": null,
                        "total12Months": 78000,
                        "pricingKnown": true,
                        "priceSteps": [
                          {
                            "until_month": null,
                            "monthly_fee": 6500
                          }
                        ],
                        "planType": "lifetime",
                        "detailUrl": "https://phone.apthow.com/plans/kgmobile-217/",
                        "checkedAt": "2026-11-21T14:03:20+09:00"
                      }
                    }
                  }
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "example": "알뜰폰 요금지도\n출처: phone.apthow.com\n상품별 확인 시각과 요금은 응답 참조"
              }
            }
          },
          "400": {
            "description": "잘못된 입력",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "없는 경로 또는 상품",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "405": {
            "description": "미지원 메서드",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "description": "IP별 분당 한도 초과. Retry-After 참조",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "description": "내부 오류",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "description": "스냅샷 또는 제한 저장소 사용 불가",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/openapi.json": {
      "get": {
        "operationId": "getOpenApi",
        "summary": "OpenAPI 3.1 명세, format 미지원",
        "responses": {
          "200": {
            "description": "명세",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/openapi.json": {
      "get": {
        "operationId": "discoverOpenApi",
        "summary": "동일 생성 결과의 OpenAPI",
        "responses": {
          "200": {
            "description": "명세",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Plan": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "carrier",
          "carrierCode",
          "name",
          "mno",
          "network",
          "dataGb",
          "dailyDataGb",
          "qosKbps",
          "voiceUnlimited",
          "voice",
          "sms",
          "monthlyPrice",
          "discountMonths",
          "monthlyPriceAfter",
          "total12Months",
          "pricingKnown",
          "priceSteps",
          "planType",
          "detailUrl",
          "checkedAt"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "기존 상품 ID"
          },
          "carrier": {
            "type": "string",
            "description": "알뜰폰 통신사"
          },
          "carrierCode": {
            "type": "string",
            "description": "통신사 코드"
          },
          "name": {
            "type": "string",
            "description": "요금제명"
          },
          "mno": {
            "type": [
              "string",
              "null"
            ],
            "description": "원사업자 통신망",
            "enum": [
              "SKT",
              "KT",
              "LGU",
              null
            ]
          },
          "network": {
            "type": [
              "string",
              "null"
            ],
            "description": "통신 세대, 4G는 LTE로 정규화"
          },
          "dataGb": {
            "type": [
              "number",
              "null"
            ],
            "description": "월 기본 데이터 GB, 1GB=1024MB. 일 추가 데이터 제외"
          },
          "dailyDataGb": {
            "type": [
              "number",
              "null"
            ],
            "description": "일 추가 데이터 GB"
          },
          "qosKbps": {
            "type": [
              "number",
              "null"
            ],
            "description": "소진 후 속도 kbps, 기존 데이터의 1024 환산 기준"
          },
          "voiceUnlimited": {
            "type": "boolean",
            "description": "확인된 통화 무제한 여부"
          },
          "voice": {
            "type": [
              "string",
              "null"
            ],
            "description": "통화 원본 안내"
          },
          "sms": {
            "type": [
              "string",
              "null"
            ],
            "description": "문자 원본 안내"
          },
          "monthlyPrice": {
            "type": [
              "number",
              "null"
            ],
            "description": "현재 첫 월요금 원"
          },
          "discountMonths": {
            "type": [
              "number",
              "null"
            ],
            "description": "첫 요금 단계 종료 개월, 없는 경우 null"
          },
          "monthlyPriceAfter": {
            "type": [
              "number",
              "null"
            ],
            "description": "첫 요금 단계 직후 월요금 원"
          },
          "total12Months": {
            "type": [
              "number",
              "null"
            ],
            "description": "확인된 단계로 산정한 12개월 예상 합계. 유심비 등 제외, 단일 요금은 유지 가정"
          },
          "pricingKnown": {
            "type": "boolean",
            "description": "요금 단계 계산 가능 여부"
          },
          "priceSteps": {
            "type": "array",
            "description": "전체 가격 단계. until_month는 누적 종료 개월, null은 종료 경계 없음",
            "items": {
              "type": "object",
              "required": [
                "until_month",
                "monthly_fee"
              ],
              "additionalProperties": false,
              "properties": {
                "until_month": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "description": "누적 종료 개월"
                },
                "monthly_fee": {
                  "type": "integer",
                  "description": "월요금 원"
                }
              }
            }
          },
          "planType": {
            "type": "string",
            "description": "명시적 평생 할인 / 기간 단계 / 확인된 정가 / 미확인",
            "enum": [
              "lifetime",
              "period",
              "flat",
              "unknown"
            ]
          },
          "detailUrl": {
            "type": "string",
            "description": "기존 상세 페이지 URL",
            "format": "uri"
          },
          "checkedAt": {
            "type": [
              "string",
              "null"
            ],
            "description": "상품의 원본 last_seen_at, 독립 원문 검증 시각을 보증하지 않음",
            "format": "date-time"
          }
        }
      },
      "Meta": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "source",
          "service",
          "timezone",
          "asOf",
          "oldestCheckedAt",
          "missingCheckedAt",
          "exportedAt",
          "totalPlans"
        ],
        "properties": {
          "source": {
            "type": "string",
            "description": "출처"
          },
          "service": {
            "type": "string",
            "description": "서비스명"
          },
          "timezone": {
            "type": "string",
            "description": "시간대"
          },
          "asOf": {
            "type": [
              "string",
              "null"
            ],
            "description": "포함 상품 중 가장 최근 확인 시각"
          },
          "oldestCheckedAt": {
            "type": [
              "string",
              "null"
            ],
            "description": "포함 상품 중 가장 오래된 확인 시각"
          },
          "missingCheckedAt": {
            "type": "integer",
            "description": "확인 시각 미확인 상품 수"
          },
          "exportedAt": {
            "type": "string",
            "description": "DB 내보내기 시각"
          },
          "totalPlans": {
            "type": "integer",
            "description": "전체 활성 스냅샷 상품 수"
          }
        }
      },
      "Error": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "code",
              "message"
            ],
            "properties": {
              "code": {
                "type": "string",
                "description": "안전한 오류 코드"
              },
              "message": {
                "type": "string",
                "description": "오류 설명"
              }
            }
          }
        }
      },
      "Cheapest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "source",
          "service",
          "timezone",
          "asOf",
          "oldestCheckedAt",
          "missingCheckedAt",
          "exportedAt",
          "totalPlans",
          "tiers"
        ],
        "properties": {
          "source": {
            "type": "string",
            "description": "출처"
          },
          "service": {
            "type": "string",
            "description": "서비스명"
          },
          "timezone": {
            "type": "string",
            "description": "시간대"
          },
          "asOf": {
            "type": [
              "string",
              "null"
            ],
            "description": "포함 상품 중 가장 최근 확인 시각"
          },
          "oldestCheckedAt": {
            "type": [
              "string",
              "null"
            ],
            "description": "포함 상품 중 가장 오래된 확인 시각"
          },
          "missingCheckedAt": {
            "type": "integer",
            "description": "확인 시각 미확인 상품 수"
          },
          "exportedAt": {
            "type": "string",
            "description": "DB 내보내기 시각"
          },
          "totalPlans": {
            "type": "integer",
            "description": "전체 활성 스냅샷 상품 수"
          },
          "tiers": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "dataMinGb",
                "cheapestCurrent",
                "cheapestLifetime",
                "cheapest12Month"
              ],
              "properties": {
                "dataMinGb": {
                  "type": "number",
                  "description": "최소 기본 데이터 GB, 상한 없음"
                },
                "cheapestCurrent": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Plan"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "cheapestLifetime": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Plan"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "cheapest12Month": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/Plan"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              }
            }
          }
        }
      },
      "SearchResult": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "source",
          "service",
          "timezone",
          "asOf",
          "oldestCheckedAt",
          "missingCheckedAt",
          "exportedAt",
          "totalPlans",
          "total",
          "page",
          "limit",
          "pages",
          "filters",
          "plans"
        ],
        "properties": {
          "source": {
            "type": "string",
            "description": "출처"
          },
          "service": {
            "type": "string",
            "description": "서비스명"
          },
          "timezone": {
            "type": "string",
            "description": "시간대"
          },
          "asOf": {
            "type": [
              "string",
              "null"
            ],
            "description": "포함 상품 중 가장 최근 확인 시각"
          },
          "oldestCheckedAt": {
            "type": [
              "string",
              "null"
            ],
            "description": "포함 상품 중 가장 오래된 확인 시각"
          },
          "missingCheckedAt": {
            "type": "integer",
            "description": "확인 시각 미확인 상품 수"
          },
          "exportedAt": {
            "type": "string",
            "description": "DB 내보내기 시각"
          },
          "totalPlans": {
            "type": "integer",
            "description": "전체 활성 스냅샷 상품 수"
          },
          "total": {
            "type": "integer",
            "description": "필터 일치 건수"
          },
          "page": {
            "type": "integer",
            "description": "현재 페이지"
          },
          "limit": {
            "type": "integer",
            "description": "페이지 크기"
          },
          "pages": {
            "type": "integer",
            "description": "전체 페이지 수"
          },
          "filters": {
            "type": "object",
            "description": "검증한 적용 필터"
          },
          "plans": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Plan"
            }
          }
        }
      }
    }
  }
}
