Naver-Suchergebnisse per API (NAVER_SERP) - querying.ai

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

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:

{
  "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

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:

{
  "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.
Weitere Anfragefehler stehen unter Fehler.

Verwandt

Naver AI Brief, das unter seiner Zusammenfassung ebenfalls die organischen Dokumente liefert
Naver AI Tab
Regionen und Standort