Naver Place API

GET | POST /v1/naver/place

파라미터는 GET의 쿼리 문자열로도, POST의 JSON 본문으로도 보낼 수 있습니다. 둘은 같습니다.

요청

curl "https://gateway.apinoa.com/v1/naver/place?id=1668757640" \
  -H "x-api-key: $APINOA_API_KEY"

파라미터

파라미터	타입	필수	설명
`id`	string		The place's id, as `places` returns it.
`url`	string		A Naver Map place URL.

같은 파라미터와 모든 응답 타입은 OpenAPI 문서에도 있습니다.

응답

data에 Place를 돌려줍니다. 실제 응답을 줄인 것입니다. 배열은 앞쪽 항목만 남기고 긴 텍스트는 잘랐습니다.

{
  "success": true,
  "data": {
    "id": "1668757640",
    "name": "퍼스트커피랩 강남점",
    "url": "https://map.naver.com/p/entry/place/1668757640",
    "address": {"full": "서울 강남구 봉은사로6길 39 1층", "street": "서울 강남구 봉은사로6길 39 1층"},
    "coordinates": {"lat": 37.5026235, "lng": 127.0279481},
    "categories": ["카페"],
    "rating": 4.93,
    "reviewCount": 3373,
    "phone": "0507-1315-7680",
    "website": "https://www.instagram.com/firstcoffee_lab_gangnam",
    "hours": [{"day": "금", "hours": "11:00–01:00"}],
    "photos": ["https://ldb-phinf.pstatic.net/20261002_202/1790915466684GML4H_JPEG/%C7…"],
    "attributes": [{"group": "편의", "label": "무선 인터넷"}],
    "description": "미디어아트 카페 퍼스트커피랩 강남역점은 전문 바리스타 양성 기관인 [퍼스트 아카데미]에서 운영하는 특별한 카페로, 커피 애호가…",
    "lang": "ko",
    "ext": {
      "directions": "신논현역 6번 출구 도보 300m 입니다.\n주차구역은 따로 없으며\n가까운 주차장 ㅡ\n1. 강남 24시 주차장\n2. 벧엘 주차장…",
      "microReviews": ["친절한 사장님과 함께하는 달콤한 시간"],
      "blogCafeReviewCount": 2137,
      "textReviewCount": 3124,
      "menus": [{"name": "에스프레소", "price": {"priceType": "fixed", "displayText": "6,500원"}}],
      "subway": [
        {
          "name": "신분당",
          "line": "신논현역 신분당선",
          "station": "신논현역",
          "exit": "6",
          "walkMinutes": 6,
          "walkMeters": 321,
          "coordinates": {"lat": 37.503932, "lng": 127.0247661},
          "transfers": ["9호선"]
        }
      ],
      "reviewKeywords": [{"name": "디저트가 맛있어요", "count": 2812}],
      "reviewMenus": [{"name": "커피", "count": 770}],
      "reviewThemes": [{"name": "만족도", "count": 2307}],
      "reviewStats": {
        "ratedReviews": 197,
        "reviewers": 985,
        "photoReviews": 2890,
        "keywordVotes": 14201,
        "keywordVoters": 3146,
        "keywordReviews": 3351
      },
      "topPhotos": [
        {
          "url": "https://ldb-phinf.pstatic.net/20261002_202/1790915466684GML4H_JPEG/%C7…",
          "category": "퍼스트커피랩 강남점",
          "format": "image",
          "source": "business",
          "width": 1254,
          "height": 1254
        }
      ],
      "totalPhotos": 94,
      "phoneInfo": {
        "phone": "0507-1315-7680",
        "isVirtualPhone": true,
        "isPrivatePhone": false,
        "hasMobilePhoneNumber": false
      },
      "houseBanners": [
        {
          "id": "https://maps-service.pstatic.net/maps-cms/568f3214-4368-46cc-9ce1-61c1…",
          "slotIndex": 1,
          "imageUrl": "https://maps-service.pstatic.net/maps-cms/568f3214-4368-46cc-9ce1-61c1…",
          "linkUrl": "https://booking.map.naver.com/promotions/home",
          "bgColor": "#176CFF",
          "altText": "놓치면 아까운 혜택! 네이버지도에서 예약하세요. "
        }
      ],
      "accessor": {"hasAccessor": true},
      "buttons": [{"key": "streetview", "name": "거리뷰"}],
      "badge": [{"key": "placePlus", "text": "place+"}],
      "menuImages": [{"imageUrl": "https://ldb-phinf.pstatic.net/20241111_227/1731306011538aSgKQ_PNG/2024…"}],
      "naverBooking": {"bookingDisplayName": "방문", "bookingButtonName": "예약", "hasSmartOrder": false},
      "relatedLinks": [
        {
          "name": "식신",
          "iconName": "siksin",
          "url": "https://www.siksinhot.com/P/1557066",
          "clickCode": "siksin"
        }
      ],
      "fsasReviews": {
        "total": 2139,
        "items": [
          {
            "name": "뽀샤시 뽀샤시~~♥",
            "type": "blog",
            "typeName": "블로그",
            "url": "https://m.blog.naver.com/qhtitl1220/224444895153",
            "home": "https://m.blog.naver.com/qhtitl1220",
            "id": "blog_뽀샤시 뽀샤시~~♥_224444895153_강남역베이커리카페 퍼스트커피랩 강남점에서 데이트!",
            "title": "강남역베이커리카페 퍼스트커피랩 강남점에서 데이트!",
            "rank": "1",
            "contents": "베프랑 점심을 먹고 카페 데이트 하러 오랫만에 강남역 퍼스트커피랩에 들렀답니다. 카페 외관은 화이트 건물의 깔끔한 외관이랍니다…",
            "thumbnailUrl": "http://blogfiles.naver.net/MjAyNjEwMTdfMTU0/MDAxNzkyMjM3NjQ1MDE3.d_axC…",
            "thumbnailUrlList": ["http://blogfiles.naver.net/MjAyNjEwMTdfMTU0/MDAxNzkyMjM3NjQ1MDE3.d_axC…"],
            "thumbnailCount": "30",
            "date": "2026.10.17.",
            "isRepresentative": false,
            "profileImageUrl": "https://blogpfthumb-phinf.pstatic.net/MjAyMzAyMjVfNDIg/MDAxNjc3MzEyOTA…",
            "isVideoThumbnail": false,
            "reviewId": "224444895153",
            "authorName": "뽀샤시",
            "createdString": "10.17.토",
            "buyWithMyMoneyType": true
          }
        ]
      },
      "busStations": [
        {
          "id": "106166",
          "name": "신논현역6번출구",
          "displayCode": "23286",
          "lat": 37.5023804,
          "lng": 127.025829,
          "innerRoutes": {"routeType": [{"type": "12", "typeName": "지선"}]},
          "walkTime": 5,
          "walkingDistance": 328
        }
      ],
      "hasCoupon": {"count": 1},
      "hasFeed": {"blogExist": false, "feedExist": true},
      "shopWindow": {
        "total": 0,
        "homepages": {
          "repr": {
            "url": "https://www.instagram.com/firstcoffee_lab_gangnam",
            "landingUrl": "https://www.instagram.com/firstcoffee_lab_gangnam",
            "isDeadUrl": false,
            "type": "인스타그램",
            "order": 0
          }
        }
      },
      "restaurantInfoTabDetails": {"seat": [{"id": "301", "name": "룸", "description": "300명 이하"}]},
      "businessTools": {
        "tools": [
          {
            "type": "smartOrder",
            "title": "네이버 주문",
            "description": "매장 내 주문부터 포장주문까지 편하게",
            "link": "https://new.smartplace.naver.com/bizes/place/1668757640/solutions/orde…",
            "using": false
          }
        ],
        "hideAnnouncement": false
      },
      "informationTab": {"facilities": [{"id": "7", "name": "무선 인터넷", "i18nName": "무선 인터넷"}], "keywordList": ["강남역디저트"]},
      "festivalPerformance": {"festivalsTotal": 0, "performancesTotal": 0},
      "POS": {
        "isPOS": true,
        "salesCount": 7007,
        "popularMenus": [{"name": "아메리카노", "count": 550, "orderShare": 21, "rankChange": "SAME"}],
        "averagePrice": {"morning": 16308, "lunch": 17716, "dinner": 17304, "night": 17133, "total": 17426},
        "popularDay": "saturday",
        "weeklyPopularity": {
          "monday": {"popularity": [0], "popularTime": 14},
          "tuesday": {"popularity": [0], "popularTime": 12},
          "wednesday": {"popularity": [0], "popularTime": 20},
          "thursday": {"popularity": [0], "popularTime": 20},
          "friday": {"popularity": [0], "popularTime": 20},
          "saturday": {"popularity": [0], "popularTime": 14},
          "sunday": {"popularity": [0], "popularTime": 14}
        },
        "today": "friday"
      },
      "tabs": [{"tabId": "home", "name": "홈"}],
      "exp": {"total": 0},
      "staticMapUrl": "https://simg.pstatic.net/static.map/v2/map/staticmap.bin?center=127.02…",
      "isRelaxRestaurant": false,
      "isStarbucks": false,
      "is100YearCertified": false,
      "is100YearSmallManufacturer": false,
      "isNFASafetyCertified": false,
      "isAntiqueStore": false,
      "newOpening": false,
      "visitorReviewMediasTotal": 8388,
      "isKoreaGrandSale": false,
      "hasAroundItems": false,
      "hasAiBriefing": true,
      "acceptsCultureDeductionCoupon": false,
      "topAnimatedPhotos": {"total": 0}
    },
    "statusText": "11:00에 영업 시작",
    "lotAddress": "서울 강남구 역삼동 618-18"
  }
}

