scrapeunblocker 0.15.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 873882960dc063a6f097269c0eabe1310fedcc29c207ce7c049dae4d22dada23
-  data.tar.gz: 6e14cfaa7afc02e1efc5934347b6ec91286a49beeb7daa7b85fa329afa0f0b41
+  metadata.gz: 28020ffea6eb49ad4418747a5f2fa7c4a55c0aa7b98fbc73abb1ad433bb9c0e5
+  data.tar.gz: 57624c5f914ef34100ef24788abe751d6844c68a2deda593075e2d032a6e93c1
 SHA512:
-  metadata.gz: f1fecd1b6ad4b3027a96f2d87e53c9935cca6c2071403c4a9175f032e00cf7e5fc439307515d305b5e814013dcde6d04c77682c9500955a8262c341d7b13417c
-  data.tar.gz: 05362a2204cd66d3fb1bde32486547c5b300a5c2f3d6a9082ad9e583bde3de13c08f98b04576aaddb2ea877ee48c9602f2ba76fb0c1cdca26050ed71859d0555
+  metadata.gz: a8710aac0acb04703254f1358abf8ea9f1096d6392232772730c6c4d95f06c8271784db5c6cbbad4c22ac1ddd2be09db35acf0bba3ac5332b2e9ebbdf6fb8651
+  data.tar.gz: 5e720ee147514e819bc97b33c8187784c9797dfbb6304ed9577c5e916039ca84561c2376eb669a0b946976fb6463c89a34fdeb8b3889c6c1c8340cd7e1ae1bab

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.16.0 (2026-10-29)
+
+- Add `maps_reviews`: Google Maps reviews of a place in Google's sort orders (relevant, newest, highest, lowest) with exact ISO dates, original and translated text, authors, photos, owner replies and page tokens. `POST /maps/reviews`.
+
+## 0.15.1 (2026-10-29)
+
+- `shopee_product` and `shopee_search` docs: describe `availability` and `inStock`, sold-out variations (`models[].available`, `tierIndex`), `categories` as the breadcrumb path plus `browseCategories`, `isPixPrice` (Brazilian Pix prices) and the JSON `{"status": "not_found", ...}` answer for a product that does not exist. Signatures are unchanged.
+
 ## 0.15.0 (2026-10-29)
 
 - 23 new plugin methods on `Client`:

data/README.md

@@ -149,7 +149,7 @@ jobs = su.career_site_jobs("https://jobs.ashbyhq.com/ramp", keyword: "engineer")
 | Category | Methods |
 | --- | --- |
 | Travel | `skyscanner.flights`, `skyscanner.hotels`, `skyscanner.carhire`, `booking_hotels`, `booking_reviews`, `airbnb_search`, `airbnb_room`, `airbnb_reviews`, `tripadvisor_list`, `tripadvisor_reviews` |
-| Google | `google_local`, `google_images`, `maps_place_details`, `google_trends`, `google_shopping`, `google_jobs`, `google_hotels`, `google_hotels_property`, `google_news`, `google_ads_transparency`, `google_ads_transparency_advertisers`, `google_ai_mode`, `google_lens` |
+| Google | `google_local`, `google_images`, `maps_place_details`, `maps_reviews`, `google_trends`, `google_shopping`, `google_jobs`, `google_hotels`, `google_hotels_property`, `google_news`, `google_ads_transparency`, `google_ads_transparency_advertisers`, `google_ai_mode`, `google_lens` |
 | AI | `gemini` |
 | Search engines | `bing_search`, `bing_images`, `duckduckgo_search`, `yahoo_search`, `yahoo_images`, `brave_search`, `brave_images` |
 | E-commerce | `amazon_product`, `amazon_search`, `amazon_bestsellers`, `amazon_reviews`, `amazon_offers`, `amazon_seller`, `walmart_search`, `target_search`, `bestbuy_search`, `homedepot_search`, `costco_search`, `costco_product`, `etsy_search`, `shein_search`, `zalando_search`, `aliexpress_search`, `alibaba_search`, `alibaba_product`, `alibaba1688_search`, `alibaba1688_product`, `tiktok_shop_search`, `tiktok_shop_product`, `tiktok_shop_store`, `oopbuy_search`, `smyths_inventory`, `smyths_details`, `smyths_search`, `smyths_category`, `wish_search`, `wish_product`, `shopee_search`, `shopee_product`, `taobao_search`, `taobao_product`, `flipkart_search`, `flipkart_product`, `lazada_search`, `lazada_product`, `allegro_search`, `allegro_product`, `falabella_search`, `falabella_product`, `magazineluiza_search`, `magazineluiza_product` |

