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

# Data reference

> Metrics, breakdowns, refresh cadence, and limits for the Naver Smart Place data source in Adriel.

## Introduction

Naver Smart Place is Naver's local business listing platform in South Korea — the equivalent of Google Business Profile for the Korean market. Business owners register their storefront on Naver Smart Place and appear on Naver Search and Naver Map with reviews, reservations, and receipt-linked visitor data. This connector reports on that visibility: daily and cumulative review counts (including a breakdown of Naver Map review types), replied reviews, reservations, and receipts.

Because Naver does not publish an official API for Smart Place, data is captured through headless-browser automation that logs in with Naver credentials and intercepts the GraphQL and statistics responses from Naver's own frontend.

To connect this data source, see [How to connect Naver Smart Place to Adriel](/data-sources/g-n/naver-smart-place/how-to-connect).

## Data refresh strategy

Naver Smart Place data refreshes **once daily**. Each cycle logs in, navigates to the reviews, statistics, and Naver Map pages for the selected place, and upserts the day's row into the historical time series (so past days are preserved). The list of places available on a Naver account is cached for 3 hours after credentials are validated.

## Architecture levels

Each Naver Smart Place data source represents a single Naver place. When a Naver account owns multiple places, users can create up to **10 data sources per connection** — one per selected place — from the multi-select step during the connection flow.

## Metrics

<Note>
  **How to read the columns**

  **Data type vocabulary**: Number, Currency, Percentage, Ratio, Duration, Date, Text, URL, Array, Boolean.

  Naver Smart Place has no documented public API, so no literal API field name applies. The **API Key** column instead notes, in *italics*, the Naver page or endpoint each value is intercepted from.
</Note>

### Reviews

| Metric                | Description                               | Data type | API Key                                                     |
| --------------------- | ----------------------------------------- | --------- | ----------------------------------------------------------- |
| Total reviews         | Cumulative total reviews on the place.    | Number    | *Naver Smart Place reviews page (**`getReviews`** GraphQL)* |
| Replied reviews       | Cumulative reviews that received a reply. | Number    | *Naver Smart Place reviews page (**`getReviews`** GraphQL)* |
| Daily reviews         | Reviews received on the given day.        | Number    | *Naver Smart Place reviews page (**`getReviews`** GraphQL)* |
| Daily replied reviews | Reviews replied to on the given day.      | Number    | *Naver Smart Place reviews page (**`getReviews`** GraphQL)* |

### Reservations & receipts

| Metric       | Description                                            | Data type | API Key                                          |
| ------------ | ------------------------------------------------------ | --------- | ------------------------------------------------ |
| Reservations | Reservations made via Naver Smart Place for the day.   | Number    | *Statistics API (**`/api/statistics/review/`**)* |
| Receipts     | Receipts issued or linked to reservations for the day. | Number    | *Statistics API (**`/api/statistics/review/`**)* |

### Naver Map

| Metric                           | Description                                                                              | Data type | API Key                                               |
| -------------------------------- | ---------------------------------------------------------------------------------------- | --------- | ----------------------------------------------------- |
| Naver Map total reviews          | Total visitor reviews shown on Naver Map for the place (excluding keyword/star reviews). | Number    | *Naver Map (**`pcmap-api.place.naver.com`** GraphQL)* |
| Naver Map blog reviews           | Blog reviews linked from the Naver Map profile.                                          | Number    | *Naver Map (**`pcmap-api.place.naver.com`** GraphQL)* |
| Naver Map keyword / star reviews | Keyword-tag and star-rating reviews shown on Naver Map.                                  | Number    | *Naver Map (**`pcmap-api.place.naver.com`** GraphQL)* |

### Place metadata

| Metric     | Description                            | Data type | API Key                                            |
| ---------- | -------------------------------------- | --------- | -------------------------------------------------- |
| Place name | Display name of the Naver Smart Place. | Text      | *Resolved from Naver Smart Place account metadata* |

## Breakdowns

### Time & date grouping

<Note>
  Adriel groups Naver Smart Place's daily-granularity results into these standard views for reporting alongside other connectors.
</Note>

| Breakdown           | Description                                                  |
| ------------------- | ------------------------------------------------------------ |
| Auto Time Breakdown | Automatically picks the best granularity for the date range. |
| Daily               | Split reports by day.                                        |
| Weekly (Start: Mon) | Split reports by ISO week, starting Monday.                  |
| Monthly             | Split reports by calendar month.                             |
| Quarterly           | Split reports by calendar quarter.                           |
| Yearly              | Split reports by calendar year.                              |

### Place

| Breakdown  | Description                                  | API Key                                            |
| ---------- | -------------------------------------------- | -------------------------------------------------- |
| Place name | Group by the Naver Smart Place display name. | *Resolved from Naver Smart Place account metadata* |

### Overview

<Note>
  These are Adriel-side groupings, not Naver breakdowns.
</Note>

| Breakdown        | Description                                   |
| ---------------- | --------------------------------------------- |
| No Grouping      | Do not break down; return one aggregated row. |
| Data source name | Group by Adriel data source name.             |

## Limitations

* **Scraped, not API-backed** — Naver Smart Place does not offer a public REST API. All data is captured by a headless browser logging in as the account owner and intercepting the responses that Naver's own frontend calls. This makes the connector sensitive to UI or API-shape changes on Naver's side.
* **ID + password required** — the connection requires the Naver login ID (or phone number) and password. Email-format IDs (containing `@`) are rejected before login is attempted.
* **Two-step verification must be disabled** on the Naver account, or login will fail with an MFA error and the data source will be disconnected.
* **Seoul-region logins must be allowed** in Naver security settings. Naver's default region-block behavior will block the connector's login attempts and disconnect the data source.
* **Up to 10 places per connection** — the multi-select step during connection is capped at 10 places. Accounts with more places must create additional connections.
* **Booking-type places skip Naver Map metrics** — if a place redirects to Naver Booking rather than a Naver Map profile, the Naver Map metrics (total reviews, blog reviews, keyword/star reviews) return zero for that place.
* **Ownership transfer blocks scraping** — while a place ownership change is under review on Naver, no data can be scraped for that place until the transfer completes.
* **CAPTCHA fallback** — Naver may occasionally serve a CAPTCHA during login. The connector attempts to solve it up to three times before disconnecting the data source.

## API references

Naver Smart Place does not publish an official API. The connector reads from Naver's own frontend endpoints:

* [Naver Smart Place (new.smartplace.naver.com)](https://new.smartplace.naver.com/) — requires login
* [Naver Map (map.naver.com)](https://map.naver.com/)

## See also

* [How to connect Naver Smart Place](/data-sources/g-n/naver-smart-place/how-to-connect) (paired how-to)
* [Naver Blog data reference](/data-sources/g-n/naver-blog/data-reference) — for Naver's blog analytics