Google API

Google 검색·비즈니스 데이터 API

Name: Google Search Data API
Brand: SocialCrawl
Availability: InStock

SocialCrawl API 키로 Google 검색, Ads Transparency, 비즈니스 프로필, 리뷰, Q&A, 호텔 데이터를 구조화 JSON으로 가져옵니다. Google Cloud OAuth는 필요 없습니다. 호출은 크레딧으로 과금됩니다.

문서 보기 동작 방식 직접 호출

/v1/google

활성 엔드포인트는 10개입니다. SERP, 광고, Maps 비즈니스, 호텔을 포함합니다.

GET /v1/google/search
GET /v1/google/ad
GET /v1/google/adlibrary/advertisers/search
GET /v1/google/company/ads
GET /v1/google/business/info
GET /v1/google/business/extended-reviews
GET /v1/google/business/updates
GET /v1/google/business/questions
GET /v1/google/hotels/search
GET /v1/google/hotels/info

Google 엔드포인트

Google 웹 검색, Ads Transparency, 비즈니스 프로필, 호텔 읽기 엔드포인트는 10개입니다. SERP는 1 크레딧, 광고와 심층 비즈니스 조회는 5 크레딧입니다. 데이터 API만 지원하며 순위 도구, Google Cloud 프로젝트, 쓰기 접근은 포함되지 않습니다.

웹 검색

1 크레딧

/v1/google/search

쿼리의 유기 SERP 행을 반환합니다. 제목, URL, 스니펫, 순위가 포함됩니다. region, date_posted, page를 선택적으로 사용합니다.

query, region, date_posted, page

광고 크리에이티브

5 크레딧

/v1/google/ad

Ads Transparency 크리에이티브 URL 1건의 상세를 반환합니다. 광고 문구, 광고주, 형식이 포함됩니다. URL은 company/ads에서 가져옵니다.

url

광고주 검색

5 크레딧

/v1/google/adlibrary/advertisers/search

Ads Transparency Center에서 키워드로 광고주를 찾습니다. region은 선택이며 기본값은 US입니다.

query, region

회사 광고 목록

5 크레딧

/v1/google/company/ads

domain 또는 advertiser_id로 광고를 목록화합니다. region, 플랫폼, 형식, 기간으로 필터합니다. cursor로 페이지를 넘깁니다.

domain or advertiser_id, region, platform, cursor

비즈니스 프로필

1 크레딧

/v1/google/business/info

Google 비즈니스 프로필 카드를 반환합니다. 이름, 카테고리, 평점, 주소, 전화, 영업시간, 속성이 포함됩니다. keyword, cid, place_id로 조회합니다.

keyword or cid or place_id, location_name, language_name

확장 리뷰

5 크레딧

/v1/google/business/extended-reviews

장소의 다중 출처 리뷰를 반환합니다. 별점, 본문, 리뷰어 통계, 사장님 답글이 포함됩니다. depth로 개수를 조절합니다.

keyword or cid or place_id, depth

비즈니스 업데이트

1 크레딧

/v1/google/business/updates

GBP 사장님 게시물을 반환합니다. 텍스트, 이미지, 게시 시각, CTA 링크가 포함됩니다. 빈 목록은 게시물 없음을 의미하며 실패가 아닙니다.

keyword or cid

비즈니스 Q&A

5 크레딧

/v1/google/business/questions

비즈니스 프로필의 커뮤니티 질문과 답변을 반환합니다. parent_id로 연결됩니다. depth로 질문 수를 조절합니다.

keyword or cid or place_id, depth

호텔 검색

1 크레딧

/v1/google/hotels/search

쿼리에 맞는 호텔 목록을 반환합니다. 이름, 성급, 리뷰 점수, 좌표, 1박 요금이 포함됩니다. check_in, check_out은 선택입니다. 상세 조회용 hotel_identifier를 반환합니다.

keyword, check_in, check_out, location_name

호텔 상세

5 크레딧

/v1/google/hotels/info

hotel_identifier로 호텔 전체를 가져옵니다. 설명, 편의시설, 리뷰 감성 주제, 다중 벤더 요금 비교가 포함됩니다.

hotel_identifier

Google Search API12개 엔드포인트 지원

문서 보기

Google 웹 검색 결과를 돌려줍니다. 결과마다 제목과 페이지 URL, 본문 일부가 담깁니다.

일반 웹 결과가 필요할 때 사용하세요. 한국어 웹 문서는 naver/webkr/search, 뉴스 헤드라인은 google_news/search를 쓰세요.

1크레딧

GET/v1/google/search?query=best+restaurants+in+London

query