에러

상태	코드	의미
400	`INVALID_PARAMS`	파라미터가 없거나, 알 수 없거나, 범위를 벗어났거나, 이 엔진이 받지 않는 값입니다. 메시지에 이름이 나옵니다.
401	`UNAUTHORIZED`	`x-api-key` 헤더가 없거나, 폐기되었거나 알 수 없는 키입니다.
402	`INSUFFICIENT_BALANCE`	잔액이 이 호출 비용에 모자랍니다. 대시보드에서 충전하세요.
404	`NOT_FOUND`	장소가 없습니다.
429	`MARKETPLACE_SATURATED`	동시 호출이 너무 많습니다. `Retry-After` 초만큼 기다린 뒤 다시 시도하세요.
502	`UPSTREAM_ERROR`	엔진이 쓸 수 없는 응답을 보냈습니다. 간격을 두고 다시 시도하세요.
503	`SERVICE_UNAVAILABLE`	일시적인 장애입니다. 간격을 두고 다시 시도하세요.

모든 코드는 Errors에 있습니다. 실패한 호출은 과금되지 않습니다.

가격

가격 호출당 $0.0012. 정가 기준이며, 하루 1,000회를 넘으면 단가가 내려갑니다.

참고

places가 돌려준 id를 넘기거나, 장소의 지도 링크를 url로 넘깁니다.

Place

요청

파라미터

응답

에러

가격

참고

이 페이지 내용