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/successPelo preço do provedor
Success rate: 92,2%Last 30 days · 14.168 calls
Latency p50: 1.7 sp95 58 s
Last verified: 28 de jul. de 2026Verified working

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

Uses platform quota
Synchronous response
Reads public data

Parâmetros

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.

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Parâmetros de consulta
`q`	string	Obrigatório	the search query; Google search operators work here	`coffee`
`cr`	string	Opcional	restrict to countries, e.g. countryUS; multiple joined by \|
`gl`	string	Opcional	country code for the search, e.g. us, uk	`us`
`hl`	string	Opcional	interface language code, e.g. en	`en`
`lr`	string	Opcional	restrict to languages, e.g. lang_en; multiple joined by \|
`lat`	número	Opcional	latitude; requires lon and a matching gl
`lon`	número	Opcional	longitude; requires lat
`tbm`	string	Opcional	switches the Google vertical: isch (images), vid, nws, shop, lcl, pts
`tbs`	string	Opcional	advanced Google filters, e.g. date range
`nfpr`	string	Opcional	1 disables Google's auto-correction to a different spelling
`safe`	string	Opcional	active \| off
`uule`	string	Opcional	Google's encoded location, as an alternative to `location`
`start`	inteiro	Opcional	result offset for pagination — 0, 10, 20 … This is how you page; see the note about `num`	`0`
`device`	string	Opcional	desktop (default) \| tablet \| mobile
`engine`	string	Obrigatório	the engine selector — must be this literal string	`google`
`filter`	string	Opcional	0 turns off Google's similar-results and omitted-results filters
`radius`	inteiro	Opcional	metres around lat/lon; 1-199 on desktop, 1-1000 on mobile
`location`	string	Opcional	city-level origin of the search, e.g. "Austin, Texas, United States". Mutually exclusive with uule and with lat/lon
`google_domain`	string	Opcional	default google.com; e.g. google.co.uk

Parâmetros de consulta
qstringObrigatório
the search query; Google search operators work here
Exemplo: coffee
crstringOpcional
restrict to countries, e.g. countryUS; multiple joined by |
glstringOpcional
country code for the search, e.g. us, uk
Exemplo: us
hlstringOpcional
interface language code, e.g. en
Exemplo: en
lrstringOpcional
restrict to languages, e.g. lang_en; multiple joined by |
latnúmeroOpcional
latitude; requires lon and a matching gl
lonnúmeroOpcional
longitude; requires lat
tbmstringOpcional
switches the Google vertical: isch (images), vid, nws, shop, lcl, pts
tbsstringOpcional
advanced Google filters, e.g. date range
nfprstringOpcional
1 disables Google's auto-correction to a different spelling
safestringOpcional
active | off
uulestringOpcional
Google's encoded location, as an alternative to `location`
startinteiroOpcional
result offset for pagination — 0, 10, 20 … This is how you page; see the note about `num`
Exemplo: 0
devicestringOpcional
desktop (default) | tablet | mobile
enginestringObrigatório
the engine selector — must be this literal string
Exemplo: google
filterstringOpcional
0 turns off Google's similar-results and omitted-results filters
radiusinteiroOpcional
metres around lat/lon; 1-199 on desktop, 1-1000 on mobile
locationstringOpcional
city-level origin of the search, e.g. "Austin, Texas, United States". Mutually exclusive with uule and with lat/lon
google_domainstringOpcional
default google.com; e.g. google.co.uk

Exemplos de código

Substitua $TOOLSWITCH_KEY pela chave criada no console.

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());

Esta API de gateway está em prévia; a URL e a autenticação podem mudar. Os parâmetros do exemplo são dados de amostra. As chamadas são cobradas a $0.015/success, incluindo a taxa de serviço.