Naver Place Visitor & Blog Review Finder

{
  "description": "Collect Naver Place visitor reviews, linked Naver Blog posts, and aggregated rating statistics. Provide place URLs/IDs directly, or search by keyword to discover places first.",
  "properties": {
    "excludeReviewIds": {
      "description": "Visitor review IDs and blog post URLs to skip. Useful for incremental runs that only want new reviews.",
      "editor": "stringList",
      "title": "Exclude review IDs or blog URLs",
      "type": "array"
    },
    "includeBlogReviews": {
      "default": true,
      "description": "Collect Naver Blog and cafe posts linked to the place, with exact publish dates.",
      "prefill": false,
      "title": "Include blog reviews",
      "type": "boolean"
    },
    "includeRatingOnlyReviews": {
      "default": true,
      "description": "Also collect reviews that have a star rating but no written text. These come from a separate Naver review stream and count toward maxReviews.",
      "prefill": false,
      "title": "Include rating-only reviews",
      "type": "boolean"
    },
    "includeReviewPhotos": {
      "default": false,
      "description": "Include photo and video-thumbnail URLs attached to each visitor review.",
      "prefill": false,
      "title": "Include review photos",
      "type": "boolean"
    },
    "includeReviewStats": {
      "default": true,
      "description": "Emit one stats record per place: average rating, rating distribution, themes, top menus, voted keywords, and review counts.",
      "prefill": false,
      "title": "Include review statistics",
      "type": "boolean"
    },
    "includeVisitorReviews": {
      "default": true,
      "description": "Collect visitor reviews. Turn off for a blog-only or stats-only run.",
      "prefill": true,
      "title": "Include visitor reviews",
      "type": "boolean"
    },
    "maxBlogReviews": {
      "default": 100,
      "description": "Maximum linked blog/cafe posts per place. Naver exposes at most 100 per place.",
      "maximum": 100,
      "minimum": 1,
      "prefill": 10,
      "title": "Max blog reviews per place",
      "type": "integer"
    },
    "maxConcurrency": {
      "default": 3,
      "description": "How many places to scrape in parallel. Higher is faster but increases rate-limit risk.",
      "maximum": 10,
      "minimum": 1,
      "prefill": 3,
      "title": "Max concurrent places",
      "type": "integer"
    },
    "maxItems": {
      "default": 100,
      "description": "Hard cap on total records emitted across all places.",
      "maximum": 5000,
      "minimum": 1,
      "prefill": 3,
      "title": "Max items",
      "type": "integer"
    },
    "maxPlacesPerKeyword": {
      "default": 3,
      "description": "Maximum places to scrape per keyword search. Naver's search page returns up to 100 places per keyword.",
      "maximum": 100,
      "minimum": 1,
      "prefill": 3,
      "title": "Max places per keyword",
      "type": "integer"
    },
    "maxReviews": {
      "default": 100,
      "description": "Maximum visitor reviews to collect per place, across both the text-review stream and the rating-only stream. Naver paginates 50 reviews per request.",
      "maximum": 5000,
      "minimum": 1,
      "prefill": 3,
      "title": "Max visitor reviews per place",
      "type": "integer"
    },
    "placeUrls": {
      "description": "Naver Place URLs, naver.me short links, or bare numeric Place IDs. Examples: 'https://map.naver.com/p/entry/place/38239053', 'https://pcmap.place.naver.com/place/38239053/home', '38239053'.",
      "editor": "stringList",
      "prefill": [
        "https://map.naver.com/p/entry/place/38239053"
      ],
      "title": "Place URLs or IDs",
      "type": "array"
    },
    "proxyConfiguration": {
      "description": "Optional. Leave empty to use direct requests; the actor escalates to an Apify datacenter proxy only after a real block.",
      "editor": "proxy",
      "title": "Proxy configuration",
      "type": "object"
    },
    "searchKeywords": {
      "description": "Keywords to discover places first, then scrape their reviews. Example: ['강남 맛집', '홍대 카페']. Can be combined with placeUrls.",
      "editor": "stringList",
      "title": "Search keywords",
      "type": "array"
    },
    "visitedSince": {
      "description": "Only keep visitor reviews whose visit date is on or after this date. Reviews without a visit date are skipped when this filter is set.",
      "editor": "datepicker",
      "title": "Visited since (YYYY-MM-DD)",
      "type": "string"
    }
  },
  "schemaVersion": 1,
  "title": "Naver Place Reviews + Blog Scraper Input",
  "type": "object"
}