query · Search keyword or phrase. Google operators such as site:example.com work.

$ curl https://www.socialcrawl.dev/v1/google/search?query=best+restaurants+in+London \
    -H "x-api-key: sc_YOUR_API_KEY"

대기 중

// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다

Google API 동작

Google도 다른 SocialCrawl 엔드포인트와 같습니다. API 키로 GET /v1/google/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다. Google Cloud OAuth와 별도 SDK는 없습니다.

호출 인증

x-api-key 헤더에 키를 보냅니다. Google Cloud 프로젝트와 OAuth 비밀키는 필요 없습니다. TikTok, Reddit, Google News, Finance를 포함한 카탈로그 전 구간에 같은 키를 사용합니다.

GET과 쿼리 파라미터

Google 라우트는 모두 GET입니다. query, url, domain, keyword, cid, place_id, hotel_identifier, region, depth, cursor를 쿼리로 전달합니다. 과금 전에 oneOf와 형식을 검증합니다.

크레딧 과금

SERP, 비즈니스 정보, 업데이트, 호텔 검색은 1 크레딧입니다. Ads Transparency, 확장 리뷰, Q&A, 호텔 상세는 5 크레딧입니다. 캐시 히트는 0 크레딧입니다. 빈 응답과 하드 실패는 환불됩니다.

JSON 봉투

응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 목록 응답은 page, cursor, has_more 페이지네이션을 가질 수 있습니다.

연동 순서

대부분 제품은 매 틱마다 전 엔드포인트를 호출하지 않습니다. 웹을 검색하거나 광고주를 확인한 뒤 필요한 광고와 비즈니스만 깊게 읽습니다.

01SERP

GET /v1/google/search?query=…

SearchResult 목록입니다. title, url, snippet, position이 포함됩니다.

키워드로 넓게 탐색합니다. page로 페이지를 넘깁니다. region으로 국가를 좁힙니다.

02광고주

GET /v1/google/adlibrary/advertisers/search?query=…

Ads Transparency 광고주의 AuthorList입니다.

브랜드 이름을 광고주 엔티티로 확정한 뒤 크리에이티브를 목록화합니다.

03회사 광고

GET /v1/google/company/ads?domain=…

domain 또는 advertiser_id 기준 광고 PostList입니다.

크리에이티브 목록과 URL을 확보합니다. 상세는 /ad로 조회합니다.

04비즈니스 프로필

GET /v1/google/business/info?keyword=…

평점, 영업시간, 연락처, 속성이 있는 Place입니다.

keyword, cid, place_id가 있으면 로컬 엔티티 카드를 가져옵니다.

요청

GET /v1/google/search
  ?query=best+restaurants+in+London
  &region=UK
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here

# ads transparency
GET /v1/google/company/ads?domain=example.com&region=US
GET /v1/google/ad?url=https://adstransparency.google.com/advertiser/…/creative/…

응답 봉투

