공개 데이터 / 개발자 문서

알뜰폰 요금제 API · AI 연결

요금제 비교에 쓰는 동일한 스냅샷을 JSON·TEXT와 읽기 전용 MCP 도구로 조회하세요.

제공 데이터

통신사·요금제명·기본 데이터·일 추가 데이터·QoS·첫 월요금·할인 단계·12개월 예상 총액·상품 확인 시각을 제공합니다. 오늘의 데이터별 최저가에서 같은 산정 결과를 볼 수 있습니다.

상품 상세: /api/v1/plans/{id}. 검색 응답의 id를 사용하며 detailUrl은 기존 상세 페이지로 연결됩니다.

API 엔드포인트

기본 데이터 구간별 현재·평생·12개월 최저가GET /api/v1/cheapest
최저가 TEXTGET /api/v1/cheapest?format=text
통신사·요금제명 키워드 검색GET /api/v1/search?q=프리티
데이터 기준 시각·개수GET /api/v1/meta
OpenAPI 3.1 명세GET /api/v1/openapi.json

호출 예제

curl "https://phone.apthow.com/api/v1/cheapest"
curl "https://phone.apthow.com/api/v1/cheapest?format=text"
curl "https://phone.apthow.com/api/v1/plans?dataMin=10&feeMax=10000&limit=10"

JSON 구조 예제

아래는 구조 설명용이며 실제 상품·가격이 아닙니다. 위 API 링크에서 현재 응답을 확인하세요.

{ "dataMinGb": 10, "cheapestCurrent": { "id": "상품 ID", "monthlyPrice": 5000, "total12Months": null }, "cheapestLifetime": null }

TEXT 응답

같은 데이터에 format=text를 지정하면 한글 필드 설명과 요금·확인 시각을 text/plain으로 반환합니다. JSON과 동일한 계산 결과입니다.

알뜰폰 요금지도
출처: phone.apthow.com
데이터 기준: 상품의 최근 확인 시각
[tiers]
  기본 데이터(GB): 구간별 제공량
  첫 월요금(원): 확인된 금액
  12개월 예상 요금(원): 확인된 단계 합계 또는 미확인

검색 파라미터

파라미터의미
dataMin월 기본 데이터 GB, 1GB=1024MB
feeMax첫 월요금 상한 원, 0원 포함
mnoSKT / KT / LGU
networkLTE / 5G (4G는 LTE로 통일)
qosMin최소 소진 후 속도 kbps
voiceUnlimitedtrue: 확인된 통화 무제한만 / false: 제한 없음
planTypelifetime / period / flat / unknown / all
carrier통신사 코드 또는 이름 부분 일치
sortmonthly / total12, 오름차순, 미확인 마지막, 동률 ID순
limit / page기본 20개 / 1페이지, 최대 100개 / 100페이지

검색 결과의 total·page·limit·pages·filters를 확인하세요. /search는 q(최대 100자)가 필수이며 위 조건을 함께 사용할 수 있습니다. 자연어 조건 추론은 하지 않습니다. 잘못된 값·미지원 조건·중복 키는 400입니다.

OpenAPI 및 AI 안내

OpenAPI 3.1 다운로드 · 발견용 동일 명세 · llms.txt · 전체 AI 안내

format=json(기본)·text는 데이터 조회 API에 적용됩니다. OpenAPI 문서는 JSON으로만 제공합니다.

MCP 연결

서버 주소: https://phone.apthow.com/mcp · Streamable HTTP · 인증 없음 · 읽기 전용

지원 버전은 2025-11-25(초기화 호환)와 2026-07-28(요청별 메타데이터)입니다. HTTP MCP를 지원하는 클라이언트에 위 주소를 등록하세요. 서버 메타데이터

  • search_plans: 위 검색 파라미터로 조건 조회
  • get_plan_detail: 문자열 id로 상세 조회
  • cheapest_by_data: 인수 없이 데이터 구간별 최저가

각 POST의 Accept에는 application/json과 text/event-stream을 포함합니다. JSON 응답을 사용하며 GET 스트림·세션은 제공하지 않습니다. Origin이 없는 서버 클라이언트를 허용하고, 브라우저 Origin은 기본적으로 이 사이트만 허용합니다.

이용 조건 및 제한

출처로 알뜰폰 요금지도(phone.apthow.com)와 상품 확인 시각을 함께 표시하세요. 공개 API 조회 및 출처를 표시한 결과 인용을 허용합니다. 원본 통신사 문구·상표에 대한 권리 이전을 의미하지 않습니다. IP당 분당 60회(REST·MCP 합산), 최대 응답 2MiB, MCP 본문 64KiB입니다. 제한 초과는 429와 Retry-After를 반환합니다.

REST는 GET·HEAD, CORS는 공개 읽기를 허용합니다. OPTIONS를 지원합니다. 오류는 400(입력), 404(없는 상품·경로), 405(메서드), 429(한도), 500(내부 오류), 503(데이터·제한 저장소 사용 불가)입니다.

데이터 갱신·산정 기준

기존 수집 후 전체 빌드·배포가 완료된 스냅샷을 제공합니다. asOf는 포함 상품 중 가장 최근 확인 시각, oldestCheckedAt은 가장 오래된 확인 시각, checkedAt은 상품별 last_seen_at입니다. exportedAt은 DB 내보내기 시각이며 수집 시각과 다릅니다. 실시간 수집 API가 아닙니다.

기본 데이터에 일 추가 데이터·QoS를 합산하지 않습니다. 구간은 해당 기본 데이터 이상이며 상한이 없어 동일 상품이 여러 구간에 선정될 수 있습니다. 가격·기본 데이터·확인 시각을 가진 상품에서 비교하며, 평생 할인은 명시적 근거가 있는 상품만 인정합니다. 12개월 총액은 확인된 요금 단계로 계산하며 정가 단일 요금은 현재 요금 유지 가정입니다. 미확인은 null이고 할인기간 누락을 평생으로 분류하지 않습니다.

ETag 재검증으로 배포된 데이터 변경을 반영합니다. 유심비·부가서비스·초과 사용료·일할 계산은 제외하며 미래 가격을 보장하지 않습니다. 실제 가입 조건은 통신사에서 최종 확인하세요.

자주 묻는 질문

상품 상세가 검색엔진에 없는데 API에는 있나요?

페이지 색인 선별과 공개 요금 조회는 다른 기준입니다. 응답의 detailUrl로 실제 상세 페이지를 확인할 수 있습니다.

총액이 null인 이유는 무엇인가요?

가격 단계나 할인 조건을 확인할 수 없으면 임의 계산하지 않습니다.

데이터는 얼마나 최신인가요?

상품별 checkedAt을 확인하세요. API 호출이나 재빌드 시각을 최신 수집 시각으로 표시하지 않습니다.