Google-Suchergebnisse per API (GOOGLE_SERP) - querying.ai

GOOGLE_SERP lädt eine google.com-Ergebnisseite und liefert ihre organischen Ergebnisse und Panels. Es wartet nicht auf eine AI Overview, antwortet daher schneller als GOOGLE und kostet weniger. Nutzen Sie es für Rank-Tracking oder um Seiten zu finden, die Sie mit WEB_SCRAPE lesen.


`taskType`	`GOOGLE_SERP`
Eingabe	`query` (Pflicht); `page`, `country`, `location`, `include`
Credits	1 pro Task
Land	Standard ist `US`. Jeder ISO-3166-1-Alpha-2-Code.
Standort	Unterstützt. Siehe Regionen und Standort.

Anfrage

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "GOOGLE_SERP", "payload": { "query": "best running shoes for flat feet", "country": "US", "page": 2 } }'

Der Task läuft asynchron. Lesen Sie das Ergebnis wie unter Asynchrone Tasks beschrieben.

Parameter

Feld	Pflicht	Beschreibung
`query`	Ja	Die Suchanfrage, 1-100.000 Zeichen. `prompt` wird akzeptiert, wenn `query` fehlt.
`page`	Nein	Ergebnisseite, eine Ganzzahl von 1 bis 10. Standard ist `1`. Jede Seite enthält zehn organische Ergebnisse. Andere Werte liefern `422 VALIDATION_ERROR`.
`country`	Nein	Der Google-Markt, in dem gesucht wird. Standard ist `US`.
`location`	Nein	`{ "latitude", "longitude" }` in Dezimalgrad. Google antwortet wie einem Nutzer an diesem Punkt, und das Ergebnis liefert ihn als `location` zurück.
`include.rawResponse`	Nein	`true` fügt das HTML der Ergebnisseite als `rawContent` hinzu. Die Seite ist groß, oft fast ein Megabyte.

Antwort

Zum Beispiel Seite 2 einer Anfrage:

{
  "organicResults": [
    { "position": 11, "title": "...", "link": "https://...", "displayedLink": "...", "snippet": "...", "page": 2 }
  ],
  "peopleAlsoAsk": [{ "...": "..." }],
  "relatedSearches": [{ "...": "..." }],
  "ads": [{ "...": "..." }],
  "page": 2
}

Feld	Beschreibung
`organicResults`	Immer vorhanden. `position` zählt über Seiten hinweg, das erste Ergebnis auf Seite 2 ist also `11`. Jede Zeile trägt die `page`, von der sie stammt.
`page`	Die geladene Seite.
`peopleAlsoAsk`, `relatedSearches`, `knowledgeGraph`	Googles Panels, wenn die Seite sie zeigt.
`ads`	Anzeigen oben und unten, wenn die Seite sie zeigt.
`map`	Das Local Pack: Orte mit `name`, `position`, `placeId`, `location`, `mapsUrl`, `reviews` und mehr, wenn die Seite eines zeigt.
`serp`	Weitere Panels, falls vorhanden: `topStories`, `videoResults`, `localMap`, `discussionsAndForums`.
`location`	Der gesendete Punkt, wenn Sie einen gesendet haben.
`rawContent`	Das HTML der Ergebnisseite, mit `include.rawResponse: true`.

Panels, die die Seite nicht zeigt, werden weggelassen, statt als null oder [] geliefert zu werden. Behandeln Sie jedes Feld außer organicResults und page als optional. Es gibt kein aioverview, text oder sources; für die AI Overview nutzen Sie GOOGLE.

Grenzen und Fehler

Ein leeres organicResults in einem abgeschlossenen Task bedeutet, dass Google selbst keine Ergebnisse für die Anfrage geliefert hat. Das wird vor der Rückgabe in einem zweiten Browser bestätigt.
page außerhalb von 1-10 liefert 422 VALIDATION_ERROR.
Eine fehlerhafte location liefert 400 VALIDATION_ERROR.
Weitere Anfragefehler stehen unter Fehler.

Verwandt

Google AI Overviews für dieselbe Seite mit ihrer AI Overview
Web scrape, um die Seite eines Ergebnisses als Markdown zu lesen
Regionen und Standort