Google 검색 API

Google 검색의 오가닉 결과, 광고, 관련 검색어, 지식 그래프 등을 가져옵니다. engine=google을 설정하고 검색어 문자열을 전달하면 캡차 및 봇 차단 보호를 우회한 구조화된 결과를 받을 수 있습니다.

엔드포인트

GET https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY

매개변수

매개변수	유형	필수	설명
api_key	string	예	SERP API 키
engine	string	예	google이어야 함
q	string	예	검색어
cookie	string	아니요	요청에 사용할 커스텀 쿠키. URL 인코딩 필요
tbm	string	아니요	검색 버티컬: isch(이미지), vid(동영상), nws(뉴스), shop(쇼핑)
sort_by	string	아니요	결과 정렬 기준: relevance 또는 date
time_period	string	아니요	last_hour, last_day, last_week, last_month, last_year, 또는 custom
time_period_min	string	아니요	time_period=custom일 때의 최소 날짜. 형식은 MM/DD/YYYY
time_period_max	string	아니요	time_period=custom일 때의 최대 날짜. 형식은 MM/DD/YYYY
flatten_results	int	아니요	결과를 평탄화하려면 1, 아니면 0
empty_results	int	아니요	빈 결과를 숨기려면 0, 표시하려면 1
device	string	아니요	desktop, mobile, 또는 tablet
location	string	아니요	지오타겟팅 위치 이름
google_domain	string	아니요	사용할 Google 도메인 (예: google.co.uk)
uule	string	아니요	Google 인코딩 위치 문자열
lr	string	아니요	언어 제한, 형식 lang_xx
hl	string	아니요	인터페이스 언어 코드
gl	string	아니요	국가 코드
start	int	아니요	페이지네이션을 위한 결과 오프셋
num	int	아니요	페이지당 결과 수
ijn	int	아니요	Google 이미지 페이지 번호 (페이지당 이미지 100개)
safe	string	아니요	세이프서치: active 또는 off
filter	int	아니요	유사 및 생략된 결과 필터: 1은 켜짐, 0은 꺼짐
nfpr	int	아니요	자동 수정된 검색어를 제외하려면 1, 아니면 0
tbs	string	아니요	고급 검색 매개변수 (특허, 날짜 등)
ludocid	string	아니요	Google 비즈니스 프로필 CID (Place ID)
lsig	int	아니요	지식 그래프 지도 보기를 강제 실행

요청 예시

curl

curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=history"

Python

import requests

params = {
    "engine": "google",
    "api_key": "YOUR_API_KEY",
    "q": "history",
}
r = requests.get("https://serp.shifter.io/v1", params=params)
data = r.json()

Node.js

import fetch from 'node-fetch';

const url = 'https://serp.shifter.io/v1?' + new URLSearchParams({
  engine: 'google',
  api_key: 'YOUR_API_KEY',
  q: 'history',
});
const data = await (await fetch(url)).json();

응답 예시

{
  "search_metadata": {
    "id": "...",
    "status": "Success",
    "created_at": "2024-01-01T00:00:00Z"
  },
  "search_parameters": {
    "engine": "google",
    "q": "history",
    "google_domain": "google.com",
    "device": "desktop"
  },
  "search_information": {
    "total_results": 10500000000,
    "time_taken_displayed": 0.52
  },
  "organic_results": [
    {
      "position": 1,
      "title": "History - Wikipedia",
      "link": "https://en.wikipedia.org/wiki/History",
      "displayed_link": "https://en.wikipedia.org > wiki > History",
      "snippet": "History is the systematic study of the past..."
    }
  ],
  "related_searches": [ { "query": "world history" } ],
  "pagination": { "current": 1, "next": "..." }
}

참고 항목

• Google SERP 개요
• 응답 형식
• Google Maps API
• Google Scholar API