Naver Search

Search for Naver results based on keywords.

If you already know that you want to use Naver Search, this page is the one you should read. It shows the required input, the filters you can apply, how pagination works, and what localization controls are available.

At a Glance

Field	Value
Name	Naver Search
Scraper	`naver_search`
Engine	`naver_search`
Website	Naver
Website URL	Naver.com
Output Format	`json`
Version	`1.0.0`
Parameter Count	`6`
Parameter Groups	Search Query (1), Pagination (3), Search type (1), Advanced Filters (1)

Request Example

This is the real request body used to validate naver_search during this docs refresh. For /v1/serp, the engine field should be the engine's scraper value.

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"}'

Response Example

The JSON below comes from the same live response. Long strings, data URLs, and large arrays were shortened so the example stays readable.

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

Required Parameters

If you are sending your first request with this engine, start here. Requiredness is based on properties.<field>.must, not the top-level required array.

Field	Type	Group	Description
`q`	`string`	Search Query	The keyword or phrase you want this search engine to look up.

Available Parameters

The sections below follow the same parameter groups as the backend, but the field descriptions have been rewritten into shorter, user-facing wording so they are easier to scan.

Search Query

Field	Type	Required	Description
`q`	`string`	Yes	The keyword or phrase you want this search engine to look up.

Pagination

Field	Type	Required	Description
`num`	`number`	No	Requested number of results to return.
`page`	`number`	No	Page number used by this engine.
`start`	`number`	No	Result offset used for Google-style pagination.