Skip to content
/ google-trends-api Public

Python 또는 Bright Data API를 사용하여 Google Trends 데이터를 スクレイピング합니다. 실시간 검색 트렌드를 가져오고, 위치, 카테고리 및 시간 범위로 필터링하며, 손쉽게 확장할 수 있습니다.

brightdata.co.kr/products/serp-api/google-search/trends
0 stars 0 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

bright-kr/google-trends-api

BranchesTags

Repository files navigation

Google Trends Scraper API

Promo

이 리포지토리는 Google Trends 데이터를 수집하기 위한 두 가지 접근 방식을 제공합니다:

  1. 무료 스크레이퍼: 소규모 프로젝트, 테스트, 개인 연구 및 교육 목적을 위한 가벼운 솔루션입니다.
  2. Bright Data Google Trends Scraper API: 엔터프라이즈 수준의 확장 가능하고 신뢰할 수 있는 데이터 추출을 위한 견고한 대용량 솔루션입니다.

Table of Contents

Free Scraper

bright-data-google-trends-api-screenshot-google-trends-page

소규모 데이터 수집 프로젝트를 위한 간단한 Google Trends 스크레이퍼입니다.

Setup

요구 사항:

  • Python 3.9+
  • Playwright (브라우저 자동화용)

설치:

pip install playwright
playwright install

Web스크레이핑이 처음이신가요? 당사의 Python으로 하는 web scraping 초보자 가이드를 따라 해보시기 바랍니다.

Quick Start

  1. google-trends-scraper.py에서 다음 변수를 편집합니다:
query = "cryptocurrency"  # Your search term
geo = "US"                # Country code
hl = "en-US"              # Language code
  1. 스크립트를 실행합니다

💡 Pro Tip: Google의 anti-scraping 시스템에 의한 탐지를 줄이려면 HEADLESS = False로 설정하십시오.

Sample Output

{
    "geoCode": "US-DC",
    "geoName": "District of Columbia",
    "value": [100],
    "formattedValue": ["100"],
    "maxValueIndex": 0,
    "hasData": [true],
}

👉 전체 JSON 출력을 확인하십시오.

Limitations

무료 스크레이퍼에는 다음과 같은 한계가 있습니다:

  • IP 차단 위험이 높습니다
  • 리クエスト 볼륨이 제한적입니다
  • CAPTCHA가 자주 발생합니다
  • 대규모 스크레이핑에는 신뢰하기 어렵습니다

신뢰할 수 있는 대규모 스크레이핑을 위해서는 더 고급 솔루션이 필요합니다.

Bright Data Enterprise Solution

Bright Data의 Google Trends API는 사용자 지정 가능한 검색 매개변수와 함께 구조화된 Google Trends 데이터를 제공합니다. SERP API와 동일한 고급 기술을 기반으로 다음을 제공합니다:

  • 글로벌 위치 정확도: 어떤 위치에도 결과를 맞춤 설정할 수 있습니다
  • Pay-Per-Success Model: 성공한 리クエスト에 대해서만 비용을 지불합니다
  • 실시간 데이터: 최신 검색 결과를 몇 초 만에 가져옵니다
  • 확장성: 볼륨 제한 없이 무제한 리クエスト를 처리합니다
  • 비용 효율성: 인프라 및 유지보수 비용을 절감합니다
  • 최고의 신뢰성: 내장된 anti-blocking 조치로 일관된 성능을 제공합니다
  • 기술 지원: 필요 시 전문가 지원을 받을 수 있습니다

Getting Started

  1. 사전 준비:
  2. Setup: API를 통합하려면 당사의 단계별 가이드를 따르십시오
  3. 구현 방식:
    • Direct API Access
    • Native Proxy-Based Access

Direct API Access

API 엔드포인트에 직접 리クエスト합니다:

cURL 예시:

curl https://api.brightdata.com/request \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer API_TOKEN" \
  -d '{
        "zone": "ZONE_NAME",
        "url": "https://trends.google.com/trends/explore?q=coffee&geo=GB&brd_trends=timeseries,geo_map&brd_json=1",
        "format": "raw"
      }'

Python 예시:

import requests
import json

url = "https://api.brightdata.com/request"
headers = {"Content-Type": "application/json", "Authorization": "Bearer API_TOKEN"}

payload = {
    "zone": "ZONE_NAME",
    "url": "https://trends.google.com/trends/explore?q=coffee&geo=GB&brd_trends=timeseries,geo_map&brd_json=1",
    "format": "raw",
}

response = requests.post(url, headers=headers, json=payload)

with open("serp_direct_api.json", "w") as file:
    json.dump(response.json(), file, indent=4)

print("Response saved to 'serp_direct_api.json'.")

👉 전체 JSON 출력을 확인하십시오.

참고: 파싱된 JSON을 위해 brd_json=1을 사용하십시오. geo 및 brd_trends와 같은 추가 매개변수는 아래 Advanced Features 섹션에서 설명합니다.

Native Proxy-Based Access

프로キシ 라우팅 방식도 사용할 수 있습니다:

cURL 예시:

curl -i \
  --proxy brd.superproxy.io:33335 \
  --proxy-user "brd-customer-<customer-id>-zone-<zone-name>:<zone-password>" \
  -k \
  "https://trends.google.com/trends/explore?q=coffee&geo=GB&brd_trends=timeseries,geo_map&brd_json=1"

Python 예시:

import requests
import urllib3

urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)

host = "brd.superproxy.io"
port = 33335
username = "brd-customer-<customer-id>-zone-<zone-name>"
password = "<zone-password>"
proxy_url = f"http://{username}:{password}@{host}:{port}"

