scrapeunblocker 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fbe2fc1ce79fbf6b9293fe17403a6293599bf6cb04fe775d3596537a40fd5acb
-  data.tar.gz: 4b9dce4731d710996fe0796766bc67829d1cdd5753e6a812f3fc74796cdf7c48
+  metadata.gz: 2668bf966d35f46fd8c65d4d78cdc0d93d989a54b9d3f257f57e7924cc4ad6f6
+  data.tar.gz: 7ec5e5166b99712828dd771597ba0db89a09f398a1c5c0988af3256f077139f1
 SHA512:
-  metadata.gz: bca9218a5cee0b1bff9b9160860cc2d1cdd69e0b115abf3db35d449d005828e1f52099395f9d9ff0072ee4b509155cdc9088690d947a964179a3cb57823fffe2
-  data.tar.gz: 14a9b61b2f89d2bd23d2356a7fdc35fe16c075862251173aa29cb2463633705132f19f4f87a8e76e7dd637d7f955f23078151389007c0a6860f8b21bddc6a3a0
+  metadata.gz: 98330917b1ddce4f2d24f3938a97ce719ef84e31a712a3e774ac5d5821b1df164d8defd3984d4732d736f374f357701b59bae7b3a3154539b06543b92b8ecc5a
+  data.tar.gz: 0fb21ac2f6c04e979bb21415a9d393fd2853bdb1eb793e6ddf1d52cd9a38ab976d9ab403352f15bbe3b24ae64972c60df972942e231d85ff5e2ac805bf76bc34

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.5.0 (2026-09-17)
+
+- Added `google_images(q, ...)` for the new Google Images plugin (`POST /images/google-search`). Given a keyword `q` it returns Google Images results as a Hash - each with the full-size `imageUrl` and its `sourceDomain`, plus the source page URL, title, source name, thumbnail URL, pixel dimensions and file size. Optional `gl` (ISO-2 lowercase market), `max_results` (1-100) and `proxy_country` (ISO-2) refine the search.
+
+No breaking changes.
+
 ## 0.4.0 (2026-09-16)
 
 - Added `southwest.flights(origin:, dest:, depart_date:, ...)` for the new Southwest Airlines plugin (`POST /flights/southwest-quotes`), reached through the new `su.southwest` namespace and mirroring `su.skyscanner`. `origin` and `dest` are IATA airport codes; `depart_date` and the optional `return_date` are `YYYY-MM-DD` (omit `return_date` for a one-way search). Optional `adults` (1-8, default 1), `fare_type` (`"dollars"` default or `"points"`), `proxy_country` (default `"US"`) and `max_attempts` (1-5, default 3). Returns the raw booking / shopping JSON as a Hash.

data/README.md

@@ -128,6 +128,13 @@ local = su.google_local("coffee shops in chicago", proxy_country: "US", gl: "us"
 local["results"].each { |biz| puts "#{biz['name']} #{biz['rating']} #{biz['address']}" }
 ```
 
+## Google Images
+
+```ruby
+images = su.google_images("golden retriever puppy", proxy_country: "US", gl: "us")
+images["results"].each { |img| puts "#{img['imageUrl']} #{img['sourceDomain']} #{img['title']}" }
+```
+
 ## Meta Ad Library
 
 ```ruby

data/lib/scrapeunblocker/client.rb

@@ -106,6 +106,18 @@ module ScrapeUnblocker
                 keyword: keyword, proxy_country: proxy_country, hl: hl, gl: gl)
     end
 
+    # Search Google Images and return the image results as a Hash.
+    #
+    # Returns image results, each with the full-size +imageUrl+ and its
+    # +sourceDomain+, plus the source page URL, title, source name, thumbnail
+    # URL, pixel dimensions and file size. +q+ is the search keyword. Set
+    # +proxy_country+ (and optionally +gl+) to target a market, and
+    # +max_results+ (1-100) to cap the count.
+    def google_images(q, proxy_country: nil, gl: nil, max_results: nil)
+      post_json("/images/google-search",
+                q: q, gl: gl, max_results: max_results, proxy_country: proxy_country)
+    end
+
     # Fetch an advertiser's Meta (Facebook) Ad Library ads and return them as a Hash.
     #
     # +advertiser+ is the advertiser name or page to look up. Optional filters:

data/lib/scrapeunblocker/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: scrapeunblocker
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - ScrapeUnblocker
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-16 00:00:00.000000000 Z
+date: 2026-09-17 00:00:00.000000000 Z
 dependencies: []
 description: JS-rendered pages that bypass Cloudflare, DataDome, PerimeterX and Akamai,
   plus Google SERP and Skyscanner flights/hotels/car-hire scraping as JSON.