마이리얼트립 파트너 API 활용법 — 자동화 4가지

여행 글 하나에 숙소 다섯 곳을 소개하려면 상품 페이지를 열고, 주소를 복사하고, 파트너 페이지에서 링크를 만드는 일을 다섯 번 반복해야 합니다. 가격이 바뀌면 글도 다시 고쳐야 합니다. 마이리얼트립 파트너 API는 이 반복 작업을 프로그램에 맡길 수 있게 해 줍니다.

결론부터 말하면 API로 할 수 있는 일은 크게 네 가지입니다. ① 투어·숙소 상품 검색, ② 내 광고 링크(마이링크) 자동 생성, ③ 항공권 랜딩 링크 생성, ④ 수익 조회. 이 네 가지를 묶으면 "글에 들어갈 상품 비교표와 링크를 자동으로 만들고, 어떤 글이 돈을 벌었는지 매일 집계하는" 구조를 만들 수 있습니다.

이 글은 제가 실제로 키를 발급해 호출해 본 결과를 바탕으로 썼습니다. 코딩이 처음이라면 파트너 페이지 화면 구성을 먼저 보시고, 이 글은 "이런 것도 되는구나" 정도로 읽으셔도 됩니다.

API 키 발급 — 계정당 1개, 재발급하면 이전 키는 끝

파트너 페이지 왼쪽 OPEN API > API Key 발급에서 키를 만듭니다. 직접 써 보면서 알게 된 점이 있습니다.

• 사용 가능한 키는 계정당 1개입니다. 블로그용과 다른 용도로 키를 하나씩 따로 받으려고 재발급했더니, 먼저 받은 키가 바로 401 Invalid API Key로 막혔습니다.
• 키에는 권한이 붙어 있습니다: MYLINK:WRITE(링크 생성), PRODUCTS:WRITE(상품 검색), RESERVATIONS:READ(예약 조회), REVENUES:READ(수익 조회).
• 여러 프로젝트에서 쓴다면 키 하나를 공용으로 쓰고, 어느 쪽 성과인지는 링크에 붙이는 utm_content 값으로 구분하는 게 낫습니다.
• 키는 비밀번호처럼 다뤄야 합니다. 코드에 직접 쓰지 말고 환경 변수(.env)에 넣고, 깃허브 같은 공개 저장소에 올리지 마세요.

API로 할 수 있는 일 4가지

기능	엔드포인트	핵심 입력값	받는 것
투어·티켓 검색	POST /v1/products/tna/search	keyword(필수), city, category	상품명, 가격, 평점, 리뷰 수, 이미지, 상품 주소
숙소 검색	POST /v1/products/accommodation/search	keyword, checkIn, checkOut, adultCount	숙소명, 판매가·정가, 성급, 평점, 상품 주소
마이링크 생성	POST /v1/mylink	targetUrl	myrealt.rip/… 단축 링크
수익 조회	GET /v1/revenues	기간, 기준(정산일 등)	링크별 예약·판매가·수수료·상태

모든 요청은 https://partner-ext-api.myrealtrip.com 으로 보내고, 헤더에 Authorization: Bearer 키를 넣습니다. 응답은 data, meta, result 세 부분으로 옵니다.

실제로 써 보니 헷갈렸던 점

• 숙소 검색의 인원 필드는 adult가 아니라 **adultCount**입니다. 틀린 필드명은 오류 없이 무시돼서 원인을 찾기 어렵습니다.
• 투어 검색은 keyword가 필수입니다. 도시만 넣으면 결과가 나오지 않습니다.
• /v1/mylink는 호출할 때마다 새 링크 ID를 줍니다. 같은 상품이라도 글마다 다른 링크를 만들면 글별 성과를 따로 볼 수 있습니다.
• 상품 주소는 응답의 productUrl을 그대로 쓰세요. 상품 ID로 주소를 직접 조합하면 틀리기 쉽습니다.

예시: 숙소 비교표를 자동으로 만들기

블로그에 "오사카 난바 숙소 비교" 글을 쓴다고 해 봅시다. 흐름은 이렇습니다.

1. 숙소 검색 API에 keyword: "난바", 체크인·체크아웃 날짜, adultCount: 2를 넣어 후보를 받습니다.
2. 평점·리뷰 수 기준으로 상위 5개를 고릅니다.
3. 각 숙소의 productUrl을 마이링크 API에 넣어 내 링크로 바꿉니다.
4. 숙소명·가격·평점·링크를 표로 만들고, 조회 날짜를 함께 적습니다.

