Naver AI Overview API

/search?engine=naver_ai_overview API endpoint allows you to scrape the results from Naver search engine via our SerpApi service. Head to the playground for a live and interactive demo.

API Parameters

Search Query

query

Required

Parameter defines the query you want to search.

Serpapi Parameters

engine

Required

Set parameter to naver_ai_overview to use the Naver Ai Overview API engine.

device

Optional

Parameter defines the device to use to get the results. It can be set to desktop (default) to use a regular browser, tablet to use a tablet browser (currently using iPads), or mobile to use a mobile browser.

no_cache

Optional

Parameter will force SerpApi to fetch the Naver Ai Overview results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.

async

Optional

Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.

zero_trace

Optional

Enterprise only. Parameter enables ZeroTrace mode. It can be set to false (default) or true. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.

api_key

Required

Parameter defines the SerpApi private key to use.

output

Optional

Parameter defines the final output you want. It can be set to json (default) to get a structured JSON of the results, or html to get the raw html retrieved.

json_restrictor

Optional

Parameter defines the fields you want to restrict in the outputs for smaller, faster responses. See JSON Restrictor for more details.

API Results

JSON Results

JSON output includes structured data for text_blocks, references, and more.

A search status is accessible through search_metadata.status. It flows this way: Processing -> Success || Error. If a search has failed, error will contain an error message. search_metadata.id is the search ID inside SerpApi.

HTML Results

HTML output is useful to debug JSON results or support features not supported yet by SerpApi. HTML output gives you the raw HTML result from Naver AI Overview.

API Examples

Naver search results for query:Coffee

Naver search results for query:Coffee

JSON Example

{
  "search_metadata": {
    "id": "693a9572fe1c6b117e9ca874",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/1f3fa2781f8ec753/693a9572fe1c6b117e9ca874.json",
    "created_at": "2025-12-11 09:57:06 UTC",
    "processed_at": "2025-12-11 09:57:06 UTC",
    "naver_ai_overview_url": "https://aib-api.naver.com/aibrender.naver?query=Coffee&where=nexearch",
    "raw_html_file": "https://serpapi.com/searches/1f3fa2781f8ec753/693a9572fe1c6b117e9ca874.html",
    "prettify_html_file": "https://serpapi.com/searches/1f3fa2781f8ec753/693a9572fe1c6b117e9ca874.prettify",
    "total_time_taken": 6.19
  },
  "search_parameters": {
    "query": "Coffee"
  },
  "markdown": "[1]: https://namu.wiki/w/%EC%BB%A4%ED%94%BC \"커피 - 나무위키\"\n\n[2]: https://ko.wikipedia.org/wiki/%EC%BB%A4%ED%94%BC \"커피\"\n\n[3]: https://cafe.naver.com/nyctourdesign/1150414?art=ZXh0ZXJuYWwtc2VydmljZS1uYXZlci1haS1icmllZmluZw.eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJjYWZlVHlwZSI6IkNBRkVfVVJMIiwiYXJ0aWNsZUlkIjoxMTUwNDE0LCJjYWZlVXJsIjoibnljdG91cmRlc2lnbiIsImlzc3VlZEF0IjoxNzY1NDQ3MDI5NTI1fQ.xwTXaIzoOpzsPBHSHB-ouyay-7xFv1UGzQwB9iRR1AQ \"Verve Coffee Roasters @ Melrose Ave (LA 커피 찐 맛집)\"\n\n[4]: https://cafe.naver.com/vinpearl/295037?art=ZXh0ZXJuYWwtc2VydmljZS1uYXZlci1haS1icmllZmluZw.eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJjYWZlVHlwZSI6IkNBRkVfVVJMIiwiYXJ0aWNsZUlkIjoyOTUwMzcsImNhZmVVcmwiOiJ2aW5wZWFybCIsImlzc3VlZEF0IjoxNzY1NDQ3MDI5NTI1fQ.xpQs9HJLr4nNY4f-Ws_ZOS9paHiADoJv6S2-NMAxr3U \"하이랜드도 지겹다면 더 컵스 커피(The cups coffee)\"\n\n[5]: https://cafe.naver.com/taesarang/861582?art=ZXh0ZXJuYWwtc2VydmljZS1uYXZlci1haS1icmllZmluZw.eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJjYWZlVHlwZSI6IkNBRkVfVVJMIiwiYXJ0aWNsZUlkIjo4NjE1ODIsImNhZmVVcmwiOiJ0YWVzYXJhbmciLCJpc3N1ZWRBdCI6MTc2NTQ0NzAyOTUyNX0.o9QxXv3vlCScw2UNEjPRr78ldmO5-55fgQwMRT0saIg \"BLUE COFFEE\"\n\n커피는 **아프리카 원산의 커피나무의 씨앗(원두)을 볶고 갈아 추출한 음료**로, 전 세계적으로 사랑받는 기호식품입니다. **카페인 함유로 각성 효과**가 있어 잠을 깨거나 휴식을 취할 때 자주 마십니다. [1][1]\n\n### 커피의 주요 특징\n- **기원 및 역사**: 7세기 이전 에티오피아에서 발견된 것으로 전해지며, 이후 이집트·예멘 등지로 전파되었습니다. 한국에는 개화기 이후 들어왔으며, 한자어로는 '가배(珈琲)'로도 불렸습니다. [2][2]\n- **종류와 품종**: 대표적으로 아라비카, 로부스타, 리베리카 등이 있으며, 각 품종마다 맛과 향, 산미에 차이가 있습니다. [1][1]\n- **음용 방식**: 원두를 볶아 분쇄 후, 물이나 우유 등으로 추출해 아메리카노, 라떼 등 다양한 형태로 즐깁니다. [1][1] [3][3]\n- **문화적 의미**: 커피는 각성 효과뿐 아니라, 사회적 만남과 휴식, 문화의 한 부분으로 자리잡았습니다. '커피 브레이크'라는 용어도 이에서 유래했습니다. [2][2]\n\n### 알아두면 좋은 점\n- 커피는 **온대·열대 기후에서만 잘 자라며**, 커피 벨트 국가에서 주로 생산됩니다. [1][1]\n- 커피를 마시며 휴식을 취하는 문화는 전 세계적으로 확산되어 있습니다. [2][2]",
  "text_blocks": [
    {
      "type": "paragraph",
      "snippet": "커피는 아프리카 원산의 커피나무의 씨앗(원두)을 볶고 갈아 추출한 음료로, 전 세계적으로 사랑받는 기호식품입니다. 카페인 함유로 각성 효과가 있어 잠을 깨거나 휴식을 취할 때 자주 마십니다.",
      "snippet_highlighted_words": [
        "아프리카 원산의 커피나무의 씨앗(원두)을 볶고 갈아 추출한 음료",
        "카페인 함유로 각성 효과"
      ],
      "reference_indexes": [
        1
      ]
    },
    {
      "type": "header",
      "snippet": "커피의 주요 특징"
    },
    {
      "type": "list",
      "list": [
        {
          "snippet": "기원 및 역사: 7세기 이전 에티오피아에서 발견된 것으로 전해지며, 이후 이집트·예멘 등지로 전파되었습니다. 한국에는 개화기 이후 들어왔으며, 한자어로는 '가배(珈琲)'로도 불렸습니다.",
          "snippet_highlighted_words": [
            "기원 및 역사"
          ],
          "reference_indexes": [
            2
          ]
        },
        {
          "snippet": "종류와 품종: 대표적으로 아라비카, 로부스타, 리베리카 등이 있으며, 각 품종마다 맛과 향, 산미에 차이가 있습니다.",
          "snippet_highlighted_words": [
            "종류와 품종"
          ],
          "reference_indexes": [
            1
          ]
        },
        {
          "snippet": "음용 방식: 원두를 볶아 분쇄 후, 물이나 우유 등으로 추출해 아메리카노, 라떼 등 다양한 형태로 즐깁니다.",
          "snippet_highlighted_words": [
            "음용 방식"
          ],
          "reference_indexes": [
            1,
            3
          ]
        },
        ...
      ]
    },
    ...
  ],
  "references": [
    {
      "index": 1,
      "title": "커피 - 나무위키",
      "snippet": "개요 커피(coffee)는 아프리카 원산의 열대 상록수인 커피나무의 씨앗(원두)을 볶고 갈아서 추출한 음료의 일종이다. 색이 어둡고, 쓴 맛과 고소한 향, 약간의 산미를 가지고 있",
      "link": "https://namu.wiki/w/%EC%BB%A4%ED%94%BC",
      "source": "나무위키",
      "source_icon": "https://namu.wiki/favicon.ico"
    },
    {
      "index": 2,
      "title": "커피",
      "snippet": "아랍어의 까후와는 ‘배고픔을 줄이다’라는 의미의 ‘까히야’의 변화형으로, 원래 와인의 한 종류를 가리키는 말이었으나, 와인과 유사한 각성효과가 있는 커피에도 붙여졌다고 한다. 아랍",
      "link": "https://ko.wikipedia.org/wiki/%EC%BB%A4%ED%94%BC",
      "source": "위키백과 한국어",
      "source_icon": "https://ko.wikipedia.org/favicon.ico"
    },
    {
      "index": 3,
      "title": "Verve Coffee Roasters @ Melrose Ave (LA 커피 찐 맛집)",
      "snippet": "참여왕의 후기왕 작성 기준은 글자 수 500자, 사진 5장 이상입니다. *은 필수입력 _________________________________ 맛 ⭐⭐⭐⭐⭐ 분위기(뷰) ⭐⭐⭐",
      "link": "https://cafe.naver.com/nyctourdesign/1150414?art=ZXh0ZXJuYWwtc2VydmljZS1uYXZlci1haS1icmllZmluZw.eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJjYWZlVHlwZSI6IkNBRkVfVVJMIiwiYXJ0aWNsZUlkIjoxMTUwNDE0LCJjYWZlVXJsIjoibnljdG91cmRlc2lnbiIsImlzc3VlZEF0IjoxNzY1NDQ3MDMyOTAxfQ.iNrFOt9fFOpkxmVtiYx-NBvuTeBNXUJONV4HvuMMALQ",
      "source": "네이버 카페",
      "source_icon": "http://cafefiles.naver.net/MjAyNTA4MTFfNjUg/MDAxNzU0ODg1MTA1OTQ3.CBYwvRRPq_pR1Vj2WSobBVOZSNtFnZY_aWHrbC49mwQg.Xkp_Ij4USoy9Lf5k5eXJog1bC2C2kEQp7nMABtyb6DQg.JPEG/%EB%AF%B8%EC%97%AC%EB%94%94%EB%A1%9C%EA%B3%A0%EB%AA%A8%EB%B0%94%EC%9D%BC.jpg"
    }
  ],
  "media": [
    {
      "title": "Coffee beans around a cup of coffee 이미지 (533726779) - 게티이미지뱅크 Coffee beans around a cup of coffee",
      "link": "http://www.gettyimagesbank.com/i/533726779",
      "thumbnail": "http://imagescdn.gettyimagesbank.com/500/15/440/208/0/533726779.jpg",
      "platform": "www.gettyimagesbank.com"
    },
    {
      "title": "Coffee Lovers May Someday Brew Their Java with Space-Roasted Beans | Space Coffee Lovers May Someday Brew Their Java with Space...",
      "link": "https://www.space.com/43195-space-roasters-reentry-coffee-beans.html",
      "thumbnail": "https://cdn.mos.cms.futurecdn.net/LJ28Btp2BRmqHcUyJnce96-1500-80.jpg",
      "platform": "www.space.com"
    },
    {
      "title": "Cup of coffee on a black background, a Photo by LOGOCREATIVE",
      "link": "https://creativemarket.com/Mujigraphic/289599784-Cup-of-coffee-on-a-black-background",
      "thumbnail": "https://tint.creativemarket.com/fC28Sv7XFN1W7wyuJfgzOcwCUcOpSDRfmzed3SZzWm4/width:1820/height:1020/gravity:ce/rt:fill-down/el:1/czM6Ly9maWxlcy5jcmVhdGl2ZW1hcmtldC5jb20vaW1hZ2VzL3NjcmVlbnNob3RzL3Byb2R1Y3RzLzUyMDYvNTIwNjMvNTIwNjMwNTcvY3Vqc2RtdGhqZHhzb2kzN2JiOGFweWNhY3d2b250OHYyenNoOWFxaDc0dWNpbjIzc2hoYXc0NjZmeml6bHpicC1vLmpwZyMxNzMxNDMxMTc4?1731431178",
      "platform": "creativemarket.com"
    },
    ...
  ],
  "related_questions": [
    {
      "question": "커피의 주요 원산지는 어디인가요?",
      "serpapi_link": "https://serpapi.com/search.json?engine=naver_ai_overview&query=%EC%BB%A4%ED%94%BC%EC%9D%98+%EC%A3%BC%EC%9A%94+%EC%9B%90%EC%82%B0%EC%A7%80%EB%8A%94+%EC%96%B4%EB%94%94%EC%9D%B8%EA%B0%80%EC%9A%94%3F"
    },
    {
      "question": "커피를 집에서 만드는 방법은?",
      "serpapi_link": "https://serpapi.com/search.json?engine=naver_ai_overview&query=%EC%BB%A4%ED%94%BC%EB%A5%BC+%EC%A7%91%EC%97%90%EC%84%9C+%EB%A7%8C%EB%93%9C%EB%8A%94+%EB%B0%A9%EB%B2%95%EC%9D%80%3F"
    },
    {
      "question": "커피가 건강에 미치는 영향은?",
      "serpapi_link": "https://serpapi.com/search.json?engine=naver_ai_overview&query=%EC%BB%A4%ED%94%BC%EA%B0%80+%EA%B1%B4%EA%B0%95%EC%97%90+%EB%AF%B8%EC%B9%98%EB%8A%94+%EC%98%81%ED%96%A5%EC%9D%80%3F"
    }
  ]
}

