scrapeunblocker 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4542500ec21bf7ce42e644394bf9302b74399a5447f6f5717e3f6abeaf8e7cb4
-  data.tar.gz: 92470e75374896eb308d3f7f939f39dcecb210aeaff4fa151aa8b0df8c516a95
+  metadata.gz: 2668bf966d35f46fd8c65d4d78cdc0d93d989a54b9d3f257f57e7924cc4ad6f6
+  data.tar.gz: 7ec5e5166b99712828dd771597ba0db89a09f398a1c5c0988af3256f077139f1
 SHA512:
-  metadata.gz: 672b0d182dc35e5650102171465dadf60f6bd22890a3d000b6e0a82a5e9b137b8857d1fac1231013af24eefd4b782e883db83423fca436b47aec1183af4c6b45
-  data.tar.gz: 75f9249d01b7d1b6aa6e2ef0c373ec386cee41d5cd7e42fefceff65aa74d4992aaa036067e67f24be0e11e2ee89f705942975a863c8f0dba707cc5bf4f01b1a3
+  metadata.gz: 98330917b1ddce4f2d24f3938a97ce719ef84e31a712a3e774ac5d5821b1df164d8defd3984d4732d736f374f357701b59bae7b3a3154539b06543b92b8ecc5a
+  data.tar.gz: 0fb21ac2f6c04e979bb21415a9d393fd2853bdb1eb793e6ddf1d52cd9a38ab976d9ab403352f15bbe3b24ae64972c60df972942e231d85ff5e2ac805bf76bc34

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # 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.
+
+No breaking changes.
+
 ## 0.3.0 (2026-09-08)
 
 - Added `tiktok_profile`, `tiktok_video`, `tiktok_hashtag`, `tiktok_search` and `tiktok_comments` for the new TikTok plugin: a creator's exact follower / like / video counts with their newest videos (up to 200), any video or photo post with exact plays, likes, comments, shares, saves and reposts, hashtags, music, play / download URLs, subtitle tracks and an optional transcript, a hashtag's total views and videos with its videos, keyword search in TikTok's own ranking, and the comments of any post. No login.

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
@@ -223,6 +230,25 @@ hotels = su.skyscanner.hotels(destination: "Madrid", checkin: "2026-09-01", chec
 cars = su.skyscanner.carhire(pickup: "Madrid", pickup_datetime: "2026-09-01T10:00", dropoff_datetime: "2026-09-03T10:00")
 ```
 
+## Southwest plugin
+
+Southwest Airlines flight quotes as JSON. `origin` and `dest` are IATA airport codes; omit `return_date` for a one-way search.
+
+```ruby
+flights = su.southwest.flights(
+  origin: "DAL", dest: "HOU",
+  depart_date: "2026-10-20", return_date: "2026-10-27"
+)
+
+# One-way, priced in Rapid Rewards points
+oneway = su.southwest.flights(
+  origin: "DAL", dest: "HOU",
+  depart_date: "2026-10-20", adults: 2, fare_type: "points"
+)
+```
+
+`adults` is 1-8 (default 1), `fare_type` is `"dollars"` (default) or `"points"`, `proxy_country` defaults to `"US"` and `max_attempts` is 1-5 (default 3). The call returns the raw booking / shopping JSON.
+
 ## Error handling
 
 Non-2xx responses raise typed errors, all subclasses of `ScrapeUnblocker::Error`.

data/lib/scrapeunblocker/client.rb

@@ -7,6 +7,7 @@ require "json"
 require_relative "errors"
 require_relative "parsed_page"
 require_relative "skyscanner"
+require_relative "southwest"
 require_relative "version"
 
 module ScrapeUnblocker
@@ -22,6 +23,9 @@ module ScrapeUnblocker
     # @return [Skyscanner] the Skyscanner plugin endpoints
     attr_reader :skyscanner
 
+    # @return [Southwest] the Southwest Airlines plugin endpoints
+    attr_reader :southwest
+
     def initialize(api_key: nil, base_url: DEFAULT_BASE_URL, timeout: 180, max_retries: 2, transport: nil)
       @api_key = api_key || ENV["SCRAPEUNBLOCKER_KEY"]
       if @api_key.nil? || @api_key.empty?
@@ -34,6 +38,7 @@ module ScrapeUnblocker
       @max_retries = max_retries
       @transport = transport || method(:net_http_transport)
       @skyscanner = Skyscanner.new(self)
+      @southwest = Southwest.new(self)
     end
 
     # Fetch a URL and return the fully rendered HTML.
@@ -101,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/southwest.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module ScrapeUnblocker
+  # Southwest Airlines plugin endpoints (flights).
+  class Southwest
+    # @api private
+    def initialize(client)
+      @client = client
+    end
+
+    # Fetch Southwest Airlines flight quotes and return the raw booking JSON.
+    #
+    # +origin+ and +dest+ are IATA airport codes (e.g. "DAL", "HOU").
+    # +depart_date+ (and the optional +return_date+) are "YYYY-MM-DD"; omit
+    # +return_date+ for a one-way search. +adults+ is 1-8. +fare_type+ is
+    # "dollars" (default) or "points". +proxy_country+ pins the exit (default
+    # "US"). +max_attempts+ is 1-5.
+    def flights(origin:, dest:, depart_date:, return_date: nil, adults: 1,
+                fare_type: "dollars", proxy_country: "US", max_attempts: 3)
+      @client.post_json("/flights/southwest-quotes",
+                        origin: origin, dest: dest, depart_date: depart_date,
+                        return_date: return_date, adults: adults,
+                        fare_type: fare_type, proxy_country: proxy_country,
+                        max_attempts: max_attempts)
+    end
+  end
+end

data/lib/scrapeunblocker/version.rb

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

data/lib/scrapeunblocker.rb

@@ -4,6 +4,7 @@ require_relative "scrapeunblocker/version"
 require_relative "scrapeunblocker/errors"
 require_relative "scrapeunblocker/parsed_page"
 require_relative "scrapeunblocker/skyscanner"
+require_relative "scrapeunblocker/southwest"
 require_relative "scrapeunblocker/client"
 
 # Official Ruby client for the ScrapeUnblocker web scraping API.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: scrapeunblocker
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - ScrapeUnblocker
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-08 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.
@@ -26,6 +26,7 @@ files:
 - lib/scrapeunblocker/errors.rb
 - lib/scrapeunblocker/parsed_page.rb
 - lib/scrapeunblocker/skyscanner.rb
+- lib/scrapeunblocker/southwest.rb
 - lib/scrapeunblocker/version.rb
 homepage: https://scrapeunblocker.com?utm_source=rubygems&utm_medium=integration&utm_campaign=ruby-sdk
 licenses: