> ## 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.

# Naver-Suchergebnisse per API (NAVER_SERP)

> Eine Seite der Naver-Webdokument-Ergebnisse zu einer Anfrage abrufen oder eine naver.com-Seite als Text lesen.

`NAVER_SERP` liefert eine Seite der Ergebnisse aus Navers Webdokument-Tab, 15 Dokumente pro Seite. Mit `"action": "page"` liest es eine naver.com-Seite (einen Blogbeitrag, Cafe-Beitrag, Nachrichtenartikel, eine Knowledge-iN-Antwort oder jede andere naver.com-Seite) und liefert ihren Text.

| | |
| - | - |
| `taskType` | `NAVER_SERP` |
| Eingabe | `query` (Pflicht für die Suche); `page`, `country`; oder `action: "page"` mit `url`, `maxChars` |
| Credits | 1 pro Task |
| Land | Standard ist `KR`. |
| Standort | Nicht unterstützt (`422 LOCATION_UNSUPPORTED`). |

## Suche

```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": "NAVER_SERP", "payload": { "query": "running shoes for flat feet", "page": 2 } }'
```

| 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`. Andere Werte liefern `422 VALIDATION_ERROR`. |
| `country` | Nein | Standard ist `KR`, Navers Markt. |

Zum Beispiel Seite 2:

```json theme={"theme":"css-variables"}
{
  "organicResults": [
    { "position": 16, "title": "...", "link": "https://...", "displayedLink": "example.com›path", "snippet": "...", "page": 2 }
  ]
}
```

| Feld | Beschreibung |
| - | - |
| `organicResults` | Die Dokumente der Seite. `position` zählt über Seiten hinweg, das erste Dokument auf Seite 2 ist also `16`. Jede Zeile trägt ihre `page`. |
| `notice` | Vorhanden, wenn Naver die Ergebnisse hinter seiner Altersprüfung zurückhält: `{ "type": "age_verification_required", "scope": "organicResults", "message" }`. `message` gibt Navers Meldung wieder, wenn sie lesbar ist. |

Ein leeres `organicResults` in einem abgeschlossenen Task bedeutet, dass Naver selbst keine Dokumente geliefert hat.

## Eine naver.com-Seite lesen

```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": "NAVER_SERP", "payload": { "action": "page", "url": "https://blog.naver.com/example/223000000000", "maxChars": 10000 } }'
```

| Feld | Pflicht | Beschreibung |
| - | - | - |
| `action` | Ja | `page`. |
| `url` | Ja | Eine `https`-Adresse auf `naver.com` oder einer seiner Subdomains. Andere Adressen liefern `422 VALIDATION_ERROR`. |
| `maxChars` | Nein | Begrenzt `text`, eine Ganzzahl von 1.000 bis 50.000. Standard ist 20.000. |

Zum Beispiel:

```json theme={"theme":"css-variables"}
{
  "type": "blog",
  "url": "https://blog.naver.com/example/223000000000",
  "title": "...",
  "text": "...",
  "author": "...",
  "publishedAt": "...",
  "images": ["https://..."],
  "truncated": false
}
```

| Feld | Beschreibung |
| - | - |
| `type` | `blog`, `cafe`, `news`, `terms`, `kin` oder `generic`. |
| `title`, `text` | Titel und Fließtext der Seite. |
| `author`, `publishedAt`, `cafeName` | Vorhanden, wenn die Seite sie hat. |
| `images` | Bis zu 30 Bildadressen aus dem Fließtext. |
| `truncated` | `true`, wenn `text` bei `maxChars` gekürzt wurde. |

Folgende Fälle lassen den Task mit `PAGE_UNAVAILABLE` und einem Grund scheitern: eine Weiterleitung, die naver.com verlässt, eine fehlende Seite (404 oder 410), ein Cafe-Beitrag, den nur Mitglieder lesen können, und eine Seite ohne lesbaren Inhalt.

## Grenzen und Fehler

* `NAVER_SERP` ignoriert `markdown`, `rawResponse` und `searchQueries`. Es lehnt `html` und `analysis` mit `422` und `citationAnalysis` mit `400` ab; siehe [nicht unterstützte Flags](/de/engines/response-options.md#nicht-unterstützte-flags).
* Weitere Anfragefehler stehen unter [Fehler](/de/concepts/errors.md).

## Verwandt

* [Naver AI Brief](/de/engines/naver-ai-brief.md), das unter seiner Zusammenfassung ebenfalls die organischen Dokumente liefert
* [Naver AI Tab](/de/engines/naver-ai-tab.md)
* [Regionen und Standort](/de/engines/capacity.md)


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