JSON structure overview

{
  ...
  "markdown": "String - Markdown formatted text representing the main content",
  "text_blocks": [
    {
      "type": "String - Type of the text block. Can be 'heading', 'paragraph', 'list'",
      "snippet": "String - Snippet of the text block",
      "snippet_highlighted_words": "Array of Strings - Highlighted words in the snippet",
      "reference_indexes": "Array of Integers - Indexes of references related to this text block",
      // Only for 'list' type
      "list": [
        {
          "snippet": "String - Snippet of the list item",
          "snippet_highlighted_words": "Array of Strings - Highlighted words in the snippet",
          "reference_indexes": "Array of Integers - Indexes of references related to this list item"
        }
      ]
    }
  ],
  "references": [
    {
      "index": "Integer - Index of the reference",
      "title": "String - Title of the reference",
      "snippet": "String - Snippet of the reference",
      "link": "String - URL of the reference",
      "source": "String - Source name of the reference",
      "source_icon": "String - URL of the source icon"
    },
    ...
  ],
  "media": [
    {
      "title": "String - Title of the media",
      "link": "String - URL of the media",
      "thumbnail": "String - URL of the media thumbnail",
      "platform": "String - Platform name of the media"
    },
    ...
  ],
  "related_questions": [
    {
      "question": "String - Related question",
      "serpapi_link": "String - SerpApi link for the related question"
    },
    ...
  ],
  ...
}