SerpApiGoogleSEO/AEO

Google organic search results for a query

serpapi.google.serp.organic

Live Google organic results for a keyword — position, title, URL, snippet, by location

Price: $0.015/success제공업체 원가
Success rate: 92.2%Last 30 days · 14,168 calls
Latency p50: 1.7 sp95 58 s
Last verified: 2026. 7. 28.Verified working

GEThttps://toolswitch.dev/v1/tools/serpapi.google.serp.organic?q=coffee&engine=googlePreview

Uses platform quota
Synchronous response
Reads public data

파라미터

Answers arrive in `organic_results`; the same response may also carry `knowledge_graph`, `local_results`, `related_questions`, `related_searches` and `pagination`. `num` IS NOT DOCUMENTED for this engine — Google dropped it upstream and SerpApi's google parameter list does not include it. Page with `start`, not `num`; sending `num` is not a supported way to widen a page.

파라미터	유형	필수	설명	예시
쿼리 파라미터
`q`	문자열	필수	the search query; Google search operators work here	`coffee`
`cr`	문자열	선택	restrict to countries, e.g. countryUS; multiple joined by \|
`gl`	문자열	선택	country code for the search, e.g. us, uk	`us`
`hl`	문자열	선택	interface language code, e.g. en	`en`
`lr`	문자열	선택	restrict to languages, e.g. lang_en; multiple joined by \|
`lat`	숫자	선택	latitude; requires lon and a matching gl
`lon`	숫자	선택	longitude; requires lat
`tbm`	문자열	선택	switches the Google vertical: isch (images), vid, nws, shop, lcl, pts
`tbs`	문자열	선택	advanced Google filters, e.g. date range
`nfpr`	문자열	선택	1 disables Google's auto-correction to a different spelling
`safe`	문자열	선택	active \| off
`uule`	문자열	선택	Google's encoded location, as an alternative to `location`
`start`	정수	선택	result offset for pagination — 0, 10, 20 … This is how you page; see the note about `num`	`0`
`device`	문자열	선택	desktop (default) \| tablet \| mobile
`engine`	문자열	필수	the engine selector — must be this literal string	`google`
`filter`	문자열	선택	0 turns off Google's similar-results and omitted-results filters
`radius`	정수	선택	metres around lat/lon; 1-199 on desktop, 1-1000 on mobile
`location`	문자열	선택	city-level origin of the search, e.g. "Austin, Texas, United States". Mutually exclusive with uule and with lat/lon
`google_domain`	문자열	선택	default google.com; e.g. google.co.uk

쿼리 파라미터
q문자열필수
the search query; Google search operators work here
예시: coffee
cr문자열선택
restrict to countries, e.g. countryUS; multiple joined by |
gl문자열선택
country code for the search, e.g. us, uk
예시: us
hl문자열선택
interface language code, e.g. en
예시: en
lr문자열선택
restrict to languages, e.g. lang_en; multiple joined by |
lat숫자선택
latitude; requires lon and a matching gl
lon숫자선택
longitude; requires lat
tbm문자열선택
switches the Google vertical: isch (images), vid, nws, shop, lcl, pts
tbs문자열선택
advanced Google filters, e.g. date range
nfpr문자열선택
1 disables Google's auto-correction to a different spelling
safe문자열선택
active | off
uule문자열선택
Google's encoded location, as an alternative to `location`
start정수선택
result offset for pagination — 0, 10, 20 … This is how you page; see the note about `num`
예시: 0
device문자열선택
desktop (default) | tablet | mobile
engine문자열필수
the engine selector — must be this literal string
예시: google
filter문자열선택
0 turns off Google's similar-results and omitted-results filters
radius정수선택
metres around lat/lon; 1-199 on desktop, 1-1000 on mobile
location문자열선택
city-level origin of the search, e.g. "Austin, Texas, United States". Mutually exclusive with uule and with lat/lon
google_domain문자열선택
default google.com; e.g. google.co.uk

코드 예제

$TOOLSWITCH_KEY를 콘솔에서 생성한 키로 바꾸세요.

Preview

curl -X GET 'https://toolswitch.dev/v1/tools/serpapi.google.serp.organic?q=coffee&engine=google' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

response = requests.request(
    "GET",
    "https://toolswitch.dev/v1/tools/serpapi.google.serp.organic?q=coffee&engine=google",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/serpapi.google.serp.organic?q=coffee&engine=google", {
  method: "GET",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
  },
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

게이트웨이 API는 미리보기 버전이며 URL과 인증 방식이 변경될 수 있습니다. 예제 매개변수는 샘플 데이터입니다. 호출 요금은 $0.015/success이며 서비스 수수료가 포함되어 있습니다.