Naver 搜索

Naver 通用搜索 SERP，支持关键词检索、排序和分页参数。

本页给出 Naver 搜索的字段定义、参数分组、必填约束以及可用过滤参数。

元数据

字段	值
引擎名称	Naver 搜索
原始名称	Naver Search
内部标识（scraper）	`naver_search`
接口标识（engine）	`naver_search`
网站	Naver
网站地址	Naver.com
输出格式	`json`
版本	`1.0.0`
参数数量	`6`
参数分组	搜索词 (1), 分页 (3), Search type (1), 高级筛选 (1)

请求示例

下面的请求体是本次文档更新时实际用于验证 naver_search 的请求。对于 /v1/serp，engine 字段应传当前引擎的 scraper 值。

curl -X POST "https://run.xcrawl.com/v1/serp" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"engine":"naver_search","q":"OpenAI"}'

响应示例

下面的 JSON 片段来自同一次真实响应。为了避免页面被超长字段淹没，超长字符串、data URL 和大型数组做了裁剪。

{
  "search_metadata": {
    "cached": true,
    "created_at": "2026-03-26 08:17:19 UTC",
    "id": "01KMMKFXKV7BHEAQHY9FD0E56W",
    "json_endpoint": "https://serp.xcrawl.com/01KMMKFXKV7BHEAQHY9FD0E56W.json",
    "processed_at": "2026-03-26 08:17:19 UTC",
    "raw_html_file": "https://serp.xcrawl.com/01KMMKFXKV7BHEAQHY9FD0E56W.html",
    "status": "completed",
    "total_time_taken": 13
  },
  "search_parameters": {
    "engine": "naver_search",
    "q": "OpenAI"
  },
  "total_credits_used": 1,
  "ads_results": [
    {
      "link": "https://ader.naver.com/v1/c5O7i0LjOMMN5yQI8wWN0wwf3SViI6pZGHOj0jwcss6v4RZeiOc0FQjezOdoxihocPY50TPOPhFx6olcqHREPO8YC6iXXBT7CBD8MIV2emC-Kqnl3iZq3rT2WzbkUM230xwL7nUPVA0xLr1WowJRAPnvnTV7_5qccmTPt5RMSIV1dcg5zrwY6AEX4hULVBR0k6... [truncated, 293 chars]",
      "position": 1,
      "site": "젠스파크",
      "title": "지피티 대안, 더 강한 AI"
    },
    {
      "_note": "6 more items omitted"
    }
  ],
  "dictionary_results": [
    {
      "dictionary": "중국어사전",
      "link": "https://zh.dict.naver.com/#/entry/zhko/c90bfdd76a184242964cf3c5a67b0305",
      "more_link": "https://dict.naver.com/search.nhn?query=OpenAI&ie=utf8&from=nsearch",
      "position": 1,
      "pronunciation": "[Kāifàng Réngōngzhìnéng Yánjiū Zhōngxīn]",
      "term": "开放人工智能研究中心"
    }
  ],
  "organic_results": [
    {
      "displayed_link": "openai.com › ko-KR",
      "link": "https://openai.com/ko-KR/",
      "position": 1,
      "related_results": [
        {
          "link": "https://openai.com/ko-KR/api/",
          "position": 1,
          "title": "플랫폼 개요"
        },
        {
          "_note": "3 more items omitted"
        }
      ],
      "snippet": "우리는 우리의 리서치가 궁극적으로 인간 수준의 문제를 해결할 수 있는 시스템인 범용 인공지능으로 이어질 것으로 믿습니다. 우리의 사명은 안전하고 이로운 AGI를 구축하는 것입니다.",
      "source": "OpenAI",
      "source_icon": "https://search.pstatic.net/sunny?src=https%3A%2F%2Fopenai.com%2Ffavicon.ico%3F08eb22cda4333b2d&type=f30_30_png_expire24",
      "title": "OpenAI"
    },
    {
      "_note": "13 more items omitted"
    }
  ],
  "pagination": {
    "current": "1",
    "next": "https://search.naver.com/search.naver?nso=&page=2&query=OpenAI&sm=tab_pge&ssc=tab.ur.all&start=1"
  },
  "related_results": [
    {
      "link": "https://search.naver.com/search.naver?ssc=tab.nx.all&query=open+ai+%EA%B4%80%EB%A0%A8%EC%A3%BC&sm=tab_she&qdt=0",
      "position": 1,
      "title": "open ai 관련주"
    },
    {
      "_note": "4 more items omitted"
    }
  ]
}

必填参数

以下表格列出当前 metadata 中标记为 must: true 的字段。字段是否必填，以 properties.<field>.must 为准，不以顶层 required 数组为准。

参数	类型	分组	说明
`q`	`string`	搜索词	你想让搜索引擎检索的关键词或短语。

可用参数

以下内容按后端返回的字段分组展示。主表只保留字段名、类型、必填标记和字段说明；默认值、可选值等附加约束会列在每个分组后。

搜索词

参数	类型	必填	说明
`q`	`string`	是	你想让搜索引擎检索的关键词或短语。

分页

参数	类型	必填	说明
`num`	`number`	否	希望返回的结果数量。
`page`	`number`	否	当前引擎使用的页码参数。
`start`	`number`	否	Google 风格分页使用的结果偏移量。

附加约束

num：默认值：50
page：默认值：1
start：默认值：1

Search type

参数	类型	必填	说明
`where`	`string`	否	The search type 参数。

附加约束

where：默认值：nexearch；可选值：5 个可选值，例如：nexearch、web、news、video、image

高级筛选

参数	类型	必填	说明
`sort_by`	`number`	否	The search type 参数。

附加约束

sort_by：默认值：0；可选值：1 个可选值，例如：1

引擎列表

Naver 搜索