curl -X POST https://partner-ext-api.myrealtrip.com/v1/products/accommodation/search \
  -H "Authorization: Bearer $MYREALTRIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"난바","checkIn":"2026-12-10","checkOut":"2026-12-12","adultCount":2}'

여기서 중요한 원칙이 하나 있습니다. 가격은 계속 바뀝니다. 글에 가격을 고정해 박아 두면 며칠 만에 틀린 정보가 됩니다. 표에는 "○월 ○일 조회 기준"을 꼭 적고, 하루 한 번 다시 조회해 갱신하는 구조가 좋습니다.

항공권 링크와 최저가 캘린더

항공권은 일반 상품과 달리 2단계로 링크를 만듭니다.

1. POST /v1/products/flight/fare-query-landing-url에 출발·도착 공항, 여정 종류(편도·왕복), 날짜, 인원을 넣어 검색 결과 페이지 주소를 받습니다.
2. 그 주소를 /v1/mylink에 넣어 내 링크로 바꿉니다.

공항 코드를 모르면 airport-autocomplete로 찾을 수 있고, flight/calendar 계열 API로 날짜별 직항 왕복 최저가를 받을 수 있습니다. "12월 오사카 항공권 가장 싼 날" 같은 글에 쓰기 좋습니다. 다만 이 가격은 실시간 값이 아니라 수집해 둔 값이라, 글에는 참고가로만 표기하는 게 안전합니다.

수익 조회 자동화 — 어떤 글이 돈을 버나

/v1/revenues는 링크별 예약과 수수료를 돌려줍니다. 앞에서 글마다 다른 링크를 만들어 두면, 매일 아침 이 API를 불러 **"어제 어떤 글에서 예약이 났는지"**를 표로 받아 볼 수 있습니다. 파트너 페이지 엑셀 다운로드를 매번 하지 않아도 됩니다.

코딩 없이 쓰는 방법: MCP

마이리얼트립은 AI 도구에서 바로 상품을 검색할 수 있는 MCP 서버도 공개했습니다. Claude 같은 AI 도구에 연결하면 "12월 오사카 2박 숙소 평점순으로 찾아줘"처럼 말로 검색할 수 있습니다. 숙소·국내외 항공·투어 검색과 날짜별 최저가 같은 도구가 들어 있습니다. 글감 조사용으로는 이쪽이 훨씬 편합니다.

자주 묻는 질문

마이리얼트립 파트너 API는 무료인가요?

파트너 페이지에서 키를 발급받아 쓰는 데 별도 비용은 안내되어 있지 않습니다. 다만 API마다 호출 횟수 제한이 있어서, 너무 자주 부르면 429 응답이 옵니다.

API 키를 재발급하면 어떻게 되나요?

사용 가능한 키가 계정당 하나라서, 재발급하면 이전 키는 바로 쓸 수 없게 됩니다. 키를 쓰는 모든 곳의 설정을 새 키로 바꿔야 합니다.

API로 만든 링크도 파트너 페이지에서 만든 링크와 똑같이 수익이 잡히나요?

네, 둘 다 내 파트너 계정의 마이링크입니다. API로 만든 링크도 수익 현황과 수익 조회 API에 똑같이 잡힙니다.

개발을 몰라도 쓸 수 있나요?

API는 간단한 코드가 필요합니다. 코드 없이 쓰고 싶다면 MCP를 지원하는 AI 도구에 연결해 검색만 활용하는 방법이 현실적입니다.

정리

API는 "링크를 자동으로 만들고, 표를 자동으로 갱신하고, 성과를 자동으로 집계하는" 데 쓰는 도구입니다. 키가 하나뿐이라는 점과 가격은 참고가로만 쓴다는 점만 기억하면 됩니다. 다음 글에서는 링크 수수료와 별개로 원고료를 받을 수 있는 광고매칭플러스를 다룹니다.

---

이 글의 화면 캡처 출처: 마이리얼트립 파트너 페이지(partner.myrealtrip.com), 2026년 10월 9일 캡처. 설명을 위해 번호 표시를 덧붙였고, 개인정보와 API 키는 가렸습니다.