100 크레딧 무료, 카드 등록 없이지금 시작하기
Logo
무료로 시작하기
Tripadvisor logoTripadvisor API

Tripadvisor 장소 리뷰 데이터 API

SocialCrawl API 키로 Tripadvisor 장소 검색과 리뷰를 구조화 JSON으로 가져옵니다. 공유 장소·리뷰 스키마입니다. 호출은 크레딧으로 과금됩니다.

문서 보기동작 방식직접 호출
Tripadvisor logo
/v1/tripadvisor

활성 엔드포인트는 2개입니다. 모두 표준 티어입니다.

  • GET /v1/tripadvisor/search
  • GET /v1/tripadvisor/reviews

Tripadvisor 엔드포인트

Tripadvisor 읽기 엔드포인트는 2개입니다. 장소를 검색한 뒤 url_path로 리뷰를 가져옵니다. 호텔, 식당, 명소입니다. 읽기 전용입니다.

장소 검색

1 크레딧
/v1/tripadvisor/search

Tripadvisor 장소·비즈니스를 검색합니다. reviews용 url_path가 있는 PlaceList를 반환합니다. location과 language를 선택할 수 있습니다.

q, location, language, depth

장소 리뷰

1 크레딧
/v1/tripadvisor/reviews

검색에서 얻은 url_path로 장소 리뷰를 가져옵니다. 평점, 본문, 작성자, 선택 depth·sort가 있습니다.

url_path, depth, sort_by

TripAdvisor API16개 엔드포인트 지원
문서 보기
Places
Hotels
Restaurants
Attractions
Cruises

특정 지역에서 키워드와 맞는 TripAdvisor 장소를 이름, 분류, 별점, 총 리뷰 수, 장소를 가리키는 url_path와 함께 반환합니다.

식당이나 호텔, 관광지를 찾고 reviews에 넘길 url_path를 확보할 때 사용하세요.

1크레딧

GET/v1/tripadvisor/search?q=pizza+restaurant&location=New+York%2CNew+York%2CUnited+States

q · Business category, company name, or prominent place (e.g. 'pizza restaurant').

$ curl https://www.socialcrawl.dev/v1/tripadvisor/search?q=pizza+restaurant&location=New+York%2CNew+York%2CUnited+States \
    -H "x-api-key: sc_YOUR_API_KEY"
대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다

Tripadvisor API 동작

Tripadvisor도 다른 SocialCrawl 데이터 엔드포인트와 같습니다. API 키로 GET /v1/tripadvisor/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다.

호출 인증

x-api-key 헤더에 키를 보냅니다. 공개 읽기에 Tripadvisor OAuth 앱은 필요 없습니다. SocialCrawl 전 플랫폼에 같은 키를 사용합니다.

GET과 쿼리 파라미터

Tripadvisor 라우트는 모두 GET입니다. q, location, url_path, depth, sort_by, language를 쿼리로 전달합니다. 과금 전에 형식을 검증합니다.

크레딧 과금

두 라우트 모두 표준 티어입니다. 라이브 미스는 1 크레딧입니다. 캐시 히트는 0 크레딧입니다. 빈 응답과 하드 실패는 환불됩니다.

JSON 봉투

응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 페이지가 있는 목록 응답은 페이지네이션 필드를 가집니다.

연동 순서

대부분 제품은 엔티티를 먼저 찾은 뒤 필요할 때만 상세와 리뷰를 깊게 봅니다.

01검색
GET /v1/tripadvisor/search?q=…

url_path가 있는 PlaceList

reviews에는 검색의 url_path가 필요합니다.

02리뷰
GET /v1/tripadvisor/reviews?url_path=…

장소 ReviewList

호텔·식당·명소 방문객 언어입니다.

03지역
GET /v1/tripadvisor/search?q=…&location=…

location 문자열로 좁힌 장소 결과

같은 쿼리도 도시마다 다릅니다.

04깊이
GET /v1/tripadvisor/reviews?url_path=…&depth=50

