# Naver Place Rank API (https://www.socialcrawl.dev/platforms/naver/place-rank)

> Returns where one Naver Place ranks in the Naver Map result list for up to 10 keywords, searched from one point, under `data.results[]`: `rank` (1-based, organic places only, ad slots are never counted), `found`, `rank_label` (`100+` when the place is not in the top 100), `total_results`, the place's visitor and blog review counts, and the places ranked at the top (`top`). Naver ranks by distance from the person searching, so the point matters: send `lat` and `lng` to search from a spot, or leave them out and the search is made from the place itself (the point used is echoed under `data.point`, with `source` set to `place` or `request`). Set `ads=true` to also report the place's position among the paid 플레이스 광고 slots (`ad_rank`). Every number sits at a fixed path (`data.results[0].rank`), so a Monitor can track it daily.

TL;DR: `GET /v1/naver/place/rank` costs 4 credits per keyword, plus 2 credits when lat and lng are left out (the point is read from the place). The whole amount is refunded when the check fails. and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `keywords` | yes | One to ten keywords, separated by commas, exactly as a person types them into Naver, e.g. `신사역 정형외과,강남 대상포진`. |
| `id` | no | The Naver Place id, e.g. 11669922 (the number in the place's link). Send this or url. |
| `url` | no | The place's link as Naver shows it: m.place.naver.com/hospital/11669922/home, map.naver.com/p/entry/place/11669922, or a naver.me share link. Send this or id. |
| `lat` | no | Latitude of the point to search from (send with lng). Leave both out to search from the place itself. |
| `lng` | no | Longitude of the point to search from (send with lat). |
| `top` | no | How many of the top-ranked places to list with each result, 0 to 20 (default 5). |
| `ads` | no | Also check the paid 플레이스 광고 slots and report the place's `ad_rank` (default false). |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/naver/place/rank" \
  --data-urlencode "keywords=신사역 정형외과,강남 대상포진" \
  --data-urlencode "id=11669922" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

See the full Naver API: https://www.socialcrawl.dev/platforms/naver

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing