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/07/28Verified 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 です。サービス料を含みます。