data/lib/scrapeunblocker/plugins.rb

@@ -793,15 +793,18 @@ module ScrapeUnblocker
     # Searches a Shopee market (Singapore, Indonesia, Malaysia, Thailand, Vietnam, Philippines,
     # Taiwan or Brazil - `country`) for `q` and returns one page of results: up to 40
     # `products`, each with `position`, `itemId`, `shopId`, `name`, `url`, `image`, `price`,
-    # `originalPrice` (when Shopee shows the crossed-out price), `discountPercent`, `currency`,
-    # `rating` (average stars), `location` (where the seller ships from) and `labels` (promotion
-    # badges). `sort` orders the results, `min_price` / `max_price` filter them, `shop_id` keeps
-    # one shop's products (or lists the shop without `q`), and `url` takes a Shopee search or
-    # category link instead. Shopee shows one page per search, so run several sort orders or
-    # price ranges for more products. `price` is what Shopee shows a signed-out shopper, which
-    # can be a promotional or new-customer price (see `labels`). Not available: stock, units
-    # sold, rating counts and reviews (Shopee does not publish them on the pages these endpoints
-    # read). One unit per call.
+    # `originalPrice` (when Shopee shows the crossed-out price), `discountPercent`,
+    # `isPixPrice`, `currency`, `rating` (average stars), `location` (where the seller ships
+    # from) and `labels` (promotion badges). `sort` orders the results, `min_price` /
+    # `max_price` filter them, `shop_id` keeps one shop's products (or lists the shop without
+    # `q`), and `url` takes a Shopee search or category link instead. Shopee shows one page per
+    # search, so run several sort orders or price ranges for more products. `price` is what
+    # Shopee shows a signed-out shopper, which can be a promotional or new-customer price (see
+    # `labels`). In Brazil a card often shows the Pix price (`isPixPrice: true`): `price` is
+    # then the Pix price and `discountPercent` is measured against the list price, which Shopee
+    # does not show on such a card, so `originalPrice` is null. Not available: per-variation
+    # prices, stock counts, units sold, rating counts and reviews (Shopee does not publish them
+    # on the pages these endpoints read). One unit per call.
     #
     # @param q [String] What to search for, e.g. 'iphone case' or 'air fryer'. Optional with
     # `shop_id`.
@@ -841,14 +844,22 @@ module ScrapeUnblocker
     # (average stars), `labels`, `images`, `shopLocation` and `shop` (`name`, `username`, `url`,
     # `rating`, `ratingCount`, `followers`, `itemCount`, `responseRatePercent`,
     # `isOfficialShop`, `isPreferredPlusSeller`, `location`, `joinedAt`). With `dataLevel: full`
-    # it also has `description`, `brand`, `condition`, `categories`, `videos`, `variations`
-    # (option names), `models` (`modelId`, `name`), `attributes`, `isOfficialShop`,
-    # `isPreOrder`, `estimatedShippingDays` and `createdAt`; `dataLevel: meta` means Shopee
-    # showed only the product's title and main image (some markets), with price, rating and shop
-    # still included. `price` is what Shopee shows a signed-out shopper, which can be a
-    # promotional or new-customer price (see `labels`). Not available: stock, units sold, rating
-    # counts and reviews (Shopee does not publish them on the pages these endpoints read). One
-    # unit per call.
+    # it also has `availability` (`in_stock`, `sold_out` or `unavailable` for a withdrawn
+    # listing) and `inStock`, `description`, `brand`, `condition`, `categories` (the path the
+    # product page's breadcrumb shows, with ids), `browseCategories` (the browse tree, whose ids
+    # Shopee's category links use), `videos`, `variations` (option names), `models` (`modelId`,
+    # `name`, `available` - false for a sold-out variation - and `tierIndex`, the model's option
+    # in each variation), `attributes`, `isOfficialShop`, `isPreOrder`, `estimatedShippingDays`
+    # and `createdAt`; `dataLevel: meta` means Shopee showed only the product's title and main
+    # image (some markets), with price, rating and shop still included. A product Shopee says
+    # does not exist (removed, or never existed) answers 404 with JSON `{"status": "not_found",
+    # ...}`; a 502 means the call could not get an answer from Shopee and can be retried.
+    # `price` is what Shopee shows a signed-out shopper, which can be a promotional or new-
+    # customer price (see `labels`). In Brazil a card often shows the Pix price (`isPixPrice:
+    # true`): `price` is then the Pix price and `discountPercent` is measured against the list
+    # price, which Shopee does not show on such a card, so `originalPrice` is null. Not
+    # available: per-variation prices, stock counts, units sold, rating counts and reviews
+    # (Shopee does not publish them on the pages these endpoints read). One unit per call.
     #
     # @param url [String] A Shopee product link, e.g. https://shopee.sg/Beats-
     # iPhone-17-Case-i.442800909.40270108836 or
