scrapeunblocker 0.15.0 → 0.15.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 873882960dc063a6f097269c0eabe1310fedcc29c207ce7c049dae4d22dada23
-  data.tar.gz: 6e14cfaa7afc02e1efc5934347b6ec91286a49beeb7daa7b85fa329afa0f0b41
+  metadata.gz: 3f62e1ad297dc0829c5aad20c1c09208595bb459b733b87d862c585fe64e12e5
+  data.tar.gz: 9ce26e1db98023c5373d90229f0f9545fc11f71f28ba143e82710305aab6a811
 SHA512:
-  metadata.gz: f1fecd1b6ad4b3027a96f2d87e53c9935cca6c2071403c4a9175f032e00cf7e5fc439307515d305b5e814013dcde6d04c77682c9500955a8262c341d7b13417c
-  data.tar.gz: 05362a2204cd66d3fb1bde32486547c5b300a5c2f3d6a9082ad9e583bde3de13c08f98b04576aaddb2ea877ee48c9602f2ba76fb0c1cdca26050ed71859d0555
+  metadata.gz: 150e385abf9ae36cde1653f4c411ab43d3735f6267fb6c8aab24d43caf37aa3da4dd8c7f6833dd6b207f45b374d01e6112f4a27e4a7007b4bcba2c812ce83b3e
+  data.tar.gz: 2a7c1c9b01e7821b80dfd590e650a2766b56ecccaa28ae16c1b219f6ce2022d7b4d33c2108e33eed17319f794e9c052dbe6977a00964a201b15853fdadeefbf2

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 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/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
@@ -4733,7 +4744,7 @@ module ScrapeUnblocker
     # @param video [String] Video id (dQw4w9WgXcQ) or any YouTube video URL.
     # @param lang [String] Preferred caption language code, e.g. 'en'. Omit for the
     # default/first track. A prefix like 'en' matches 'en-US'.
-    # @param format [String] Output shape: text, segments. 'segments' returns timestamps; 'text'
+    # @param format [String] Output shape: segments, text. 'segments' returns timestamps; 'text'
     # returns only the joined plaintext. API default: segments.
     # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
     # 'DE') for the watch page. Defaults to US.

data/lib/scrapeunblocker/version.rb

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

metadata

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