> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Scrape Naver Map places

> Naver Map (Naver Place), Korea's main local search. `mode=search&query=` returns up to 50 places (`results`): `id`, `name`, `category`, `businessType`, `address` / `roadAddress` / `jibunAddress`, `phone`, `latitude` / `longitude`, `rating`, `visitorReviewCount`, `blogReviewCount`, opening `status`, `microReview`, `popularMenus`, `options`, images, booking and Naver Pay flags, `hotelMinPrice` (stays), `representativePrice` (salons) and the place's Naver Map `url`, plus `totalResults`. `longitude` / `latitude` move the search centre (each place then carries its `distance`). `mode=details&place=<id or Naver Map link>` returns the `place` - addresses, phone, coordinates, `businessHours` per day, `description`, `directions`, `conveniences`, `facilities`, `keywords`, `menus` with prices, `photos`, `homepage` and `links`, `bookingUrl`, `subwayStations` and `reviewStats` (average rating, star distribution, keyword votes, themes) - with its first ten visitor `reviews` (`body`, `rating`, `created` / `createdDate`, `visitedAt`, `verifiedBy`, `keywords`, `media`, `reactions`, `author` stats, `ownerReply`) and its first `blogReviews` (blog and cafe posts). `sort=recent` returns the newest visitor reviews. Korean text is returned as is. One page per call, billed one unit.



## OpenAPI

````yaml /api-reference/openapi.json post /maps/naver-place
openapi: 3.1.0
info:
  title: ScrapeUnblocker API
  description: >-
    Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate
    every request with the `x-scrapeunblocker-key` header. Documented here:
    page-source extraction, Google SERP scraping, image fetch, and the dedicated
    plugin endpoints (search engines, marketplaces, reviews, travel, social and
    more). All other paths exist for internal operations and are intentionally
    hidden from this spec.
  version: 3.0.0
servers:
  - url: https://api.scrapeunblocker.com
    description: Production
security: []
paths:
  /maps/naver-place:
    post:
      tags:
        - Plugins
      summary: Scrape Naver Map places
      description: >-
        Naver Map (Naver Place), Korea's main local search. `mode=search&query=`
        returns up to 50 places (`results`): `id`, `name`, `category`,
        `businessType`, `address` / `roadAddress` / `jibunAddress`, `phone`,
        `latitude` / `longitude`, `rating`, `visitorReviewCount`,
        `blogReviewCount`, opening `status`, `microReview`, `popularMenus`,
        `options`, images, booking and Naver Pay flags, `hotelMinPrice` (stays),
        `representativePrice` (salons) and the place's Naver Map `url`, plus
        `totalResults`. `longitude` / `latitude` move the search centre (each
        place then carries its `distance`). `mode=details&place=<id or Naver Map
        link>` returns the `place` - addresses, phone, coordinates,
        `businessHours` per day, `description`, `directions`, `conveniences`,
        `facilities`, `keywords`, `menus` with prices, `photos`, `homepage` and
        `links`, `bookingUrl`, `subwayStations` and `reviewStats` (average
        rating, star distribution, keyword votes, themes) - with its first ten
        visitor `reviews` (`body`, `rating`, `created` / `createdDate`,
        `visitedAt`, `verifiedBy`, `keywords`, `media`, `reactions`, `author`
        stats, `ownerReply`) and its first `blogReviews` (blog and cafe posts).
        `sort=recent` returns the newest visitor reviews. Korean text is
        returned as is. One page per call, billed one unit.
      operationId: naver_place_maps_naver_place_post
      parameters:
        - name: mode
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              'search': search Naver Map for `query` (up to 50 places).
              'details': one place's full detail with its first visitor and blog
              reviews. Defaults to 'details' when `place` is given, else
              'search'.
            title: Mode
          description: >-
            'search': search Naver Map for `query` (up to 50 places). 'details':
            one place's full detail with its first visitor and blog reviews.
            Defaults to 'details' when `place` is given, else 'search'.
        - name: query
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              What to search for (mode=search), in Korean or English: a
              category, a place name or both, e.g. '강남 맛집', '홍대 카페', '부산 호텔',
              'Gangnam cafe'.
            title: Query
          description: >-
            What to search for (mode=search), in Korean or English: a category,
            a place name or both, e.g. '강남 맛집', '홍대 카페', '부산 호텔', 'Gangnam
            cafe'.
        - name: place
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              The place (mode=details): its Naver place id ('2097258400'), a
              Naver Map link (https://map.naver.com/p/entry/place/2097258400) or
              a Naver Place link
              (https://m.place.naver.com/restaurant/2097258400/home).
            title: Place
          description: >-
            The place (mode=details): its Naver place id ('2097258400'), a Naver
            Map link (https://map.naver.com/p/entry/place/2097258400) or a Naver
            Place link (https://m.place.naver.com/restaurant/2097258400/home).
        - name: longitude
          in: query
          required: false
          schema:
            anyOf:
              - type: number
              - type: 'null'
            description: >-
              Search centre longitude (mode=search, with `latitude`), e.g.
              127.0276. Naver ranks places around the centre, and each result
              then carries its `distance` from it.
            title: Longitude
          description: >-
            Search centre longitude (mode=search, with `latitude`), e.g.
            127.0276. Naver ranks places around the centre, and each result then
            carries its `distance` from it.
        - name: latitude
          in: query
          required: false
          schema:
            anyOf:
              - type: number
              - type: 'null'
            description: >-
              Search centre latitude (mode=search, with `longitude`), e.g.
              37.4979.
            title: Latitude
          description: >-
            Search centre latitude (mode=search, with `longitude`), e.g.
            37.4979.
        - name: max_results
          in: query
          required: false
          schema:
            type: integer
            description: >-
              How many places to return (mode=search, 1-50). Naver answers one
              page of up to 50 places per search; move the search centre to
              reach other places.
            default: 50
            title: Max Results
          description: >-
            How many places to return (mode=search, 1-50). Naver answers one
            page of up to 50 places per search; move the search centre to reach
            other places.
        - name: sort
          in: query
          required: false
          schema:
            type: string
            description: >-
              Visitor review order (mode=details): 'relevance' (Naver's default)
              or 'recent' (newest first).
            default: relevance
            title: Sort
          description: >-
            Visitor review order (mode=details): 'relevance' (Naver's default)
            or 'recent' (newest first).
        - name: proxy_country
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Proxy country the request is sent from (ISO-2, e.g. 'KR', 'US').
              Leave blank for the country chosen for the site.
            title: Proxy Country
          description: >-
            Proxy country the request is sent from (ISO-2, e.g. 'KR', 'US').
            Leave blank for the country chosen for the site.
      responses:
        '200':
          description: >-
            JSON with `results` (mode=search) or `place`, `reviews` and
            `blogReviews` (mode=details). A search Naver has no places for
            answers 200 with an empty `results` list.
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid parameters.
        '404':
          description: Naver has no place with that id.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: >-
            Blocked by Naver on every attempt, no Naver page returned, or Naver
            did not answer in time.
      security:
        - ScrapeUnblockerKey: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ScrapeUnblockerKey:
      type: apiKey
      in: header
      name: x-scrapeunblocker-key
      description: Your ScrapeUnblocker API key. Apply on every request.

````

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