scrapeunblocker 0.1.7 → 0.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab6bd524121d205b90ef9cabe0315d1185772ee313a6e40d1bf9057dad3b535b
-  data.tar.gz: 82bc7674e38f9bfa125320956e440a66ad535d3aac8ac923e086d0b0ec3fcba2
+  metadata.gz: 28108195aac1cc524421665dfd8eafcf8c41e0419f0e692172b72f55ab3912c8
+  data.tar.gz: 9f80e41ef6047c3b12e32338739c9edd3a0d796211933a09f47b5dd3b70708e8
 SHA512:
-  metadata.gz: 7d8ecc218ec1814f6cdca5681e156488b43302a935a7e8c8fe3d2d73cd98f45558c979c555c33c03db0a43e5a8cf440d2edc8d3b259854844ee7cf9083399fa3
-  data.tar.gz: ad8a15c080c559e9d6d5927351e8336788266a65f07971c0c49c41e69ffbee98b8a3d2a661c62d325365d9abdd716b08241a3afbe1a8a2f47234da48d162894e
+  metadata.gz: 04040b3a41778d5a98307082d147ca90be55992453dd64409e09b94a7cbee9b5c767585fccb3150d426505ba3f6f533215dafdf63a2e675ce024f6909fe2d925
+  data.tar.gz: 65a01b202aea9d3e94126692df4de80d35312821ee6a14425c6cca8f63e2cf59a0d8f51c38cd1e54e972cbe844e80e0b1a461b38948ce8855682d5ad6a7d67c3

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.1.9 (2026-08-28)
+
+- Added `amazon_product` and `amazon_search` for the new Amazon plugin. `amazon_product(asin:/url:)` returns one product - title, brand, numeric price and currency, list price and savings, availability, rating, review count, seller, feature bullets, categories and images. `amazon_search(keyword, ...)` returns a keyword search's cards - asin, title, price, list price, rating, review count, a clean product URL, image and the sponsored/prime flags - on any of 20 regional marketplaces.
+- Prices come back in the right currency automatically: `proxy_country` defaults to the marketplace's home country (amazon.com -> US, amazon.de -> DE), pinning the exit over our ISP pool.
+
+## 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,38 @@ 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.
 
+## Amazon
+
+Product and search data as a Hash, priced in the marketplace's own currency:
+
+```ruby
+# One product by ASIN (or url: "https://www.amazon.de/dp/B0BSHF7WHW")
+product = su.amazon_product(asin: "B0BSHF7WHW", marketplace: "amazon.com")
+puts [product["title"], product["price"], product["currency"], product["rating"]].join(" | ")
+
+# Keyword search
+results = su.amazon_search("wireless headphones", sort: "price_asc")
+results["results"].each do |item|
+  puts [item["title"], item["price"], item["currency"], item["asin"]].join(" | ")
+end
+```
+
+`proxy_country` defaults to the marketplace's home country (`amazon.com` -> US, `amazon.de` -> DE), so prices come back in the right currency with no configuration.
+
+## 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,63 @@ 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
+
+    # Scrape one Amazon product by ASIN or URL and return it as a Hash.
+    #
+    # Returns title, brand, numeric price and currency, list price and savings,
+    # availability, rating, review count, seller, feature bullets, categories
+    # and images. Prices come back in the marketplace's own currency:
+    # +proxy_country+ defaults to the marketplace's home country
+    # (amazon.com -> US), pinning the exit over the ISP pool. Pass either
+    # +asin+ (with +marketplace+) or a full product +url+.
+    def amazon_product(asin: nil, url: nil, marketplace: "amazon.com", proxy_country: nil)
+      post_json("/marketplace/amazon-product",
+                asin: asin, url: url, marketplace: marketplace,
+                proxy_country: proxy_country)
+    end
+
+    # Search Amazon and return the result cards as an Array of Hashes.
+    #
+    # Each card carries asin, title, numeric price and currency, list price,
+    # rating, review count, a clean product URL, image and the sponsored /
+    # prime flags. +sort+ is "featured" (default), "price_asc", "price_desc",
+    # "avg_review" or "newest". Prices are in the marketplace's own currency;
+    # +proxy_country+ defaults to the marketplace's home country.
+    def amazon_search(keyword, marketplace: "amazon.com", page: 1, sort: "featured",
+                      min_price: nil, max_price: nil, proxy_country: nil)
+      post_json("/marketplace/amazon-search",
+                keyword: keyword, marketplace: marketplace, page: page,
+                sort: sort, min_price: min_price, max_price: max_price,
+                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.9"
 end

metadata

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