Google organic search results for a query
serpapi.google.serp.organicLive Google organic results for a keyword — position, title, URL, snippet, by location
- Price
- $0.015/successAl precio del proveedor
- Success rate
- 92,2 %Last 30 days · 14.168 calls
- Latency p50
- 1.7 sp95 58 s
- Last verified
- 28 jul 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 | Obligatorio | Descripción | Ejemplo |
|---|---|---|---|---|
| Parámetros de consulta | ||||
q | cadena | Obligatorio | the search query; Google search operators work here | coffee |
cr | cadena | Opcional | restrict to countries, e.g. countryUS; multiple joined by | | |
gl | cadena | Opcional | country code for the search, e.g. us, uk | us |
hl | cadena | Opcional | interface language code, e.g. en | en |
lr | cadena | 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 | cadena | Opcional | switches the Google vertical: isch (images), vid, nws, shop, lcl, pts | |
tbs | cadena | Opcional | advanced Google filters, e.g. date range | |
nfpr | cadena | Opcional | 1 disables Google's auto-correction to a different spelling | |
safe | cadena | Opcional | active | off | |
uule | cadena | Opcional | Google's encoded location, as an alternative to `location` | |
start | entero | Opcional | result offset for pagination — 0, 10, 20 … This is how you page; see the note about `num` | 0 |
device | cadena | Opcional | desktop (default) | tablet | mobile | |
engine | cadena | Obligatorio | the engine selector — must be this literal string | google |
filter | cadena | Opcional | 0 turns off Google's similar-results and omitted-results filters | |
radius | entero | Opcional | metres around lat/lon; 1-199 on desktop, 1-1000 on mobile | |
location | cadena | Opcional | city-level origin of the search, e.g. "Austin, Texas, United States". Mutually exclusive with uule and with lat/lon | |
google_domain | cadena | Opcional | default google.com; e.g. google.co.uk | |
- Parámetros de consulta
qcadenaObligatoriothe search query; Google search operators work here
Ejemplo:
coffeecrcadenaOpcionalrestrict to countries, e.g. countryUS; multiple joined by |
glcadenaOpcionalcountry code for the search, e.g. us, uk
Ejemplo:
ushlcadenaOpcionalinterface language code, e.g. en
Ejemplo:
enlrcadenaOpcionalrestrict to languages, e.g. lang_en; multiple joined by |
latnúmeroOpcionallatitude; requires lon and a matching gl
lonnúmeroOpcionallongitude; requires lat
tbmcadenaOpcionalswitches the Google vertical: isch (images), vid, nws, shop, lcl, pts
tbscadenaOpcionaladvanced Google filters, e.g. date range
nfprcadenaOpcional1 disables Google's auto-correction to a different spelling
safecadenaOpcionalactive | off
uulecadenaOpcionalGoogle's encoded location, as an alternative to `location`
startenteroOpcionalresult offset for pagination — 0, 10, 20 … This is how you page; see the note about `num`
Ejemplo:
0devicecadenaOpcionaldesktop (default) | tablet | mobile
enginecadenaObligatoriothe engine selector — must be this literal string
Ejemplo:
googlefiltercadenaOpcional0 turns off Google's similar-results and omitted-results filters
radiusenteroOpcionalmetres around lat/lon; 1-199 on desktop, 1-1000 on mobile
locationcadenaOpcionalcity-level origin of the search, e.g. "Austin, Texas, United States". Mutually exclusive with uule and with lat/lon
google_domaincadenaOpcionaldefault google.com; e.g. google.co.uk
Ejemplos de código
Sustituye $TOOLSWITCH_KEY por la clave que creaste en la consola.
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());La API de la pasarela está en versión preliminar; su URL y autenticación pueden cambiar. Los parámetros del ejemplo son datos de muestra. Las llamadas se facturan a $0.015/success, incluida la tarifa de servicio.