scrapeunblocker 0.11.1 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9bd6d663c941e4d49cc8c8b7446f15c2c4cff0ac7025e85144dd72706ac24220
-  data.tar.gz: 68949c187f57eb403d1f890a236fd9caa671beeaf395225c8100d4da22ce8fac
+  metadata.gz: 9349609e20a6b8949d1cc3d77b919cf6c916b4b1917d181bb2d18ec441f46777
+  data.tar.gz: 55bf0f292146e6e166a502ecb43a33d15b2629261f808ed8754f4ca7a33d96fe
 SHA512:
-  metadata.gz: b6c58655e6ea4657b358e0edf1c147226d2fdbb5b55b64a18b88f3f5b5d821b58b78ef29ccb2f505554998c6ef9e8183afa45f5dcf01fcf9f9eb3fb5dea28d75
-  data.tar.gz: 8ab2b5635e0b7edc16bfd1202e92ed24e0a189a115d2f37ea26e2c21c9b7780e5f9f942a50edda29cdb6645e2b7a61228bcea014abe08c44f20f5565f31f1057
+  metadata.gz: 22da248af5842639758605b333930c888534405b796cd199f9c8a2c8bced4104e6dace474c62fbaa2aa878d321878aef3118121fb0563efc4f25a1d2c00451b6
+  data.tar.gz: 3fea75e8eb0602eb156978c019fea92fe7cfca41aab0714f9049412d26207e707899750ad8547b0caf57d3da368d347d2f2ead34e82d74ee2d4764de5f90afb9

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.12.0 (2026-10-15)
+
+- `google_images` takes `time_range:` (`"hour"`, `"day"`, `"week"`, `"month"` or `"year"`) to return only the images Google found in that recent period, so a query scanned on a schedule returns only what is new. For a fixed window pass `date_from:` and/or `date_to:` (`"YYYY-MM-DD"`) instead; the API answers 400 when `time_range` is combined with either.
+
+No breaking changes.
+
 ## 0.11.1 (2026-10-15)
 
 - `get_image` docs: the API now returns the image's original bytes and format (JPEG, PNG, WebP, AVIF, GIF, SVG, ...) instead of a PNG re-encode. The method still returns a binary `String`.

data/README.md

@@ -174,8 +174,15 @@ local["results"].each { |biz| puts "#{biz['name']} #{biz['rating']} #{biz['addre
 ```ruby
 images = su.google_images("golden retriever puppy", proxy_country: "US", pages: 3)
 images["results"].each { |img| puts "#{img['imageUrl']} #{img['sourceDomain']} #{img['title']}" }
+
+# Only images Google found in the last day (for a daily scan of the same query)
+new_images = su.google_images("eiffel tower", proxy_country: "US", time_range: "day")
+# Or a fixed window: date_from / date_to (YYYY-MM-DD), each one optional
+october = su.google_images("eiffel tower", date_from: "2026-10-01", date_to: "2026-10-07")
 ```
 
+`time_range` takes `hour`, `day`, `week`, `month` or `year` and cannot be combined with `date_from` / `date_to`.
+
 ## Meta Ad Library
 
 ```ruby

data/lib/scrapeunblocker/client.rb

@@ -126,10 +126,16 @@ module ScrapeUnblocker
     # +proxy_country+ to target a market (the Google market follows it; +gl+
     # is an optional override), +pages+ (1-5, ~100 results each; each page
     # fetched is billed as one request, see +pagesFetched+) and +max_results+
-    # (1-500) to cap the count.
-    def google_images(q, proxy_country: nil, pages: nil, gl: nil, max_results: nil)
+    # (1-500) to cap the count. +time_range+ ("hour", "day", "week", "month",
+    # "year") keeps only the images Google found in that recent period, e.g.
+    # the new ones since the last scheduled scan; +date_from+ / +date_to+
+    # ("YYYY-MM-DD", each optional) set a fixed window instead. The two forms
+    # cannot be combined.
+    def google_images(q, proxy_country: nil, pages: nil, gl: nil, max_results: nil,
+                      time_range: nil, date_from: nil, date_to: nil)
       post_json("/images/google-search",
-                q: q, pages: pages, gl: gl, max_results: max_results, proxy_country: proxy_country)
+                q: q, pages: pages, gl: gl, max_results: max_results, proxy_country: proxy_country,
+                time_range: time_range, date_from: date_from, date_to: date_to)
     end
 
     # Fetch an advertiser's Meta (Facebook) Ad Library ads and return them as a Hash.

data/lib/scrapeunblocker/version.rb

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

metadata

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