scrapeunblocker 0.1.6 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 006e8d929ddbfce0cbdd857f2e4152f90f66e90ec7f047191cba696c15bfaaa9
-  data.tar.gz: 76b72f230eac9bf856ddfa61997272a27e2f6edf709b5e34fb97b1bcf694bf92
+  metadata.gz: '038dc9fc1bd496b441430ed4f1def53055dfb98db2cf21d40ec0242bcd66f344'
+  data.tar.gz: d8fb2745df9da6ac37db17308670f87b1c4131e2b9dfde9e5107ee4fe9e9c260
 SHA512:
-  metadata.gz: 7306785c8274864042095c861b2f007f3bbb7978078e2bc46fc1c1e9e6b3536bf7eb3bd207bf0705a83dad68fd3d6b2292d0b7298428fc7f01242ec896a6ec49
-  data.tar.gz: ab3fae14ec06d02cdddbe3c3f9076ac42ac739371b87025acba31d6f5f1ec92cbed81dcf058c940b82c0ee0098d8c0e5f33cb09620c97b257d31f992c8937a6b
+  metadata.gz: ebc1b6eec94316dfb50c56b6109212eaaec54e5b8a0087f8e11f9cc9c634c751c1fed8bafe0bad51d8cf45ba5cd4d978f46feb40fb9c0d64de18aee98712ec46
+  data.tar.gz: 444e12bb48cfcf2e3b1cee4d76676c4334d234cb76a8642917845e4ac3b9a179786abac31c77e7251cf2eca95c1bf3e16ae12d4ace9c6aa131581617d01c12ad

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # 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.
+
 ## 0.1.6 (2026-07-23)
 
 Version jumps from 0.1.2 to 0.1.6 so all four official SDKs (Python, Node.js, Ruby, PHP) share one version number from here on. Nothing was skipped - 0.1.3 to 0.1.5 were never released for Ruby.

data/README.md

@@ -1,6 +1,6 @@
 # ScrapeUnblocker Ruby client
 
-Official Ruby client for the [ScrapeUnblocker](https://scrapeunblocker.com) web scraping API.
+Official Ruby client for the [ScrapeUnblocker](https://scrapeunblocker.com?utm_source=rubygems&utm_medium=integration&utm_campaign=ruby-sdk) web scraping API.
 
 Every request is fully JavaScript-rendered in a real browser and routed through premium proxies, so it bypasses Cloudflare, DataDome, PerimeterX, Akamai, Kasada and similar anti-bot systems - from one simple call. You are only billed for successful requests.
 
@@ -38,7 +38,7 @@ puts product.page_type # "product"
 p product.data
 ```
 
-Get your API key at [app.scrapeunblocker.com](https://app.scrapeunblocker.com). The free trial does not require a credit card.
+Get your API key at [app.scrapeunblocker.com](https://app.scrapeunblocker.com?utm_source=rubygems&utm_medium=integration&utm_campaign=ruby-sdk). The free trial does not require a credit card.
 
 ## Authentication
 
@@ -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
@@ -201,9 +215,9 @@ ScrapeUnblocker::Client.new(
 
 ## Links
 
-- Documentation: https://developers.scrapeunblocker.com
-- Website: https://scrapeunblocker.com
-- Dashboard: https://app.scrapeunblocker.com
+- Documentation: [developers.scrapeunblocker.com](https://developers.scrapeunblocker.com?utm_source=rubygems&utm_medium=integration&utm_campaign=ruby-sdk)
+- Website: [scrapeunblocker.com](https://scrapeunblocker.com?utm_source=rubygems&utm_medium=integration&utm_campaign=ruby-sdk)
+- Dashboard: [app.scrapeunblocker.com](https://app.scrapeunblocker.com?utm_source=rubygems&utm_medium=integration&utm_campaign=ruby-sdk)
 
 ## License
 

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.6"
+  VERSION = "0.1.8"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: scrapeunblocker
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.8
 platform: ruby
 authors:
 - ScrapeUnblocker
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-23 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.
@@ -27,13 +27,13 @@ files:
 - lib/scrapeunblocker/parsed_page.rb
 - lib/scrapeunblocker/skyscanner.rb
 - lib/scrapeunblocker/version.rb
-homepage: https://scrapeunblocker.com
+homepage: https://scrapeunblocker.com?utm_source=rubygems&utm_medium=integration&utm_campaign=ruby-sdk
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://scrapeunblocker.com
+  homepage_uri: https://scrapeunblocker.com?utm_source=rubygems&utm_medium=integration&utm_campaign=ruby-sdk
   source_code_uri: https://github.com/ScrapeUnblocker/scrapeunblocker-ruby
-  documentation_uri: https://developers.scrapeunblocker.com
+  documentation_uri: https://developers.scrapeunblocker.com?utm_source=rubygems&utm_medium=integration&utm_campaign=ruby-sdk
   changelog_uri: https://github.com/ScrapeUnblocker/scrapeunblocker-ruby/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/ScrapeUnblocker/scrapeunblocker-ruby/issues
   rubygems_mfa_required: 'true'