diff --git a/source/includes/_blank_offers.md b/source/includes/_blank_offers.md new file mode 100644 index 00000000000..5682d3f72ef --- /dev/null +++ b/source/includes/_blank_offers.md @@ -0,0 +1,24 @@ +# Blank Offers Page + +Recently, Amazon has begun to return an empty page instead of a list of product offers. +This appears to be an anti-bot response by Amazon, caused by the IP addresses used to place orders. + +This appears to primarily affect the UK, DE, and IN regions. US, CA, and FR currently appear unaffected. + +When this happens, our ordering agent will respond with the error `amazon_antibot_blank_offers_page`. + +This is done because we cannot guarantee full ordering safeguards without accessing this offers page. + +There are two workarounds that can be attempted: + +1. Set `take_buybox_offers` to true on the top level of the ordering object. + This will automatically accept the first offer on the Amazon product page, + without applying any `seller_selection_criteria`. For safety, it is + suggested to set `max_price` and `max_delivery_days` as well. Because this + accepts the default offer, it will not require loading the broken page. + +2. Bring your own proxy with BYOP. Ideally, you should use a real + residential IP that is dedicated to your ordering flow. For more details, + review the [BYOP docs](/#proxies). + +We will continue to monitor the situation and update this page as new details emerge. diff --git a/source/includes/_proxies.md b/source/includes/_proxies.md index b071ea07f2f..1ad65734a2f 100644 --- a/source/includes/_proxies.md +++ b/source/includes/_proxies.md @@ -2,6 +2,14 @@ The Zinc API interfaces with the retailers via proxies. This enables each retailer interaction session to use unique and consistent IP addressing. Due to many factors, sometimes the bulk proxies available to us become blocked by retailers. The best path to keeping your own account from being blocked is to provide your own proxy service, by either hosting your own proxy or purchasing a proxy from a provider. We call this "bring-your-own-proxy" (BYOP). +## Where do I get a proxy? + +We cannot recommend any specific proxy provider. Many commerical providers are +unsuitable because their IPs are low quality and shared among many users. It is +best to use a real residential IP address dedicated to your ordering flow. + +One option is to deploy the Zinc proxy container, on Github at [zinc/zn-proxy](https://github.com/zincio/zn-proxy). + ## Configure ZincAPI for your own proxy (BYOP) To configure a BYOP, you must provide the retailer, email account, and full proxy connection URL. @@ -41,4 +49,9 @@ curl "https://api.zinc.io/v1/proxies/byop" \ -X GET \ -u : \ -d '{"retailer":"amazon","email":"youremail@youremail.com"}' -``` \ No newline at end of file +``` + +## Disable BYOP + +Use the DELETE method instead of PUT. + diff --git a/source/includes/_supported_retailer.md b/source/includes/_supported_retailer.md index 1e286766b26..8fcc1a07712 100644 --- a/source/includes/_supported_retailer.md +++ b/source/includes/_supported_retailer.md @@ -11,11 +11,11 @@ Amazon United Kingdom† | amazon_uk | Y | Y | Y | Y Amazon Canada† | amazon_ca | Y | Y | Y | Y Amazon Germany† | amazon_de | Y | Y | Y | Y Amazon Mexico† | amazon_mx | Y | Y | Y | Y -Costco | costco | Y | Y | Y | N -Walmart | walmart | Y* | Y | Y | N -Homedepot | homedepot | Y* | N | N | Y +Costco | costco | Y* | Y | Y | N +Walmart | walmart | Y | Y | Y | N +HomeDepot | homedepot | Y* | Y | Y | N Lowes | lowes | N | Y | N | N -AliExpress | aliexpress | Y | Y | Y | N +AliExpress | aliexpress | Y* | Y | Y | N ```*```Currently in beta. -```†```Prime Pantry Items, Kindles, Alexa Products, and Digital items(eBooks and Digital movies) are not supported \ No newline at end of file +```†```Prime Pantry Items, Kindles, Alexa Products, and Digital items(eBooks and Digital movies) are not supported diff --git a/source/index.html.md b/source/index.html.md index c2b1f8e74c4..70c53b06e53 100644 --- a/source/index.html.md +++ b/source/index.html.md @@ -20,6 +20,7 @@ includes: - object_reference - errors - FAQ + - blank_offers search: true ---