{
  "success": true,
  "data": {
    "items": [
      {
        "title": "Example result",
        "url": "https://example.com",
        "snippet": "…",
        "position": 1
      }
    ]
  },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

data 형태

필드 이름은 SocialCrawl 나머지 플랫폼과 같습니다. SERP, 광고, 장소, 리뷰는 공유 아키타입을 쓰므로 파서를 재사용할 수 있습니다.

SearchResultsearch

items[]: title, url, snippet, position. 추가 SERP는 page

Post / PostListad, company/ads

광고 크리에이티브 상세 또는 회사 광고 행. GBP 업데이트는 text, media, published_at이 있는 PostList

AuthorListadlibrary/advertisers/search

광고주 검색 결과: id, name, region, ext의 transparency URL

Place / PlaceList / ReviewList / CommentListbusiness/*, hotels/*

비즈니스·호텔 상세는 Place, 호텔 검색은 PlaceList, 확장 리뷰는 ReviewList, Q&A는 parent_id CommentList

게이트웨이

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

엣지 수신

Next.js catch-all이 Hono 소셜 API로 들어갑니다. request_id를 발급하고 키를 인증한 뒤 분당 600회 한도와 키당 동시 50건을 적용합니다.

검증 후 차감

레지스트리에서 google/search 등을 찾습니다. 필수 파라미터와 oneOf 검증이 먼저입니다. 잘못된 입력은 400이며 과금하지 않습니다. 유효 호출은 업스트림 전에 티어 비용을 원자적으로 차감합니다.

캐시 또는 조회

platform, resource, params로 캐시 키를 만듭니다. 히트면 즉시 반환하고 credits_used는 0입니다. 미스면 SERP·광고는 실시간으로 읽고 비즈니스·호텔은 서버 측 비즈니스 데이터 조회로 처리합니다. 5xx와 네트워크 오류는 재시도하며 불건전 시 서킷 브레이커가 동작합니다.

정규화 후 반환

업스트림 JSON을 SearchResult, Post, AuthorList, Place, PlaceList, ReviewList, CommentList로 매핑합니다. Zod로 검증한 뒤 성공 봉투로 감싸 빌링 감사에 남깁니다.

과금 규칙

SERP, 비즈니스 정보, 업데이트, 호텔 검색 라이브 미스는 1 크레딧입니다.
광고, 확장 리뷰, Q&A, 호텔 상세 라이브 미스는 5 크레딧입니다.
company/ads의 get_ad_details 옵션은 문서화된 상위 요금으로 과금될 수 있습니다.
캐시 히트는 0 크레딧입니다.
빈 응답과 하드 실패는 자동 환불됩니다.
잘못된 파라미터 또는 oneOf 누락은 400이며 과금하지 않습니다.
잔액이 없으면 402이며 과금하지 않습니다.
차감 후 업스트림 장애는 환불 경로가 적용됩니다.
비활성 라우트는 503이며 과금하지 않습니다.

데이터 수집

여기의 Google 표면은 공개 읽기 검색, 광고 투명성, 비즈니스 데이터입니다. SocialCrawl 스키마로 정규화하므로 두 번째 OAuth나 여러 업스트림 SDK를 코드에 넣을 필요가 없습니다.

API에서의 Google

유기 SERP, Ads Transparency 크리에이티브와 광고주, 비즈니스 프로필, 다중 출처 리뷰, 사장님 업데이트, Q&A, 호텔 검색과 상세를 읽기 전용으로 제공합니다. Search Console, Ads Manager 쓰기, 비공개 계정 데이터는 없습니다.

업스트림

웹 검색과 Ads Transparency는 요청 시점에 실시간으로 읽습니다. 비즈니스 프로필, 확장 리뷰, 업데이트, Q&A, 호텔은 서버 측 비즈니스 데이터 조회로 처리합니다. 모두 같은 SocialCrawl 키로 호출합니다.

응답 형태

success, data, credits_used, request_id, cached를 담은 통합 JSON 봉투를 반환합니다. 유기 행은 SearchResult, 크리에이티브는 Post, 장소와 호텔은 Place 또는 PlaceList, 리뷰와 Q&A는 ReviewList와 CommentList로 정규화됩니다.

미제공 항목

Google Cloud OAuth는 없습니다. 순위 이력 제품은 없습니다. 수 분 걸리는 리뷰 크롤용 비동기 job_id 표면은 아직 없습니다. 쓰기와 관리 엔드포인트는 없습니다.

필드 매핑

organic SERP row→ SearchResult유기 행의 제목, URL, 스니펫, 순위

Ads Transparency creative→ Post / PostListAds Transparency의 크리에이티브 URL, 문구, 광고주, 형식

GBP / hotel listing→ Place / PlaceList / ReviewListGBP 이름, 평점, 영업시간, 리뷰, Q&A, hotel_identifier로 상세 연결

이 API의 활용 분야

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

10active Google endpoints in the registry

1 / 5표준 1 크레딧, 고급 5 크레딧 사다리

SERP 확인, 광고 인텔, 로컬 비즈니스 보강

호출은 search, company/ads 체인, business/info에 집중됩니다. 여행이나 로컬 평판 작업이 깊을 때 호텔과 Q&A가 사용됩니다. SERP는 1 크레딧입니다. Ads Transparency와 비즈니스·호텔을 같은 키로 호출합니다. Google Cloud OAuth 프로젝트는 필요 없습니다.

SERP와 표준 비즈니스 읽기는 라이브 미스 시 보통 수 초입니다. 광고 목록과 심층 호텔 상세는 업스트림 작업이 무거울 때 더 길어질 수 있습니다.

Google API 활용 사례

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

계정 통합 조회계정명이 브랜드명과 다른 경우를 찾는 사이트 지정 검색입니다. 실제 운영에서 가장 흔한 시작점입니다.

광고 인텔리전스광고주 검색과 도메인 기준 광고를 제공합니다. 같은 조사 안에서 유료 검색과 유료 소셜을 나란히 봅니다.

활용 사례

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

SEO·리서치 잡

Python, cron, 노트북

region과 date 창으로 google/search를 폴링해 SERP 스냅샷을 저장합니다. 제목, URL, 순위를 남깁니다. 캐시 히트로 반복 비용을 낮춥니다.

경쟁 광고 모니터

Node, 워커, Slack 봇

광고주를 확인한 뒤 domain으로 company/ads를 목록화하고 /ad로 크리에이티브 상세를 엽니다. 플랫폼 표면과 형식으로 필터합니다.

로컬 데이터 파이프라인

Go, ETL, Explorer

business/info와 리뷰, 업데이트, Q&A를 CRM 보강에 넣습니다. hotels/search 후 hotels/info로 여행 인벤토리 잡을 구성합니다. 카탈로그와 같은 API 키를 사용합니다.

호출 예시

표준 티어는 라이브 호출당 1 크레딧입니다. 광고와 심층 비즈니스는 5 크레딧입니다. 캐시 히트는 무료입니다.

curl "https://www.socialcrawl.dev/v1/google/search?query=best+restaurants+in+London&region=UK" \
  -H "x-api-key: sc_your_api_key_here"

curl "https://www.socialcrawl.dev/v1/google/business/info?keyword=Blue+Bottle+Coffee&location_name=San+Francisco" \
  -H "x-api-key: sc_your_api_key_here"

SocialCrawl Google

카탈로그와 같은 API 키

플랫폼 문서 API 키 받기

엔드포인트

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

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

SearchGoogle web search AdGet Google ad details Adlibrary Advertisers SearchSearch Google Ad Library advertisers Company AdsList Google ads by company Business InfoGet a Google Business Profile Business Extended ReviewsGet Google extended (multi-source) reviews Business UpdatesGet Google Business Profile posts (updates)Business QuestionsGet Google Business Profile questions & answers Business SearchSearch Google Maps businesses Hotels SearchSearch Google hotels Hotels InfoGet Google hotel detail Keyword VolumeGet Google keyword search volume by country

비교

SocialCrawl과 직접 SERP 스크래핑, 뭐가 다른가요?

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

항목	SocialCrawl	직접 SERP 스크래핑
인증	x-api-key 헤더 하나로 68개 플랫폼을 모두 호출해요	키는 없지만 프록시 계정과 세션 쿠키를 직접 관리해야 해요
시작 준비	GET 요청 한 번이면 몇 분 안에 첫 호출까지 끝나요	헤드리스 브라우저, 프록시 로테이션, HTML 파서를 직접 만들어 운영해야 해요
차단·CAPTCHA	차단과 CAPTCHA 처리는 업스트림에서 알아서 해결돼요	Google이 강하게 차단해서 CAPTCHA와 IP 밴을 직접 감당해야 해요
응답 스키마	68개 플랫폼 공통 통합 JSON 스키마로 와요	원시 HTML이라 Google 마크업이 바뀔 때마다 깨져요
요금	SERP 1 크레딧, 광고·리뷰 5 크레딧, 가입 시 100 크레딧 무료예요	시작은 무료지만 프록시·CAPTCHA 솔버 비용이 규모와 함께 불어나요
데이터 범위	SERP·광고 투명성·비즈니스 프로필·리뷰·호텔까지 API 하나로 받아요	지면마다 스크래퍼와 파서를 따로 만들어야 해요
유지보수	Google 레이아웃이 바뀌어도 스키마가 그대로 유지돼요	Google HTML이 업데이트될 때마다 파서를 계속 고쳐야 해요

인증

SocialCrawl

x-api-key 헤더 하나로 68개 플랫폼을 모두 호출해요

직접 SERP 스크래핑

키는 없지만 프록시 계정과 세션 쿠키를 직접 관리해야 해요

시작 준비

SocialCrawl

GET 요청 한 번이면 몇 분 안에 첫 호출까지 끝나요

직접 SERP 스크래핑

헤드리스 브라우저, 프록시 로테이션, HTML 파서를 직접 만들어 운영해야 해요

차단·CAPTCHA

SocialCrawl

차단과 CAPTCHA 처리는 업스트림에서 알아서 해결돼요

직접 SERP 스크래핑

Google이 강하게 차단해서 CAPTCHA와 IP 밴을 직접 감당해야 해요

응답 스키마

SocialCrawl

68개 플랫폼 공통 통합 JSON 스키마로 와요

직접 SERP 스크래핑

원시 HTML이라 Google 마크업이 바뀔 때마다 깨져요

요금

SocialCrawl

SERP 1 크레딧, 광고·리뷰 5 크레딧, 가입 시 100 크레딧 무료예요

직접 SERP 스크래핑

시작은 무료지만 프록시·CAPTCHA 솔버 비용이 규모와 함께 불어나요

데이터 범위

SocialCrawl

SERP·광고 투명성·비즈니스 프로필·리뷰·호텔까지 API 하나로 받아요

직접 SERP 스크래핑

지면마다 스크래퍼와 파서를 따로 만들어야 해요

유지보수

SocialCrawl

Google 레이아웃이 바뀌어도 스키마가 그대로 유지돼요

직접 SERP 스크래핑

Google HTML이 업데이트될 때마다 파서를 계속 고쳐야 해요

자주 묻는 질문

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

문의하기

Google 데이터는 어떻게 수집하나요?

SocialCrawl이 Google 웹 검색 SERP, Google 광고 투명성 센터의 광고주 검색·회사 광고 피드까지 엔드포인트 세 종을 제공해요. x-api-key 하나만 있으면 되고, Google Cloud 프로젝트나 OAuth, SerpApi 구독 없이 바로 호출할 수 있어요.

SocialCrawl은 어떤 Google 엔드포인트를 지원하나요?

Google 웹 검색(제목, URL, 스니펫, 순위 포함 오가닉 SERP), 광고 라이브러리 광고주 검색, 도메인·지역·주제·기간으로 필터링되는 회사 광고 피드를 포함해 총 12개 엔드포인트예요. 모두 같은 통합 스키마로 응답을 받아볼 수 있어요.

SerpApi나 Bright Data 대체제로 써도 되나요?

네, SocialCrawl은 Google SERP와 광고 투명성 센터 데이터를 68개 플랫폼 공통 통합 스키마로 돌려드려요. 그래서 Google 검색용 코드 그대로 TikTok, Reddit, YouTube에도 재사용할 수 있고, 쿼리마다 CAPTCHA로 실패하는 일 없이 요금도 단순해요.

Google API는 요금이 얼마인가요?

Google 웹 검색은 1 크레딧(스탠다드 티어)이에요. 광고 투명성 엔드포인트(광고주 검색, 회사 광고)는 업스트림 렌더링이 무거워서 5 크레딧(어드밴스드 티어)이 들어요. 새 계정은 100 크레딧을 무료로 받을 수 있고, 신용카드 없이 바로 시작할 수 있어요.

경쟁사 분석용으로 Google 광고도 가져올 수 있나요?

네, Google 광고 투명성 센터 전용 엔드포인트가 2종 있어요. 브랜드 키워드로 광고주를 검색하고, 한 회사가 집행한 모든 광고를 지역·주제·기간으로 필터링해서 받아볼 수 있어요. 광고 인텔리전스 구축에 딱이에요.

Google Cloud나 Google Ads 계정이 필요한가요?

필요 없어요. Google Cloud 프로젝트, Custom Search Engine ID, Programmable Search API 키, Google Ads 개발자 토큰 전부 필요 없어요. SocialCrawl x-api-key와 쿼리 또는 URL만 있으면 다른 플랫폼과 동일한 통합 스키마로 응답을 받아볼 수 있어요.

Places API 없이 Google 비즈니스 프로필과 리뷰도 가져올 수 있나요?

네, Google 비즈니스 프로필을 통째로 다뤄요. 프로필 정보, 리뷰(TripAdvisor·Yelp 같은 제3자 출처 포함), 사장님 게시글, 동네 Q&A까지 받아볼 수 있어요. Google Cloud 프로젝트나 OAuth, 장소별 할당량 없이 Places·비즈니스 프로필 API를 그대로 대체하실 수 있어요.

Google 호텔이나 여행 데이터도 지원하나요?

네, Google Travel 엔드포인트가 2종 있어요. 호텔 검색은 이름·성급·리뷰 점수·좌표·이미지·1박 요금을 돌려드리고, 호텔 상세는 14개 카테고리 편의시설, 27개 리뷰 감성 토픽, 여러 업체 가격 비교까지 더해드려요. 전부 같은 통합 스키마로 와요.

가장 좋은 Google 스크래퍼 API는 무엇인가요?

SocialCrawl을 추천해요. SERP 검색, 광고 투명성 센터, 비즈니스 프로필 리뷰·Q&A, Google Travel 호텔을 비롯해 엔드포인트 12종을 x-api-key 하나로 호출하고, 68개 플랫폼 공통 통합 스키마로 받아요. SERP는 호출당 1 크레딧이고 가입하면 100 크레딧을 무료로 드려서 신용카드 없이 바로 비교해 보실 수 있어요.

Google Search 데이터 스크래핑, 법적으로 괜찮을까요?

SocialCrawl은 누구나 볼 수 있는 공개 Google Search 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. Google Search 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.

Google Search 스크래핑 API와 공식 Google Search API는 뭐가 다른가요?

SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 Google Search 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.

AI에게 SocialCrawl을 물어보세요

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

Google Search API 레퍼런스 문서 보기

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