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/successAu prix du fournisseur
- Success rate
- 92,2 %Last 30 days · 14 168 calls
- Latency p50
- 1.7 sp95 58 s
- Last verified
- 28 juil. 2026Verified working
GEThttps://toolswitch.dev/v1/tools/serpapi.google.serp.organic?q=coffee&engine=googlePreview- Uses platform quota
- Synchronous response
- Reads public data
Paramètres
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.
| Paramètre | Type | Obligatoire | Description | Exemple |
|---|---|---|---|---|
| Paramètres de requête | ||||
q | chaîne | Obligatoire | the search query; Google search operators work here | coffee |
cr | chaîne | Facultatif | restrict to countries, e.g. countryUS; multiple joined by | | |
gl | chaîne | Facultatif | country code for the search, e.g. us, uk | us |
hl | chaîne | Facultatif | interface language code, e.g. en | en |
lr | chaîne | Facultatif | restrict to languages, e.g. lang_en; multiple joined by | | |
lat | nombre | Facultatif | latitude; requires lon and a matching gl | |
lon | nombre | Facultatif | longitude; requires lat | |
tbm | chaîne | Facultatif | switches the Google vertical: isch (images), vid, nws, shop, lcl, pts | |
tbs | chaîne | Facultatif | advanced Google filters, e.g. date range | |
nfpr | chaîne | Facultatif | 1 disables Google's auto-correction to a different spelling | |
safe | chaîne | Facultatif | active | off | |
uule | chaîne | Facultatif | Google's encoded location, as an alternative to `location` | |
start | entier | Facultatif | result offset for pagination — 0, 10, 20 … This is how you page; see the note about `num` | 0 |
device | chaîne | Facultatif | desktop (default) | tablet | mobile | |
engine | chaîne | Obligatoire | the engine selector — must be this literal string | google |
filter | chaîne | Facultatif | 0 turns off Google's similar-results and omitted-results filters | |
radius | entier | Facultatif | metres around lat/lon; 1-199 on desktop, 1-1000 on mobile | |
location | chaîne | Facultatif | city-level origin of the search, e.g. "Austin, Texas, United States". Mutually exclusive with uule and with lat/lon | |
google_domain | chaîne | Facultatif | default google.com; e.g. google.co.uk | |
- Paramètres de requête
qchaîneObligatoirethe search query; Google search operators work here
Exemple :
coffeecrchaîneFacultatifrestrict to countries, e.g. countryUS; multiple joined by |
glchaîneFacultatifcountry code for the search, e.g. us, uk
Exemple :
ushlchaîneFacultatifinterface language code, e.g. en
Exemple :
enlrchaîneFacultatifrestrict to languages, e.g. lang_en; multiple joined by |
latnombreFacultatiflatitude; requires lon and a matching gl
lonnombreFacultatiflongitude; requires lat
tbmchaîneFacultatifswitches the Google vertical: isch (images), vid, nws, shop, lcl, pts
tbschaîneFacultatifadvanced Google filters, e.g. date range
nfprchaîneFacultatif1 disables Google's auto-correction to a different spelling
safechaîneFacultatifactive | off
uulechaîneFacultatifGoogle's encoded location, as an alternative to `location`
startentierFacultatifresult offset for pagination — 0, 10, 20 … This is how you page; see the note about `num`
Exemple :
0devicechaîneFacultatifdesktop (default) | tablet | mobile
enginechaîneObligatoirethe engine selector — must be this literal string
Exemple :
googlefilterchaîneFacultatif0 turns off Google's similar-results and omitted-results filters
radiusentierFacultatifmetres around lat/lon; 1-199 on desktop, 1-1000 on mobile
locationchaîneFacultatifcity-level origin of the search, e.g. "Austin, Texas, United States". Mutually exclusive with uule and with lat/lon
google_domainchaîneFacultatifdefault google.com; e.g. google.co.uk
Exemples de code
Remplacez $TOOLSWITCH_KEY par la clé créée dans la console.
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());Cette API de passerelle est en préversion ; son URL et son authentification peuvent changer. Les paramètres de l’exemple sont des données fictives. Les appels sont facturés à $0.015/success, frais de service inclus.