한 호출에서 더 큰 리뷰 창

별도 제품 없이 depth로 볼륨을 조절합니다.

요청
GET /v1/tripadvisor/search?q=pizza+restaurant&location=New+York,New+York,United+States
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here

GET /v1/tripadvisor/reviews?url_path=Hotel_Review-g60763-d23462501-Reviews-…&depth=10
응답 봉투
{
  "success": true,
  "data": {
    "items": [
      {
        "place": {
          "id": "d23462501",
          "name": "Example hotel",
          "url": "https://www.tripadvisor.com/Hotel_Review-…",
          "rating": 4.5
        }
      }
    ]
  },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

data 형태

아키타입이 맞는 범위에서 필드 이름은 SocialCrawl 나머지와 같습니다. 한 번 파싱해 플랫폼에 재사용합니다.

PlaceListsearch

items[]에 place name, rating, url_path

ReviewListreviews

items[]에 rating, text, author, published_at

지역 한정 장소search + location

location 문자열로 필터된 PlaceList

리뷰 창reviews + depth

depth 제한 리뷰 집합

게이트웨이 내부

다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. Tripadvisor은 사이드카가 아닙니다.

  1. 01

    엣지가 호출을 받음

    Next.js catch-all이 Hono 소셜 API로 라우팅합니다. request_id를 만들고 키를 인증한 뒤 분당 600회, 키당 동시 50개 한도를 적용합니다.

  2. 02

    검증 후 차감

    레지스트리에서 tripadvisor/search (or reviews)를 찾습니다. 필수 파라미터와 형식 검사를 먼저 합니다. 잘못된 입력은 과금 없이 400입니다. 유효 호출은 업스트림 전에 티어 비용을 원자적으로 차감합니다.

  3. 03

    캐시 또는 수집

    platform + resource + params로 캐시 키를 만듭니다. 히트면 credits_used = 0으로 즉시 반환합니다. 미스면 Tripadvisor upstream paths run behind the unified envelope. 소스가 불안정하면 5xx/네트워크 재시도와 서킷 브레이커를 사용합니다.

  4. 04

    정규화 후 반환

    업스트림 JSON을 Product, ProductList, ReviewList, SellerList, App, PlaceList 등 커머스 아키타입으로 매핑하고 Zod로 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.

운영에서 중요한 과금 규칙

  • search 라이브 미스: 1 크레딧
  • reviews 라이브 미스: 1 크레딧
  • 캐시 히트: 0 크레딧
  • 빈 응답 / 하드 실패: 자동 환불
  • 잘못된 파라미터: 400, 과금 없음
  • 크레딧 부족: 402, 과금 없음
  • url_path는 search에서 획득
  • depth로 리뷰 볼륨 조절
  • 예약·소유자 답글 도구 없음

데이터 수집 방식

Tripadvisor은 공개 읽기 데이터입니다. SocialCrawl 스키마로 정규화하므로 별도 벤더 SDK를 배울 필요가 없습니다.

이 API에서 Tripadvisor의 의미

공개 장소와 여행자 리뷰입니다. 읽기 전용 발견·평판입니다.

SocialCrawl 수집 경로

통합 /v1 봉투 뒤의 Tripadvisor 업스트림 경로입니다.

엣지에서 나가는 형태

search의 PlaceList와 url_path의 ReviewList입니다.

라이브로 제공하지 않는 것

예약, 소유자 도구, 비공개 메시지는 없습니다.

필드 매핑
search hit→ place + url_pathurl_path가 reviews 키
review rows→ ReviewListrating, text, author
location / language→ query controls검색 지역·언어 범위

이 API의 활용 분야

이 API가 가장 많이 사용되는 작업입니다.

2active Tripadvisor endpoints in the registry
1 creditsearch·reviews 라이브 읽기당 과금

호스피탈리티·로컬 비즈니스 평판

호출은 검색 또는 분류 후 후보 엔티티의 상세·리뷰 심화에 몰립니다. 장소 검색에서 리뷰까지 한 키로 각 1 크레딧입니다. Tripadvisor 파트너 로그인은 없습니다.

라이브 미스는 보통 수 초입니다. 일부 경로는 콜드 캐시에서 더 걸릴 수 있습니다.

Tripadvisor API 활용 사례

Tripadvisor 데이터가 가장 많이 쓰이는 작업입니다. 각 항목에서 엔드포인트 순서와 과금 방식을 확인합니다.

활용 사례

이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.

호텔 운영

Python, cron

브랜드 호텔을 검색하고 reviews로 최신을 확인합니다.

로컬 SEO 팀

Node, sheets

도시 키워드로 검색하고 장소 평점·리뷰 텍스트를 샘플링합니다.

여행 조사

notebooks

location 범위 검색 후 reviews depth로 언어를 수집합니다.

두 줄로 호출

표준 티어는 라이브 호출당 1 크레딧입니다. 캐시 히트는 무료입니다.

curl "https://www.socialcrawl.dev/v1/tripadvisor/search?q=pizza+restaurant&location=New+York,New+York,United+States" \
  -H "x-api-key: sc_your_api_key_here"
curl "https://www.socialcrawl.dev/v1/tripadvisor/reviews?url_path=Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html&depth=10" \
  -H "x-api-key: sc_your_api_key_here"
Tripadvisor logoSocialCrawl의 Tripadvisor

카탈로그 전 구간과 같은 키

플랫폼 문서API 키 받기
엔드포인트

TripAdvisor API는 어떤 데이터를 돌려주나요

모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.

SearchSearch TripAdvisor businesses & placesReviewsGet TripAdvisor reviews for a placePlaceGet a TripAdvisor place by URLAutocompleteAutocomplete TripAdvisor placesHotelsSearch TripAdvisor hotelsHotelGet a TripAdvisor hotelRestaurantsSearch TripAdvisor restaurantsRestaurantGet a TripAdvisor restaurantRestaurant ReviewsGet TripAdvisor reviews for a restaurantAttractionsSearch TripAdvisor attractions and things to doAttractionGet a TripAdvisor attractionAttraction ReviewsGet TripAdvisor reviews for an attractionExperience TypesList TripAdvisor experience types for a destinationCruisesSearch TripAdvisor cruisesCruiseGet a TripAdvisor cruise shipCruise ReviewsGet TripAdvisor reviews for a cruise ship
비교

SocialCrawl과 트립어드바이저 콘텐츠 API, 뭐가 다른가요?

같은 TripAdvisor 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.

인증

SocialCrawl
x-api-key 하나로 가입하자마자 바로 호출하면 돼요
트립어드바이저 콘텐츠 API
파트너 신청과 승인 절차를 거쳐야 쓸 수 있어요

시작하기

SocialCrawl
검색 후 url_path로 리뷰, GET 엔드포인트 16개면 끝이에요
트립어드바이저 콘텐츠 API
승인된 파트너 용도에 맞춰 접근 범위가 제한돼요

응답 스키마

SocialCrawl
65개 플랫폼과 같은 통합 PlaceList·ReviewList 구조예요
트립어드바이저 콘텐츠 API
콘텐츠 API 고유 형식이고 공개된 필드까지만 받아요

요금

SocialCrawl
요청당 1 크레딧, 신용카드 없이 100 크레딧 무료
트립어드바이저 콘텐츠 API
호출 제한이 있는 무료 티어, 규모가 커지면 상용 계약이 필요해요

데이터 범위

SocialCrawl
장소 검색에 사진·사장님 답글·평점·여행자 유형 필터·번역 정보가 담긴 리뷰까지 받아요
트립어드바이저 콘텐츠 API
장소 정보와 함께 장소당 최근 리뷰 몇 건만 제공돼요

유지보수

SocialCrawl
작업 기반 소싱과 캐싱을 서버에서 알아서 처리해 드려요
트립어드바이저 콘텐츠 API
키, 쿼터, 파트너 정책 준수를 직접 챙겨야 해요
자주 묻는 질문

자주 묻는 질문

API, 요금제, 기능에 대한 질문과 답변입니다.

문의하기
트립어드바이저 데이터는 어떻게 가져오나요?
API 키 하나로 엔드포인트 16종을 쓸 수 있어요. GET /v1/tripadvisor/search로 호텔, 맛집, 명소를 검색하고, 검색 결과의 url_path를 GET /v1/tripadvisor/reviews에 넘기면 그 장소의 여행자 리뷰를 받아볼 수 있어요. 두 응답 모두 65개 플랫폼이 함께 쓰는 통합 스키마 JSON이에요.
트립어드바이저 API는 어떤 데이터를 응답해 주나요?
검색은 장소 이름, 카테고리, 별점, 누적 리뷰 수, 리뷰 조회용 url_path를 돌려줘요. 리뷰는 별점, 제목, 본문, 작성자 프로필, 첨부 사진, 사장님 답글, 작성일에 번역 여부와 원문 언어 정보까지 함께 와요.
트립어드바이저 공식 API 키를 따로 발급받아야 하나요?
아니요, 따로 신청하거나 승인받을 필요가 없어요. 데이터 소싱은 SocialCrawl이 알아서 처리해 드려요. SocialCrawl API 키 하나만 있으면 다른 엔드포인트와 똑같이 /v1/tripadvisor/search와 /v1/tripadvisor/reviews를 바로 호출할 수 있어요.
트립어드바이저 API는 요금이 얼마인가요?
요청 한 번에 1 크레딧이 소진돼요(스탠다드 티어). 새 계정에는 신용카드 없이 100 크레딧이 무료로 제공되고, 리뷰가 없는 장소는 404와 함께 크레딧이 자동으로 환불돼요.
왜 어떤 요청은 15~45초 정도 걸리나요?
업스트림 데이터 소스가 즉시 응답형이 아니라 작업(task) 기반이라서, 같은 장소나 검색어의 첫 호출은 데이터를 모으는 동안 15~45초 정도 걸릴 수 있어요. 비동기 처리는 SocialCrawl이 서버에서 알아서 감춰 드리고, 두 번째 호출부터는 캐시로 훨씬 빠르게 와요.
트립어드바이저 데이터를 수집해도 법적으로 괜찮나요?
SocialCrawl은 누구나 사이트에서 볼 수 있는 공개 장소 정보와 리뷰만 DataForSEO Business Data API를 통해 가져와요. 다만 사용 목적이 트립어드바이저 약관과 개인정보 관련 법령에 맞는지는 직접 확인해 주세요. SocialCrawl은 GDPR 정당한 이익에 기반한 문서화된 프레임워크로 운영돼요. 로그인 없이 볼 수 있는 공개 데이터만 다루고, 계정 자격 증명은 일절 사용하지 않으며, 캐시는 2~30분만 유지되고 영구 저장하지 않아요. 자신의 공개 정보에 대한 옵트아웃 채널도 운영해요. 자세한 내용은 socialcrawl.dev/legal/public-data-notice에서 확인하실 수 있어요.
가장 좋은 트립어드바이저 스크레이퍼 API는 무엇인가요?
파트너 승인 없이 바로 쓰려면 SocialCrawl이 좋아요. 검색으로 별점·리뷰 수가 담긴 장소를 찾고, 리뷰 엔드포인트로 사진·사장님 답글·번역 정보가 담긴 여행자 리뷰를 호출당 1 크레딧에 받아요. 공식 콘텐츠 API는 승인 절차가 필요하고 장소당 리뷰 수가 제한돼요. 신용카드 없이 100 크레딧으로 시작해요.

AI에게 SocialCrawl을 물어보세요

ChatGPT에 물어보기Perplexity에 물어보기Gemini에 물어보기Claude에 물어보기Grok에 물어보기

TripAdvisor API 레퍼런스 문서 보기

🤖 AI 에이전트나 LLM이신가요? 이 페이지를 markdown으로 읽어보세요