Apinoa Docs

Place

从 Naver 获取单个地点的详细信息。

查看原始 .mdx
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"

参数

参数类型必填说明
idstringThe place's id, as places returns it.
urlstringA 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"
  }
}

错误

状态代码含义
400INVALID_PARAMS参数缺失、未知、超出范围,或该引擎不接受。消息中会指出是哪一个。
401UNAUTHORIZED缺少 x-api-key 请求头,或密钥已吊销或未知。
402INSUFFICIENT_BALANCE余额不足以支付本次调用。请在控制台充值。
404NOT_FOUND该地点不存在。
429MARKETPLACE_SATURATED并发调用过多。请等待 Retry-After 秒后重试。
502UPSTREAM_ERROR引擎返回了无法使用的内容。请退避后重试。
503SERVICE_UNAVAILABLE临时故障。请退避后重试。

全部错误代码见 Errors。失败的调用不计费。

价格

价格 每次调用 $0.0012。标价;单日调用超过 1,000 次后单价下调。

说明

  • 传入 places 返回的 id,或把地点的地图链接作为 url 传入。

本页内容