> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google-Suchergebnisse per API (GOOGLE_SERP)

> Eine Seite organischer google.com-Ergebnisse, Anzeigen und SERP-Panels zu einer Anfrage abrufen, ohne auf eine AI Overview zu warten.

`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`](/de/engines/google-ai-overviews) und kostet weniger. Nutzen Sie es für Rank-Tracking oder um Seiten zu finden, die Sie mit [`WEB_SCRAPE`](/de/engines/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](/de/engines/capacity.md). |

## Anfrage

```bash theme={"theme":"css-variables"}
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](/de/concepts/async-tasks.md) 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:

```json theme={"theme":"css-variables"}
{
  "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`](/de/engines/google-ai-overviews).

## 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](/de/concepts/errors.md).

## Verwandt

* [Google AI Overviews](/de/engines/google-ai-overviews.md) für dieselbe Seite mit ihrer AI Overview
* [Web scrape](/de/engines/web-scrape.md), um die Seite eines Ergebnisses als Markdown zu lesen
* [Regionen und Standort](/de/engines/capacity.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.