API 키 만들기
API 워크스페이스에서 자격 증명을 만들고 서버 또는 클라이언트의 비밀 구성에 보관하세요. REST와 MCP는 동일한 API 사용량을 공유합니다.
API 키 열기구조화된 JSON
동일한 응답으로 결과 반환
REST + MCP
애플리케이션 또는 AI 클라이언트 사용
하나의 API 사용량
API와 MCP 요청이 공유
데이터 선택
비즈니스 검색으로 시작한 다음 장소의 feature ID를 사용해 리뷰나 갤러리 항목을 요청하세요. 각 API에는 고유한 예시와 필드 참조가 있습니다.
첫 API 요청
Authorization 헤더에 API 키를 사용하세요. 아래 요청 형식을 살펴본 다음 퀵스타트에 따라 첫 호출을 진행하세요.
전체 계약 내용은 API 문서를 참조하세요.
curl https://gmapscrawl.com/api/v1/search \
-H "Authorization: Bearer $GMSCRAPER_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: seattle-coffee-search-001" \
-d '{"q":"coffee shops in Seattle","page":1,"extra":false}'예시용 빈 응답입니다. 라이브 검색은 사용 가능한 비즈니스를 반환합니다. API 키는 서버 측에 보관하고, 새 작업에는 새 멱등 키를 사용하고, 변경되지 않은 재시도에는 그대로 유지하세요.
{
"data": {
"total": 0,
"params": {
"q": "coffee shops in Seattle",
"page": 1,
"hl": "en",
"extra": false
},
"businesses": []
},
"request_id": "req_example",
"schema_version": "2026-09-22"
}API는 동일한 응답 안에서 JSON을 반환합니다. 타임아웃 후에는 동일한 Idempotency-Key로 변경되지 않은 본문을 재시도하세요. 테스트 자격 증명은 실제 사용량을 소비하지 않고 시뮬레이션된 데이터를 반환합니다.
표준 HTTP로 구축
API 워크스페이스에서 자격 증명을 만들고 서버 또는 클라이언트의 비밀 구성에 보관하세요. REST와 MCP는 동일한 API 사용량을 공유합니다.
API 키 열기키워드와 지역으로 검색하세요. 리뷰와 사진에는 보유한 Maps feature ID를 입력하거나 검색 결과에서 place.dataId를 읽어오면 됩니다.
퀵스타트 따르기반환된 페이지를 애플리케이션에서 처리하세요. 엔드포인트의 페이지네이션 규칙을 따르고, 누락된 필드를 검사하고, 재시도를 위해 요청의 멱등 키를 보존하세요.
페이지네이션 이해하기유용한 것을 만들기
반환된 레코드를 자체 조사, 보고, 내부 워크플로의 입력으로 사용하세요.
카테고리와 지역을 검색한 다음 사용 가능한 비즈니스 이름, 주소, 웹사이트, 전화번호, 평점을 애플리케이션에서 정리합니다.
장소의 공개 리뷰를 조회해 고객 피드백을 분석합니다. 일관된 정렬 순서를 선택하고 분석에 필요한 페이지를 순서대로 가져옵니다.
장소에서 사용 가능한 사진 및 동영상 링크를 가져옵니다. 팀이 원래 컨텍스트를 확인할 수 있도록 소스 갤러리 링크를 레코드와 함께 보관하세요.
에이전트 연결
MCP 서버에 연결해 검색 가능한 도구를 사용하거나, Agent Skill을 설치해 재사용 가능한 워크플로 지침과 REST 폴백을 확보하세요.
연결된 에이전트의 작업 예시
“시애틀의 커피숍 한 페이지를 검색해 줘. 사용 가능한 이름, 웹사이트, 평점을 반환하고 누락된 데이터를 지적해 줘.”
요청은 API 사용량을 소비합니다. 테스트 자격 증명을 사용하면 결과가 시뮬레이션됩니다.
통합 계획
성공한 라이브 페이지는 빈 페이지를 포함해 페이지당 1개의 API 요청을 사용합니다. REST와 MCP는 API 플랜을 공유하며 Online과 Extension 사용량은 별도입니다.
한 페이지로 시작해 반환된 필드를 확인하고 엔드포인트에 적합한 클라이언트 타임아웃을 설정하세요. 재시도 시에는 변경되지 않은 요청 본문과 동일한 Idempotency-Key를 재사용하세요.
플랜 한도, 속도 제한, 소스 가용성, 인리치먼트는 라이브 요청에 영향을 줍니다. 테스트 자격 증명은 라이브 사용량을 소비하지 않고 시뮬레이션된 픽스처를 반환합니다.
요청 한도와 결과 필드는 엔드포인트 페이지를 확인하세요. 요금 페이지에는 현재 포함된 요청 수와 유료 초과 요금이 나와 있습니다.
G Maps Crawl은 비즈니스 검색, 공개 장소 리뷰, 장소 사진/갤러리 API를 제공합니다. Search는 비즈니스 레코드를 반환하고, Reviews와 Photos는 Maps feature ID를 사용해 특정 장소의 한 페이지를 반환합니다.
예. API는 HTTP 요청과 JSON을 사용하므로 Python, JavaScript, cURL 또는 다른 HTTP 클라이언트로 호출할 수 있습니다. 각 API 페이지에는 요청 예시와 응답 예시가 포함되어 있습니다.
공개 Search, Reviews, Photos API는 동일한 응답에서 JSON을 반환합니다. 작업 폴링이나 webhook 설정이 필요하지 않습니다. 엔드포인트의 타임아웃 및 재시도 지침을 따르세요.
REST는 애플리케이션이 엔드포인트를 직접 호출하게 합니다. MCP는 호환되는 AI 클라이언트에 도구를 제공합니다. Agent Skill은 워크플로 지침과 도우미 스크립트를 제공합니다. REST와 MCP 요청에는 API 자격 증명이 필요하며 API 사용량을 소비합니다.
보유한 Maps feature ID를 사용하거나, Search API의 data.businesses 배열에서 일치하는 레코드의 place.dataId를 복사하세요. 그 값을 fid로 Reviews 또는 Photos API에 전달하면 됩니다.
아니요. 반환되는 필드는 소스와 선택한 작업에 따라 달라집니다. 데이터를 사용하기 전에 누락된 값과 사용 가능한 관측 타임스탬프를 확인하세요. 성공적인 응답에 빈 페이지가 포함될 수 있습니다.
다음 단계로 이동
API 키를 만들고, 한 번의 요청으로 시작해, 애플리케이션에서 사용할 수 있는 데이터를 살펴보세요.