@@ -2627,6 +2638,51 @@ module ScrapeUnblocker
       })
     end
 
+    # Scrape Google Maps reviews.
+    #
+    # Returns one Google Maps place's reviews as JSON, sorted the way Google sorts them:
+    # `relevant`, `newest`, `highest` or `lowest`. Each review has `rating` (1-5), `date` (exact
+    # ISO 8601, UTC) + `timestamp`, `relativeDate`, `text` (original) + `language`,
+    # `translatedText` (into `hl`, when the review is in another language), `author`, `photos`,
+    # `details` (guided answers such as 'Rooms: 5'), `ownerResponse` and `reviewUrl`. The answer
+    # also carries a `place` summary and `nextPageToken` for paging. Identify the place with
+    # `feature_id` (0xHEX:0xHEX), `place_id` (ChIJ...) or a Maps `url`. Reviews come in pages of
+    # 20; each page fetched is one billed unit.
+    #
+    # @param url [String] A Google Maps place URL (share link or /maps/place/... URL). The
+    # feature id or place_id is read out of it.
+    # @param place_id [String] A Google place_id, e.g. 'ChIJN1t_tDeuEmsRUsoyG83frY4'.
+    # @param feature_id [String] A Maps feature id '0xHEX:0xHEX', e.g.
+    # '0x4776901a5d4813b3:0x2a497c8b414893c'. Fastest - no resolve step.
+    # @param sort [String] Review order: 'relevant' (Google's default), 'newest', 'highest' or
+    # 'lowest'. SerpApi's 'qualityScore', 'newestFirst', 'ratingHigh' and 'ratingLow' are
+    # accepted too. API default: relevant.
+    # @param max_reviews [Integer] How many reviews to return, 1-200. Reviews come in pages of
+    # 20; each page fetched is one billed unit. API default: 20.
+    # @param next_page_token [String] Continue from a previous answer's `nextPageToken` (same
+    # place and sort). When `max_reviews` is not a multiple of 20 the next page can repeat a few
+    # reviews - dedupe on `reviewId`.
+    # @param hl [String] Language for Google's labels and the review translation
+    # (`translatedText`), e.g. 'en', 'de'. The original text is always returned in `text`. API
+    # default: en.
+    # @param gl [String] Google country, ISO-2 lowercase, e.g. 'us'. API default: us.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Reviews are the same from any country. API default: us.
+    # Calls POST /maps/reviews.
+    def maps_reviews(url: nil, place_id: nil, feature_id: nil, sort: nil, max_reviews: nil, next_page_token: nil, hl: nil, gl: nil, proxy_country: nil)
+      post_json("/maps/reviews", {
+        url: url,
+        place_id: place_id,
+        feature_id: feature_id,
+        sort: sort,
+        max_reviews: max_reviews,
+        next_page_token: next_page_token,
+        hl: hl,
+        gl: gl,
+        proxy_country: proxy_country,
+      })
+    end
+
     # Scrape Google Hotels search results (prices, ratings, amenities).
     #
     # Runs a Google Hotels search for `q` and returns the properties as JSON: `name`, `type`

data/lib/scrapeunblocker/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ScrapeUnblocker
-  VERSION = "0.15.0"
+  VERSION = "0.16.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: scrapeunblocker
 version: !ruby/object:Gem::Version
-  version: 0.15.0
+  version: 0.16.0
 platform: ruby
 authors:
 - ScrapeUnblocker