scrapeunblocker 0.1.7 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab6bd524121d205b90ef9cabe0315d1185772ee313a6e40d1bf9057dad3b535b
-  data.tar.gz: 82bc7674e38f9bfa125320956e440a66ad535d3aac8ac923e086d0b0ec3fcba2
+  metadata.gz: '038dc9fc1bd496b441430ed4f1def53055dfb98db2cf21d40ec0242bcd66f344'
+  data.tar.gz: d8fb2745df9da6ac37db17308670f87b1c4131e2b9dfde9e5107ee4fe9e9c260
 SHA512:
-  metadata.gz: 7d8ecc218ec1814f6cdca5681e156488b43302a935a7e8c8fe3d2d73cd98f45558c979c555c33c03db0a43e5a8cf440d2edc8d3b259854844ee7cf9083399fa3
-  data.tar.gz: ad8a15c080c559e9d6d5927351e8336788266a65f07971c0c49c41e69ffbee98b8a3d2a661c62d325365d9abdd716b08241a3afbe1a8a2f47234da48d162894e
+  metadata.gz: ebc1b6eec94316dfb50c56b6109212eaaec54e5b8a0087f8e11f9cc9c634c751c1fed8bafe0bad51d8cf45ba5cd4d978f46feb40fb9c0d64de18aee98712ec46
+  data.tar.gz: 444e12bb48cfcf2e3b1cee4d76676c4334d234cb76a8642917845e4ac3b9a179786abac31c77e7251cf2eca95c1bf3e16ae12d4ace9c6aa131581617d01c12ad

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.1.8 (2026-07-31)
+
+- Added `ebay_search` for the new eBay Search plugin: listings from any of the 19 regional eBay marketplaces as structured JSON - title, numeric price and currency, condition with a normalised `conditionCode`, seller username and feedback, shipping cost, sold/watcher/bid counts, image and a clean item URL.
+- Filters map straight onto the plugin: `marketplace`, `condition`, `sort`, `listing_type`, `min_price`/`max_price`, `free_shipping`, `seller`, `category`, plus `page`/`page_size` (60, 120 or 240).
+- The response carries `exactMatches`; it is `false` when eBay found no match for the keyword and answered with its own loosely-related suggestions.
+
+No breaking changes.
+
 ## 0.1.7 (2026-07-27)
 
 - Registry and README links to scrapeunblocker.com now carry UTM parameters so traffic from package registries is attributable. No functional changes.

data/README.md

@@ -96,6 +96,20 @@ goods["results"].each { |item| puts "#{item['title']} #{item['price']} #{item['u
 
 `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. Oopbuy trademark-blocks brand keywords at its own backend: those come back as a successful `200` with `keywordRejected: true` and an empty `results` array, not an error.
 
+## eBay search
+
+```ruby
+items = su.ebay_search("iphone 13", marketplace: "ebay.com", condition: "used", sort: "newly_listed")
+
+if items["exactMatches"]
+  items["results"].each do |item|
+    puts [item["title"], item["price"], item["currency"], item["condition"]].join(" | ")
+  end
+end
+```
+
+`marketplace` is any of the 19 regional eBay hosts (`ebay.com` default). `condition` is one of `"new"`, `"open_box"`, `"refurbished"`, `"used"` or `"for_parts"`; `sort` is one of `"best_match"` (default), `"newly_listed"`, `"ending_soon"`, `"price_asc"` or `"price_desc"`; `page_size` is 60, 120 or 240. `exactMatches` is `false` when eBay found nothing for the keyword and answered with its own loosely-related suggestions instead, so check it before using the listings.
+
 ## Cookies and the serving proxy
 
 ```ruby

data/lib/scrapeunblocker/client.rb

@@ -93,6 +93,34 @@ module ScrapeUnblocker
                 page_size: page_size, sort: sort, proxy_country: proxy_country)
     end
 
+    # Search eBay and return the listings as a Hash.
+    #
+    # Each listing carries title, numeric price and currency, condition (with a
+    # normalised conditionCode), seller username and feedback, shipping cost,
+    # sold/watcher/bid counts, image and a clean item URL.
+    #
+    # +marketplace+ is a regional eBay host such as "ebay.com" (default) or
+    # "ebay.de"; +condition+ is one of "new", "open_box", "refurbished", "used"
+    # or "for_parts"; +sort+ is one of "best_match" (default), "newly_listed",
+    # "ending_soon", "price_asc" or "price_desc"; +listing_type+ is "all"
+    # (default), "buy_it_now" or "auction"; +page_size+ is 60, 120 or 240.
+    #
+    # When eBay finds no exact match it still serves a page of loosely related
+    # suggestions, and the response then carries <tt>exactMatches: false</tt>.
+    def ebay_search(keyword, marketplace: "ebay.com", page: 1, page_size: 60,
+                    condition: nil, sort: "best_match", listing_type: "all",
+                    min_price: nil, max_price: nil, free_shipping: false,
+                    seller: nil, category: nil, proxy_country: nil)
+      post_json("/marketplace/ebay-search",
+                keyword: keyword, marketplace: marketplace, page: page,
+                page_size: page_size, condition: condition, sort: sort,
+                listing_type: listing_type, min_price: min_price,
+                max_price: max_price,
+                free_shipping: free_shipping ? true : nil,
+                seller: seller, category: category,
+                proxy_country: proxy_country)
+    end
+
     # Fetch an image URL through the bypass chain and return its raw bytes.
     def get_image(url, proxy_country: nil)
       request("/getImage", url: url, proxy_country: proxy_country)[:body]

data/lib/scrapeunblocker/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: scrapeunblocker
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.1.8
 platform: ruby
 authors:
 - ScrapeUnblocker
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-27 00:00:00.000000000 Z
+date: 2026-07-31 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.