proxies = {"http": proxy_url, "https": proxy_url}
url = "https://trends.google.com/trends/explore?q=coffee&geo=GB&brd_trends=timeseries,geo_map&brd_json=1"
response = requests.get(url, proxies=proxies, verify=False)

with open("serp_native_proxy.json", "w", encoding="utf-8") as file:
    file.write(response.text)

print("Response saved to 'serp_native_proxy.json'.")

👉 전체 JSON 출력을 확인하십시오.

참고: 프로덕션 환경에서는 당사의 SSL Certificate Guide에 설명된 대로 Bright Data의 SSL 인증서를 로드하십시오.

Advanced Features

Widgets

bright-data-google-trends-api-screenshot-timeseries-and-geomap

Google Trends는 의미 있는 인사이트를 추출하기 위한 다양한 위젯을 제공합니다. brd_trends 매개변수를 사용하여 원하는 위젯을 지정할 수 있습니다:

사용 가능한 위젯:

  • timeseries → 시간 경과에 따른 관심도
  • geo_map → 하위 지역별 관심도

여러 위젯 사용:

쉼표로 구분하여 여러 위젯을 조합할 수 있습니다:

curl --proxy brd.superproxy.io:33335 \
  --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> \
  -k "https://trends.google.com/trends/explore?q=ChatGPT&geo=US&brd_trends=timeseries,geo_map&brd_json=1"

Geographic Filtering

geo パ라メータ를 사용하면 특정 국가의 검색 트렌드 데이터를 필터링할 수 있습니다(예: 미국은 geo=US). 생략하면 API는 기본적으로 글로벌 트렌드를 반환합니다.

예시:

curl --proxy brd.superproxy.io:33335 \
  --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> \
  -k "https://trends.google.com/trends/explore?q=coffee&geo=GB&brd_trends=timeseries,geo_map&brd_json=1"

Localization

bright-data-google-trends-api-screenshot-set-language

hl パ라메ータ를 사용하면 특정 언어로 검색 트렌드 데이터를 가져올 수 있습니다:

  • 언어 코드(예: en-US, fr-FR)를 허용합니다
  • 이는 반환되는 데이터의 언어에 영향을 주며, 실제 검색 결과에는 영향을 주지 않습니다

예시:

curl --proxy brd.superproxy.io:33335 \
  --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> \
  -k "https://trends.google.com/trends/explore?q=coffee&hl=fr-FR&brd_trends=timeseries,geo_map&brd_json=1"

Time Range

date パ라메ータ는 트렌드 데이터를 가져오기 위한 특정 기간을 정의합니다:

Value Time Range
now 1-H 지난 1시간
now 4-H 지난 4시간
now 1-d 지난 1일(24시간)
now 7-d 지난 7일
today 1-m 지난 30일
today 3-m 지난 90일
today 12-m 지난 12개월(기본값)
today 5-y 지난 5년
YYYY-MM-DD YYYY-MM-DD 사용자 지정 날짜 범위

지난 30일 예시:

curl --proxy brd.superproxy.io:33335 \
  --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> \
  -k "https://trends.google.com/trends/explore?q=coffee&date=today+1-m&brd_trends=timeseries,geo_map&brd_json=1"

사용자 지정 날짜 범위 예시:

curl --proxy brd.superproxy.io:33335 \
  --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> \
  -k "https://trends.google.com/trends/explore?q=coffee&date=2025-01-02+2025-03-03&brd_trends=timeseries,geo_map&brd_json=1"

Category Filtering

cat パ라메ータ를 사용하면 특정 카테고리 내에서 검색 트렌드를 좁힐 수 있습니다:

  • 기본적으로 Google Trends는 모든 카테고리에서 검색합니다
  • 카테고리는 숫자 ID로 표시됩니다
  • Google Trends에서 카테고리 ID 전체 목록을 확인할 수 있습니다

예시 – 비즈니스 및 산업 카테고리(cat=12)에서 “Bitcoin” 트렌드를 가져옵니다:

curl --proxy brd.superproxy.io:33335 \
  --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> \
  -k "https://trends.google.com/trends/explore?q=bitcoin&cat=12&brd_trends=timeseries,geo_map&brd_json=1"

Search Type

gprop(Google Property) パ라메ータ는 특정 Google 서비스별로 검색 트렌드를 필터링합니다:

Value Google Property
images Google Images
news Google News
froogle Google Shopping
youtube YouTube Search

생략하면 웹 검색이 기본값입니다.

예시:

  1. 이미지 검색 트렌드 (gprop=images):
curl --proxy brd.superproxy.io:33335 \
  --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> \
  -k "https://trends.google.com/trends/explore?q=nft+art&gprop=images&brd_trends=timeseries,geo_map&brd_json=1"
  1. 뉴스 검색 트렌드 (gprop=news):
curl --proxy brd.superproxy.io:33335 \
  --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> \
  -k "https://trends.google.com/trends/explore?q=AI+advancements&gprop=news&brd_trends=timeseries,geo_map&brd_json=1"
  1. YouTube 검색 트렌드 (gprop=youtube):
curl --proxy brd.superproxy.io:33335 \
  --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> \
  -k "https://trends.google.com/trends/explore?q=python+tutorials&gprop=youtube&brd_trends=timeseries,geo_map&brd_json=1"

Support & Resources

About

Python 또는 Bright Data API를 사용하여 Google Trends 데이터를 スクレイピング합니다. 실시간 검색 트렌드를 가져오고, 위치, 카테고리 및 시간 범위로 필터링하며, 손쉽게 확장할 수 있습니다.

brightdata.co.kr/products/serp-api/google-search/trends

Topics

python google web-scraper korean google-scraper google-trends google-trends-api ko scraper-api playwright google-trends-scraper google-trends-scraping-api

Resources

Readme
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages