scrapeunblocker 0.10.0 → 0.10.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3ffe8b5253c990d2b8f3754b32da58cd5a74150513c5592606dcc70c24d98e6c
-  data.tar.gz: a086e3553aeb1fd48bd57884a2315adfbe92b55763277298db932365b42c44bf
+  metadata.gz: 14be9ee13840a5574c9924bf39c16b15ecf05c7e4cde02091840034013474c90
+  data.tar.gz: e915ed083458bad3fcc0bdbf1be03347052582a97f8e0955daa86ede3b535eff
 SHA512:
-  metadata.gz: 2c0efc8818178442559f1d4ee6ab1e1fe16938e5f5f3c4371eae0506a6ec5d498df37345e726d26293807be62783051bf5824510cb23b3099fa6eb44cdb54b44
-  data.tar.gz: 15d718a1db74279f32f17bfbfda2034987f411e61514c15c122567115edcabb3849dcbeae4ed1fbe9e94e1c913ac6997eea1c638ba2c645d93ef618ea234562e
+  metadata.gz: 5d9ccb478cbf809a1c747b578946a08e0fb30a0e8d968d5eda0cd8389f7c572825e37772c1f0ec590b8ba618d47748262de8a65c773e8fa0ade262b0cb75d471
+  data.tar.gz: c43112450a0ffebabf538bb3a0cb50d2a74be3c0de0712f8e138a34d226b8eb7710f6e9b78560280412d2001e7860439ef3c1d1975559f67519df0bb6d838262

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.10.1 (2026-10-13)
+
+- `tiktok_shop_search` takes its keyword as optional, so a category-only search works (`category` option).
+- `aldi_au_specials` takes `category`: a Special Buys drop date such as `2026-10-14`.
+- `capterra_search` no longer offers `page` and `app_store_reviews` no longer offers `lang`; the API ignored both for those calls.
+- Method docs say "proxy country" where they said "exit-IP country", and drop internal routing notes.
+
 ## 0.10.0 (2026-10-13)
 
 - 104 new plugin methods on `ScrapeUnblocker::Client`, one for every public plugin endpoint: e-commerce (Walmart, Target, Best Buy, Home Depot, Etsy, Temu, SHEIN, Zalando, AliExpress, Alibaba, 1688, TikTok Shop, Amazon Best Sellers and reviews), groceries (Woolworths, Coles, ALDI Australia), travel (Booking.com reviews, Airbnb listings and reviews, Tripadvisor), Google (Trends, Shopping, Jobs, Maps place details), Bing / DuckDuckGo / Yahoo / Brave search and images, real estate (Zillow, Redfin, Rightmove, Idealista, ImmobilienScout24), vehicles (mobile.de, AutoScout24), jobs (Indeed, Glassdoor, Naukri, Wellfound, company career sites), reviews and companies (Trustpilot, G2, Capterra, Product Hunt, Crunchbase), Yelp, Naver Place, Google Play, the App Store, YouTube, Spotify, Telegram, Quora, Similarweb, Ahrefs and Semrush. The README lists them by category; every parameter is on the docs plugin pages.

data/lib/scrapeunblocker/client.rb

@@ -151,7 +151,7 @@ module ScrapeUnblocker
     # originalPrice, priceCny, monthSold, image and url. +channel+ is one of
     # "1688" (default), "taobao" or "official"; +sort+ is one of "default",
     # "price_asc", "price_desc" or "best_selling". +page_size+ max is 60.
-    # Brand keywords return HTTP 422.
+    # A brand keyword returns 200 with keywordRejected = true and no products.
     def oopbuy_search(keyword, channel: "1688", page: 1, page_size: 20, sort: "default", proxy_country: nil)
       post_json("/goods/oopbuy-search",
                 keyword: keyword, channel: channel, page: page,
@@ -192,7 +192,7 @@ module ScrapeUnblocker
     # availability, rating, review count, seller, feature bullets, categories
     # and images. Prices come back in the marketplace's own currency:
     # +proxy_country+ defaults to the marketplace's home country
-    # (amazon.com -> US), pinning the exit over the ISP pool. Pass either
+    # (amazon.com -> US). Pass either
     # +asin+ (with +marketplace+) or a full product +url+.
     def amazon_product(asin: nil, url: nil, marketplace: "amazon.com", proxy_country: nil)
       post_json("/marketplace/amazon-product",

data/lib/scrapeunblocker/plugins.rb

@@ -554,7 +554,7 @@ module ScrapeUnblocker
     # @param max_results [Integer] Products to return (1-30). One page is read: a keyword lists
     # up to 30 products, a category about 15. API default: 30.
     # Calls POST /social/tiktok-shop-search.
-    def tiktok_shop_search(q, category: nil, max_results: nil)
+    def tiktok_shop_search(q = nil, category: nil, max_results: nil)
       post_json("/social/tiktok-shop-search", {
         q: q,
         category: category,
@@ -1080,6 +1080,11 @@ module ScrapeUnblocker
     # prices in AUD (ALDI Australia does not sell groceries online). Listings collect up to
     # `max_results` from `page` on, billed one unit per page.
     #
+    # @param category [String] mode=category: a category link
+    # (https://www.aldi.com.au/products/dairy-eggs-fridge/milk/k/1111111160) or its key
+    # ('1111111160'; '1588161425841179' = Lower Prices). mode=specials: the Special Buys drop -
+    # its date ('2026-10-14') or link (https://www.aldi.com.au/special-buys/2026-10-14); blank =
+    # the current drop.
     # @param theme [String] mode=specials: one theme of the drop, e.g. 'Gardening' (see
     # `promotions[].themes`).
     # @param sort [String] Listing order: relevance, price_asc, price_desc, name_asc, name_desc.
@@ -1091,9 +1096,10 @@ module ScrapeUnblocker
     # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'AU',
     # 'US'). Leave blank: ALDI answers every country, so the load spreads over all exits.
     # Calls POST /groceries/aldi-au.
-    def aldi_au_specials(theme: nil, sort: nil, page: nil, max_results: nil, proxy_country: nil)
+    def aldi_au_specials(category: nil, theme: nil, sort: nil, page: nil, max_results: nil, proxy_country: nil)
       post_json("/groceries/aldi-au", {
         mode: "specials",
+        category: category,
         theme: theme,
         sort: sort,
         page: page,
@@ -2757,20 +2763,16 @@ module ScrapeUnblocker
     # avoids it. Billed one unit per page fetched (`pagesFetched`).
     #
     # @param query [String] Product name or keyword to search for (mode=search), e.g. 'crm'.
-    # @param page [Integer] 1-based review page to start from: 25 reviews per page, at most 100
-    # (Capterra's limit per product). Use the `nextPage` of a previous response to continue. API
-    # default: 1.
     # @param max_results [Integer] How many reviews to collect across pages (1-500, default 25);
     # each page fetched is one billed unit. With mode=search, how many products (1-20, default
     # 20; one page).
     # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
     # 'DE'). Leave blank for the country chosen for the site.
     # Calls POST /reviews/capterra.
-    def capterra_search(query, page: nil, max_results: nil, proxy_country: nil)
+    def capterra_search(query, max_results: nil, proxy_country: nil)
       post_json("/reviews/capterra", {
         mode: "search",
         query: query,
-        page: page,
         max_results: max_results,
         proxy_country: proxy_country,
       })
@@ -3227,8 +3229,6 @@ module ScrapeUnblocker
     # ('net.whatsapp.WhatsApp').
     # @param country [String] App Store country (ISO-2), e.g. 'us', 'gb', 'de'. Prices, ratings
     # and reviews are per country. Default: the country in an app URL, else 'us'.
-    # @param lang [String] Listing language for mode=app / mode=search, e.g. 'fr' or 'fr-CA'
-    # (for countries whose store has several languages). Default: the store's own.
     # @param max_results [Integer] mode=search: apps to return (1-200). mode=reviews: reviews to
     # collect (1-500); Apple serves 50 per page and at most 10 pages per country, each page
     # billed as one request. API default: 50.
@@ -3240,12 +3240,11 @@ module ScrapeUnblocker
     # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
     # 'DE'). Leave blank to let the API pick.
     # Calls POST /apps/app-store.
-    def app_store_reviews(app_id, country: nil, lang: nil, max_results: nil, sort: nil, page: nil, proxy_country: nil)
+    def app_store_reviews(app_id, country: nil, max_results: nil, sort: nil, page: nil, proxy_country: nil)
       post_json("/apps/app-store", {
         mode: "reviews",
         app_id: app_id,
         country: country,
-        lang: lang,
         max_results: max_results,
         sort: sort,
         page: page,

data/lib/scrapeunblocker/version.rb

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

metadata

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