{
  "actorOutputSchemaVersion": 1,
  "description": "Naver Place visitor reviews, linked blog posts with publish dates, and per-place rating statistics, distinguished by the reviewType field.",
  "properties": {
    "reviews": {
      "description": "Dataset containing visitor reviews, blog reviews, and place review statistics.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Review Records",
      "type": "string"
    }
  },
  "title": "Naver Place Visitor & Blog Review Finder Output"
}

{
  "actorSpecification": 1,
  "fields": {
    "properties": {
      "authorCount": {
        "description": "Number of distinct review authors",
        "type": "integer"
      },
      "averageRating": {
        "description": "Average visitor rating from Naver stats",
        "type": "number"
      },
      "blogContents": {
        "description": "Blog post excerpt",
        "type": "string"
      },
      "blogContentsLength": {
        "description": "Length of the blog excerpt",
        "type": "integer"
      },
      "blogDate": {
        "description": "Blog post publish date (YYYY-MM-DD)",
        "type": "string"
      },
      "blogRank": {
        "description": "Position in Naver's blog review list for this place",
        "type": "integer"
      },
      "blogReviewCount": {
        "description": "Linked blog/cafe review total for the place",
        "type": "integer"
      },
      "blogSource": {
        "description": "Source type: blog or cafe",
        "type": "string"
      },
      "blogThumbnailUrl": {
        "description": "Blog post thumbnail image URL",
        "type": "string"
      },
      "blogThumbnailUrls": {
        "description": "All blog post thumbnail image URLs",
        "type": "array"
      },
      "blogTitle": {
        "description": "Blog post title",
        "type": "string"
      },
      "blogTypeName": {
        "description": "Localized source label",
        "type": "string"
      },
      "blogUrl": {
        "description": "Link to the full blog post",
        "type": "string"
      },
      "bloggerHome": {
        "description": "Blogger's blog home URL",
        "type": "string"
      },
      "bloggerName": {
        "description": "Blogger name",
        "type": "string"
      },
      "bloggerProfileImageUrl": {
        "description": "Blogger profile image URL",
        "type": "string"
      },
      "hasReply": {
        "description": "True when the owner replied with text",
        "type": "boolean"
      },
      "imageReviewCount": {
        "description": "Number of reviews with images",
        "type": "integer"
      },
      "isRepresentative": {
        "description": "Whether Naver marks this blog post as representative",
        "type": "boolean"
      },
      "isSelfPaid": {
        "description": "Whether the blog review is marked as self-paid",
        "type": "boolean"
      },
      "language": {
        "description": "Review language code",
        "type": "string"
      },
      "mediaCount": {
        "description": "Number of photos and videos attached to the review",
        "type": "integer"
      },
      "menuItem": {
        "description": "Menu item mentioned in the review",
        "type": "string"
      },
      "originType": {
        "description": "Review origin, e.g. 영수증 for receipt-verified reviews",
        "type": "string"
      },
      "placeAddress": {
        "description": "Place street address",
        "type": "string"
      },
      "placeBlogReviewCount": {
        "description": "Total linked blog/cafe review count on the place",
        "type": "integer"
      },
      "placeBusinessCategory": {
        "description": "Naver business category, e.g. restaurant or cafe",
        "type": "string"
      },
      "placeCategory": {
        "description": "Place category (Korean)",
        "type": "string"
      },
      "placeId": {
        "description": "Naver Place ID",
        "type": "string"
      },
      "placeName": {
        "description": "Place name",
        "type": "string"
      },
      "placeRating": {
        "description": "Place-level average visitor review score",
        "type": "number"
      },
      "placeRoadAddress": {
        "description": "Place road address",
        "type": "string"
      },
      "placeTotalReviews": {
        "description": "Total visitor review count on the place",
        "type": "integer"
      },
      "placeUrl": {
        "description": "Canonical place URL",
        "type": "string"
      },
      "ratingDistribution": {
        "description": "Half-star distribution keyed 0.5 to 5.0",
        "type": "object"
      },
      "ratingReviewCount": {
        "description": "Rating-only visitor reviews",
        "type": "integer"
      },
      "replyStatus": {
        "description": "replied, no_reply, or unknown",
        "type": "string"
      },
      "reviewCreatedAt": {
        "description": "Review creation timestamp in ISO 8601 (KST)",
        "type": "string"
      },
      "reviewDate": {
        "description": "Review creation date (YYYY-MM-DD, KST)",
        "type": "string"
      },
      "reviewHasText": {
        "description": "False when the review is rating-only",
        "type": "boolean"
      },
      "reviewId": {
        "description": "Visitor review ID",
        "type": "string"
      },
      "reviewPhotos": {
        "description": "Photo and video-thumbnail URLs, when includeReviewPhotos is enabled",
        "type": "array"
      },
      "reviewRating": {
        "description": "Review star rating from 1 to 5, in 0.5 increments, when Naver exposes it; older anonymous reviews often omit it",
        "type": "number"
      },
      "reviewReactionCount": {
        "description": "Number of reactions on the review",
        "type": "integer"
      },
      "reviewReplyDate": {
        "description": "Owner reply date",
        "type": "string"
      },
      "reviewReplyText": {
        "description": "Business owner's reply to the review",
        "type": "string"
      },
      "reviewText": {
        "description": "Full review body (Korean), omitted for rating-only reviews",
        "type": "string"
      },
      "reviewThemes": {
        "description": "Theme labels with review counts",
        "type": "array"
      },
      "reviewType": {
        "description": "Record type: visitor, blog, or stats",
        "type": "string"
      },
      "reviewViewCount": {
        "description": "Number of views on the review",
        "type": "integer"
      },
      "reviewerAverageRating": {
        "description": "Reviewer's average rating across their reviews",
        "type": "number"
      },
      "reviewerFollowerCount": {
        "description": "Reviewer follower count",
        "type": "integer"
      },
      "reviewerImageUrl": {
        "description": "Reviewer profile image URL",
        "type": "string"
      },
      "reviewerName": {
        "description": "Reviewer nickname (masked by Naver)",
        "type": "string"
      },
      "reviewerProfileUrl": {
        "description": "Reviewer profile URL",
        "type": "string"
      },
      "reviewerReviewCount": {
        "description": "Total reviews authored by the reviewer",
        "type": "integer"
      },
      "runKeywordDistribution": {
        "description": "Voted-keyword counts across visitor reviews emitted for this place",
        "type": "array"
      },
      "runRatingDistribution": {
        "description": "Rating distribution across visitor reviews emitted for this place",
        "type": "object"
      },
      "scrapedAt": {
        "description": "ISO 8601 scrape timestamp",
        "type": "string"
      },
      "scrapedBlogReviews": {
        "description": "Blog reviews emitted for this place in this run",
        "type": "integer"
      },
      "scrapedVisitorReviews": {
        "description": "Visitor reviews emitted for this place in this run",
        "type": "integer"
      },
      "searchKeyword": {
        "description": "Keyword that discovered this place (keyword-search mode only)",
        "type": "string"
      },
      "searchRank": {
        "description": "1-based rank of the place in the keyword search result",
        "type": "integer"
      },
      "starDistribution": {
        "description": "Integer star distribution {5: n, 4: n, ...} when Naver supplies integer scores",
        "type": "object"
      },
      "textReviewCount": {
        "description": "Visitor reviews with written text",
        "type": "integer"
      },
      "topMenus": {
        "description": "Most-mentioned menu items with counts",
        "type": "array"
      },
      "totalReviewCount": {
        "description": "Total visitor review count from Naver stats",
        "type": "integer"
      },
      "totalVisitorReviews": {
        "description": "Total visitor reviews reported by Naver stats",
        "type": "integer"
      },
      "translatedText": {
        "description": "Auto-translated review text, when Naver provides it",
        "type": "string"
      },
      "visitCount": {
        "description": "Number of visits reported by the reviewer",
        "type": "integer"
      },
      "visitCountLabel": {
        "description": "Korean visit label, e.g. 2번째 방문",
        "type": "string"
      },
      "visitDate": {
        "description": "Actual visit date (YYYY-MM-DD)",
        "type": "string"
      },
      "visitTags": {
        "description": "Visit-context tags, e.g. 예약 없이 이용 or 혼자",
        "type": "array"
      },
      "votedKeywordStats": {
        "description": "Most-voted keyword tags with counts",
        "type": "array"
      },
      "votedKeywords": {
        "description": "Naver voted keyword tags, e.g. 음식이 맛있어요",
        "type": "array"
      }
    },
    "type": "object"
  },
  "title": "Naver Place Reviews + Blog",
  "views": {
    "overview": {
      "display": {
        "component": "table",
        "properties": {
          "blogDate": {
            "format": "text",
            "label": "Blog Date"
          },
          "blogTitle": {
            "format": "text",
            "label": "Blog Post"
          },
          "placeName": {
            "format": "text",
            "label": "Place"
          },
          "reviewRating": {
            "format": "number",
            "label": "Rating"
          },
          "reviewText": {
            "format": "text",
            "label": "Review"
          },
          "reviewType": {
            "format": "text",
            "label": "Type"
          },
          "searchKeyword": {
            "format": "text",
            "label": "Keyword"
          }
        }
      },
      "title": "Reviews Overview",
      "transformation": {
        "fields": [
          "reviewType",
          "placeName",
          "searchKeyword",
          "reviewRating",
          "reviewText",
          "blogTitle",
          "blogDate"
        ]
      }
    }
  }
}