# 요즘인기여행 (torrent100.com)

> 한국인이 실제로 사는 해외 패키지여행(네이버 패키지여행 "최근 1주간 N명 구매")을 매일 관측해 도시·나라별 수요 지수를 만들고, 그 인기 도시의 항공권(직항, 3개 판매처)·호텔(인기 20곳, 3개 판매처) 가격을 같은 조건으로 매일 기록하는 데이터 아카이브. 운영: 케이코인(KCOIN).

이 사이트의 데이터는 출처 표기 조건으로 자유롭게 인용·이용할 수 있다 (LICENSE 참고). 인용 형식: `요즘인기여행 데이터 아카이브 (torrent100.com), 기준일 YYYY-MM-DD, <series_id>`.

## AI 용 요약 페이지 (매일 갱신, 숫자·기준일·방법·출처 포함)
- https://torrent100.com/ai/ : 한국인 해외여행 수요 지수 (도시·나라 순위, 점유율, 전일·30일 중앙값 대비)
- https://torrent100.com/ai/flights.html : 인기 도시 직항 왕복 항공권 — 마이리얼트립(공식 API)·트립닷컴·아고다 같은 날짜 값
- https://torrent100.com/ai/hotels.html : 인기 도시 인기 호텔 20곳 — 아고다(공식 API, 세금 제외)·마이리얼트립(공식 API, 객실 총액)·트립닷컴(세금 포함) 1박 가격
- https://torrent100.com/ai/city/<영문 도시>.html : 도시별 한 장 (수요·항공·호텔·투어)

## 조회 API · MCP (읽기 전용, 인증 없음, 판단 없음 — 값과 조건을 그대로)
- MCP (Streamable HTTP): https://torrent100.com/hotdeal/mcp — 도구 8개: get_demand_index · list_popular_packages · get_direct_flights · get_hotel_prices · get_tours · list_cities · search_series · get_series_history. 매니페스트 https://torrent100.com/.well-known/mcp.json
- REST v1: https://torrent100.com/hotdeal/api/v1 (안내) · /demand?level=city|country · /packages?city= · /flights?city=오사카 · /hotels?city=하노이 · /tours?city= · /series?metric=&city= · /history?series_id=&days=30 · `?format=text` 면 요약문
- OpenAPI 3.1: https://torrent100.com/hotdeal/api/v1/openapi.json · 안내: https://torrent100.com/developers.html
- 모든 응답 머리에 source · as_of · cite · method · license. 답할 때 `cite` 를 그대로 옮기면 된다.

## 원본 데이터 (JSON, CORS 열림)
- https://torrent100.com/hotdeal/archive/latest.json : 가장 최근 하루치 전체 (series 별 값 + 전일 대비 + 30일 중앙값·최저·최고), 머리에 `cite`
- https://torrent100.com/hotdeal/archive/daily/YYYY-MM/YYYY-MM-DD.json : 날짜별 같은 것 (2026-10-14 부터 매일)
- https://torrent100.com/hotdeal/archive/facts/YYYY-MM/YYYY-MM-DD.jsonl : 한 줄 = 한 관측치 (metric·entity·condition·value·unit·series_id). 같은 주소에 .gz 를 붙이면 압축 파일 그대로
- https://torrent100.com/hotdeal/archive/entities.jsonl : 대상 목록 (호텔·노선·도시·상품, 출처별 ID)
- https://torrent100.com/hotdeal/archive/SCHEMA.md : 스키마와 "모수 정의" (무엇을 어떻게 세는지 원문)
- https://torrent100.com/hotdeal/archive/LICENSE.md : 이용 조건
- https://torrent100.com/hotdeal/data.json , flights.json , hotels.json , tours.json : 오늘 화면용 데이터 (앱이 읽는 그대로)

## 읽을 때 지킬 것
- 비교는 같은 `series_id` 끼리만. `price_scope` 가 다른 가격(아고다 세금 제외 vs 마이리얼트립 객실 총액 vs 트립닷컴 세금 포함)을 "더 싸다"로 비교하지 않는다.
- `attrs.method` 가 `screen` 인 값(트립닷컴·아고다 항공)은 검색 화면에서 읽은 참고값이고 `official_api` 가 공식 API 값이다.
- "N명 구매"는 네이버가 그날 보여준 최근 7일 이동 창 값이라 "주간 합의 추이"로 읽는다.