scrapeunblocker 0.1.8 → 0.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '038dc9fc1bd496b441430ed4f1def53055dfb98db2cf21d40ec0242bcd66f344'
-  data.tar.gz: d8fb2745df9da6ac37db17308670f87b1c4131e2b9dfde9e5107ee4fe9e9c260
+  metadata.gz: 28108195aac1cc524421665dfd8eafcf8c41e0419f0e692172b72f55ab3912c8
+  data.tar.gz: 9f80e41ef6047c3b12e32338739c9edd3a0d796211933a09f47b5dd3b70708e8
 SHA512:
-  metadata.gz: ebc1b6eec94316dfb50c56b6109212eaaec54e5b8a0087f8e11f9cc9c634c751c1fed8bafe0bad51d8cf45ba5cd4d978f46feb40fb9c0d64de18aee98712ec46
-  data.tar.gz: 444e12bb48cfcf2e3b1cee4d76676c4334d234cb76a8642917845e4ac3b9a179786abac31c77e7251cf2eca95c1bf3e16ae12d4ace9c6aa131581617d01c12ad
+  metadata.gz: 04040b3a41778d5a98307082d147ca90be55992453dd64409e09b94a7cbee9b5c767585fccb3150d426505ba3f6f533215dafdf63a2e675ce024f6909fe2d925
+  data.tar.gz: 65a01b202aea9d3e94126692df4de80d35312821ee6a14425c6cca8f63e2cf59a0d8f51c38cd1e54e972cbe844e80e0b1a461b38948ce8855682d5ad6a7d67c3

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # 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.

data/README.md

@@ -96,6 +96,24 @@ 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

data/lib/scrapeunblocker/client.rb

@@ -121,6 +121,35 @@ module ScrapeUnblocker
                 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.8"
+  VERSION = "0.1.9"
 end

metadata

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