플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Google Maps 리뷰 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | keyword에 이름이나 업종을 넣어 Google Maps에서 장소를 찾습니다. | 요청 1,000개당 $1.39 | 정상 |
장소 상세 정보profile | 전체 url로 Google Maps 장소를 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
리뷰reviews | Google Maps 장소 하나의 리뷰를 조회합니다. | 요청 1,000개당 $1.39 | 정상 |
기여자 리뷰contributor_reviews | contributor에 프로필 링크나 숫자 ID를 넣어 Google Maps 사용자 한 명이 작성한 리뷰를 조회합니다. | 요청 1,000개당 $1.39 | 정상 |
업체 정보business_listings | category에 dentist나 coffee_shop 같은 카테고리를 넣어 Google Maps 업체를 가져오고, city, country, 최소 평점, 업체명에 포함된 단어로 범위를 좁힙니다. | 요청 1,000개당 $15.36 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Google Maps 리뷰 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색
| keyword | country, language, location, page_token | Sync 응답 | 카탈로그 값: defaultLimit=15, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 다음 페이지를 가져오려면 next_page_token을 page_token으로 전달하고 다른 파라미터는 그대로 두세요. 페이지 하나당 호출 1회입니다. 한 페이지는 최대 120행입니다. 60행을 초과하면 mode=async로 페이지를 요청하세요. | 요청 1,000개당 $1.39 | place_id · name · url · category · categories · description · address · city · state · postal_code · country_code · lat · lng · phone · website · rating · rating_scale · review_count · price · permanently_closed · image_url · platform |
profile장소 상세 정보 전체 | url | city, language, since, sort | Sync 응답 | — | 요청 1,000개당 $1.39 | place_id · name · url · category · categories · description · address · neighborhood · city · state · postal_code · country_code · plus_code · lat · lng · phone · website · rating · rating_scale · review_count · image_count · price · permanently_closed · temporarily_closed · opening_hours · image_url · platform |
reviews리뷰 Google Maps 장소 하나의 리뷰를 조회합니다. 리뷰별 평점, 작성자 이름과 작성 리뷰 수, 지역 가이드 배지, 좋아요 수, 사진, 세부 평점, 업주 답변이 포함됩니다. | url | lang, language, page_token, since, sort | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 다음 페이지를 가져오려면 next_page_token을 page_token으로 전달하고 다른 파라미터는 그대로 두세요. 페이지 하나당 호출 1회입니다. 한 페이지는 최대 400행입니다. 200행을 초과하면 mode=async로 페이지를 요청하세요. | 요청 1,000개당 $1.39 | id · text · rating · rating_scale · reviewer_name · reviewer_id · reviewer_review_count · is_local_guide · like_count · posted_at · url · owner_response · owner_response_at · detailed_rating · image_urls · place_id · place_name · platform |
contributor_reviews기여자 리뷰
| contributor | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 더 큰 limit도 허용되지만 최대 200까지만 적용됩니다. | 요청 1,000개당 $1.39 | id · text · rating · rating_scale · like_count · posted_at · posted_ago · url · image_urls · owner_response · owner_response_ago · place_name · place_address · place_type · place_data_id · lat · lng · reviewer_name · reviewer_id · reviewer_review_count · is_local_guide · local_guide_level · local_guide_points · platform |
business_listings업체 정보
| category | city, country, min_rating, name | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=20. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 더 큰 limit도 허용되지만 최대 20까지만 적용됩니다. | 요청 1,000개당 $15.36 | place_id · name · url · category · categories · description · address · city · state · postal_code · country_code · lat · lng · phone · website · rating · rating_scale · review_count · price · permanently_closed · image_url · platform |
Google Maps 리뷰 search 파라미터는 각각 무엇을 의미하나요?
keyword에 이름이나 업종을 넣어 Google Maps에서 장소를 찾습니다. Google 장소 ID, 주소, 좌표, 전화번호, 웹사이트, 평점, 리뷰 수, 휴업·폐업 상태를 가져옵니다. page_token으로 페이지를 넘기며 총 최대 120행까지 가져올 수 있습니다. 60행을 넘으면 비동기 모드가 필요합니다.
keyword필수- Google Maps 장소 이름, 업종 또는 장소 쿼리입니다(예:
dentist,dentist in Chicago).search는 장소를 찾을 뿐, 기존 업체의 리뷰 텍스트를 검색하지는 않습니다. country선택- 검색 맥락을 정하는 국가 또는 지역 코드입니다(예:
us). 기본값은us입니다. 반환된 모든 업체가 해당 국가에 있다고 보장하지는 않습니다. language선택- 쿼리 또는 페이지 콘텐츠에 사용할 언어이며, 기본값은
en입니다. reviews에서lang과 함께 지정하면lang이 이 값보다 우선합니다. 모든 리뷰가 해당 언어로 작성되었다고 보장하지는 않습니다. location선택search에서keyword와 결합할 장소 텍스트입니다(예:Chicago). keyword에 이미 포함된 위치와 충돌하는 위치는 지정하지 마세요.page_token선택- 페이지네이션 토큰입니다. 다음 페이지를 가져오려면 이전 응답의 next_page_token을 다시 전달하고, 첫 페이지에서는 생략하세요. 다른 파라미터는 모두 그대로 유지하세요. 토큰은 24시간 동안 유효하며 각 페이지는 호출 1건입니다.
Google Maps 리뷰 profile 파라미터는 각각 무엇을 의미하나요?
전체 url로 Google Maps 장소를 가져옵니다. 주소, 플러스 코드, 좌표, 전화번호, 웹사이트, 평점, 리뷰 수, 영업시간, 임시 휴업 또는 폐업 여부가 포함됩니다. search에서 받은 URL을 사용하는 것이 좋습니다. 이름과 좌표만 있는 링크는 같은 업체와 일치하지 않을 수 있습니다.
url필수- 전체 Google Maps 장소 URL로,
query_place_id가 유지된 search 반환 URL을 권장합니다. 이름과 좌표만 포함된/place/URL로는 같은 업체를 안정적으로 식별하지 못할 수 있습니다. 장소 상세 정보는 profile로, 해당 장소의 리뷰는 reviews로 가져오세요.Google Maps: 장소 링크와 장소 ID 이해하기 — Google Maps 링크는 장소 이름이나 좌표에만 의존하지 않고 `query_place_id`로 특정 장소를 직접 식별합니다. · 확인일 city선택- 장소 탐색 시 적용할 도시 조건입니다. profile 액션에도 이 파라미터가 있지만, 이미 알려진 업체를 다른 도시로 옮기거나 장소 URL을 안정적으로 대체할 수는 없습니다.
language선택- 쿼리 또는 페이지 콘텐츠에 사용할 언어이며, 기본값은
en입니다. reviews에서lang과 함께 지정하면lang이 이 값보다 우선합니다. 모든 리뷰가 해당 언어로 작성되었다고 보장하지는 않습니다. since선택- 리뷰 게시일의 하한으로,
YYYY-MM-DD형식을 권장합니다. 업체 개업일이 아닙니다. profile 액션에 이 파라미터가 있다고 해서 장소 상세 정보가 개업일로 필터링되지는 않습니다. sort선택- 리뷰 정렬 순서로,
newest(최신 리뷰) 또는relevance(플랫폼의 관련성 순) 중 하나입니다. reviews의 기본값은newest입니다. profile에서는 같은 이름의 파라미터가 첨부된 리뷰 데이터에 영향을 줄 수 있지만, 단일 장소 객체를 정렬하지는 않습니다.허용 값:newestrelevance
Google Maps 리뷰 reviews 파라미터는 각각 무엇을 의미하나요?
Google Maps 장소 하나의 리뷰를 조회합니다. 리뷰별 평점, 작성자 이름과 작성 리뷰 수, 지역 가이드 배지, 좋아요 수, 사진, 세부 평점, 업주 답변이 포함됩니다. lang으로 언어를 선택하고 page_token으로 페이지를 넘기며, 최대 400행까지 가져올 수 있습니다. 200행을 넘으면 비동기 모드가 필요합니다.
url필수- 전체 Google Maps 장소 URL로,
query_place_id가 유지된 search 반환 URL을 권장합니다. 이름과 좌표만 포함된/place/URL로는 같은 업체를 안정적으로 식별하지 못할 수 있습니다. 장소 상세 정보는 profile로, 해당 장소의 리뷰는 reviews로 가져오세요.Google Maps: 장소 링크와 장소 ID 이해하기 — Google Maps 링크는 장소 이름이나 좌표에만 의존하지 않고 `query_place_id`로 특정 장소를 직접 식별합니다. · 확인일 lang선택- reviews의 언어 옵션입니다(예:
en,zhcn,zhtw). 액션의 전체 허용값 목록을 사용하세요.language보다 우선하며, 리뷰 작성자의 국적으로 필터링하지는 않습니다.허용 값:afamarazbgbnbscacsdadeeleneses419eteufafifilfrglguhihrhuhyidisitiwjakakkkmknkokyloltlvmkmlmnmrmsmynenlnopaplptbrptptrorusiskslsqsrsvswtatethtrukuruzvizhcnzhtwzu language선택- 쿼리 또는 페이지 콘텐츠에 사용할 언어이며, 기본값은
en입니다. reviews에서lang과 함께 지정하면lang이 이 값보다 우선합니다. 모든 리뷰가 해당 언어로 작성되었다고 보장하지는 않습니다. page_token선택- 페이지네이션 토큰입니다. 다음 페이지를 가져오려면 이전 응답의 next_page_token을 다시 전달하고, 첫 페이지에서는 생략하세요. 다른 파라미터는 모두 그대로 유지하세요. 토큰은 24시간 동안 유효하며 각 페이지는 호출 1건입니다.
since선택- 리뷰 게시일의 하한으로,
YYYY-MM-DD형식을 권장합니다. 업체 개업일이 아닙니다. profile 액션에 이 파라미터가 있다고 해서 장소 상세 정보가 개업일로 필터링되지는 않습니다. sort선택- 리뷰 정렬 순서로,
newest(최신 리뷰) 또는relevance(플랫폼의 관련성 순) 중 하나입니다. reviews의 기본값은newest입니다. profile에서는 같은 이름의 파라미터가 첨부된 리뷰 데이터에 영향을 줄 수 있지만, 단일 장소 객체를 정렬하지는 않습니다.허용 값:newestrelevance
Google Maps 리뷰 contributor_reviews 파라미터는 각각 무엇을 의미하나요?
contributor에 프로필 링크나 숫자 ID를 넣어 Google Maps 사용자 한 명이 작성한 리뷰를 조회합니다. 리뷰별 평점, 본문, 좋아요 수, 사진, 업주 답변과 함께 대상 장소(이름, 주소, 유형, 좌표), 작성자의 리뷰 수와 지역 가이드 레벨이 포함됩니다. 날짜는 posted_ago에 13 hours ago 같은 상대 시간으로 표시됩니다. 기본 20개, 최대 200개입니다.
contributor필수- Google Maps 리뷰 작성자로, 프로필 링크(https://www.google.com/maps/contrib/<numeric ID>) 또는 10~32자리 숫자 ID만 입력합니다.
reviews결과의 작성자 링크가 이 페이지로 연결됩니다.contributor_reviews는 이 사람이 작성한 리뷰를 최대 200개 반환합니다.
Google Maps 리뷰 business_listings 파라미터는 각각 무엇을 의미하나요?
category에 dentist나 coffee_shop 같은 카테고리를 넣어 Google Maps 업체를 가져오고, city, country, 최소 평점, 업체명에 포함된 단어로 범위를 좁힙니다. 업체별 주소, 좌표, 전화번호, 웹사이트, 평점, 리뷰 수가 포함됩니다. 리뷰가 많은 순으로 최대 20개 업체를 제공하며, 가격은 비어 있는 경우가 많고 휴업·폐업 상태는 제공되지 않습니다.
category필수business_listings에 사용할 Google Maps 업종 카테고리로, 공백을 밑줄로 바꾼 영문 소문자로 입력합니다(예:dentist,coffee_shop,italian_restaurant).city선택- 비즈니스 주소가 일치해야 하는 도시 이름입니다(예:
Austin). 다른 지역의 비즈니스는 제외됩니다. country선택- 비즈니스 주소가 일치해야 하는 두 글자 국가 코드입니다(예:
us,gb). min_rating선택business_listings에서 남길 최저 별점으로, 1~5 사이 값입니다.4.5같은 소수도 사용할 수 있습니다.name선택business_listings에서 업체 이름에 반드시 포함되어야 하는 단어입니다(예: 브랜드명). 이름에 이 단어가 없는 업체는 제외됩니다.
Google Maps 리뷰 API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"google_maps_reviews","action":"search","params":{"keyword":"<keyword>"}}'
Google Maps 리뷰 가이드
이 액션을 활용한 실제 예제와 방법입니다. 먼저 이 페이지에서 현재 액션, 파라미터, 필드를 확인하세요. 글에 나온 예제와 제한 사항은 최신 카탈로그를 대신할 수 없습니다.
Google Maps 리뷰 API: 알맞은 진입점을 고르고 장소 리뷰를 기록하는 방법
Business Profile, Places API, EveryInfra 장소 리뷰 조회의 차이를 구분하고, 장소 식별 정보, 언어, 기간 필터를 검증하고, 평점과 업체 답글의 변화를 보존하며, 샘플·저장·표시의 범위를 명확히 하는 방법을 다룹니다.
글 읽기Google Maps 매장 데이터 중복 제거: Place ID는 영구적인 사업체 식별자가 아닙니다
같은 위치에 여러 Place ID가 있을 수 있고, ID는 시간이 지나면서 바뀔 수 있습니다. 이 가이드는 공식 문서를 바탕으로 체인점 중복 제거, 내부 엔터티 매핑, 매장 이전 이력, 잘못된 병합을 검증하는 방법을 다룹니다.
글 읽기멀티 플랫폼 평판 모니터링 설계도: 부정 여론의 변화를 평가하기 전에 범위부터 정의하기
대상 목록, 댓글 식별자, 증분 커서에서 출발해 추적 가능한 평판 모니터링 워크플로를 설계하고, 오프라인 샘플로 중복 제거와 수집 누락을 보여 주며, 사람의 검토 단계를 유지합니다.
글 읽기Google Maps 리뷰 API 자주 묻는 질문
Google Maps 리뷰 API로 무엇을 가져올 수 있나요?
platform을 google_maps_reviews 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 장소 상세 정보, 리뷰, 기여자 리뷰 및 업체 정보입니다. 각 액션 이름은 서로 다른 Google Maps 리뷰 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Google Maps 리뷰 search 요청에는 어떤 입력이 필요한가요?
Google Maps 장소 이름, 업종 또는 장소 쿼리입니다(예: dentist, dentist in Chicago). search는 장소를 찾을 뿐, 기존 업체의 리뷰 텍스트를 검색하지는 않습니다. params 안의 keyword 필드로 전달하세요.
Google Maps 리뷰 search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 place_id, name, category 및 categories입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Google Maps 리뷰 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.