Paid ads on a Google results page for a query
serpapi.x.google-adsThe shopping/text ad units Google shows on its own results page for a keyword (distinct from the Ads Transparency Center)
- Price
- $0.015/successZum Anbieterpreis
- Success rate
- 99,4 %Last 30 days · 4.678 calls
- Latency p50
- 1.4 sp95 6.9 s
- Last verified
- 28.07.2026Verified working
GEThttps://toolswitch.dev/v1/tools/serpapi.x.google-ads?q=coffee&gl=us&engine=google_ads&location=Austin%2C+Texas%2C+United+StatesPreviewTry onlineDemnächstProvider docs ↗
- Uses platform quota
- Synchronous response
- Reads public data
Parameter
answers arrive in `ads` (not `ads_results`).
| Parameter | Typ | Erforderlich | Beschreibung | Beispiel |
|---|---|---|---|---|
| Abfrageparameter | ||||
q | Zeichenkette | Erforderlich | coffee | |
gl | Zeichenkette | Optional | us | |
hl | Zeichenkette | Optional | en | |
engine | Zeichenkette | Erforderlich | google_ads | |
location | Zeichenkette | Erforderlich | city-level origin of the search — confirmed REQUIRED live (a bare gl/hl call 400s with "Missing `location` parameter") | Austin, Texas, United States |
- Abfrageparameter
qZeichenketteErforderlichBeispiel:
coffeeglZeichenketteOptionalBeispiel:
ushlZeichenketteOptionalBeispiel:
enengineZeichenketteErforderlichBeispiel:
google_adslocationZeichenketteErforderlichcity-level origin of the search — confirmed REQUIRED live (a bare gl/hl call 400s with "Missing `location` parameter")
Beispiel:
Austin, Texas, United States
Codebeispiele
Ersetze $TOOLSWITCH_KEY durch den in der Konsole erstellten Schlüssel.
Preview
curl -X GET 'https://toolswitch.dev/v1/tools/serpapi.x.google-ads?q=coffee&gl=us&engine=google_ads&location=Austin%2C+Texas%2C+United+States' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/serpapi.x.google-ads?q=coffee&gl=us&engine=google_ads&location=Austin%2C+Texas%2C+United+States",
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.x.google-ads?q=coffee&gl=us&engine=google_ads&location=Austin%2C+Texas%2C+United+States", {
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());Diese Gateway-API ist eine Vorschauversion; URL und Authentifizierung können sich ändern. Die Beispielparameter sind Musterdaten. Aufrufe werden mit $0.015/success einschließlich Servicegebühr abgerechnet.