nocode-amazon 0.0.1__tar.gz

nocode_amazon-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wordstotech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nocode_amazon-0.0.1/MANIFEST.in

@@ -0,0 +1,2 @@
+include README.md
+include LICENSE

nocode_amazon-0.0.1/PKG-INFO

@@ -0,0 +1,244 @@
+Metadata-Version: 2.4
+Name: nocode-amazon
+Version: 0.0.1
+Summary: No code Amazon scraper and Amazon API client: search, product, pricing and featured or sponsored placements via ScrapingBee.
+Author: wordstotech
+License: MIT
+Project-URL: Homepage, https://github.com/ScrapingBee/nocode-amazon
+Project-URL: Repository, https://github.com/ScrapingBee/nocode-amazon
+Project-URL: Documentation, https://www.scrapingbee.com/documentation/
+Keywords: amazon scraper,amazon api,no code scraper,scrape amazon products,amazon product scraper,amazon featured products,web scraping,scrapingbee
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Dynamic: license-file
+
+# nocode-amazon
+
+A Python client for ScrapingBee's three dedicated Amazon endpoints, plus the helpers that separate paid placements from earned ones.
+
+The package name comes from the no code Make and Airtable workflow this grew out of. The library is the code path for people who outgrew the spreadsheet: same data, same public Amazon pages, no visual scenario to maintain.
+
+**Verified against the live API on 2026-09-10.** Every parameter name, response field and credit figure below came back from a real call. Where the documentation and the API disagreed, the API won and the difference is noted.
+
+```bash
+pip install nocode-amazon
+```
+
+Requires Python 3.8 or newer and `requests`.
+
+## Authentication
+
+Header based, on every request:
+
+```
+Authorization: Bearer YOUR_API_KEY
+```
+
+The `api_key` query parameter still answers but the current documentation marks it deprecated. This client sends the header.
+
+```python
+from nocode_amazon import AmazonScraper
+
+bee = AmazonScraper("YOUR_API_KEY")
+```
+
+Get a key and 1,000 free credits from [ScrapingBee](https://www.scrapingbee.com/). Full reference: [Amazon API documentation](https://www.scrapingbee.com/documentation/amazon/).
+
+---
+
+## Endpoint reference
+
+### `search(query, pages=1, **params)`
+
+`GET /api/v1/amazon/search`. **5 credits per page.**
+
+Amazon search results as structured JSON. No HTML, no selectors.
+
+```python
+page = bee.search("fitness tracker")
+page["products_count"]   # 23
+page["products"]         # list of product dicts
+page["refinements"]      # Amazon's own facets for this query
+page["url"]              # the Amazon URL that was fetched
+page["page"]             # 1
+```
+
+Live call on `fitness tracker` returned 23 products and a `refinements` object with 53 facet groups, including `brands`, `band_color`, `band_material_type`, `battery_average_life`, `battery_charge_time` and `case_diameter`.
+
+Optional parameters, all verified present on the endpoint:
+
+| Parameter | Notes |
+|---|---|
+| `pages` | Pages to fetch. Billed per page |
+| `sort_by` | `featured`, `most_recent`, `price_low_to_high`, `price_high_to_low`, `average_review`, `bestsellers` |
+| `category_id` | Restrict to one Amazon category |
+| `merchant_id` | Restrict to one seller |
+| `domain` | Marketplace top level domain: `com`, `co.uk`, `de`, `in` |
+| `country` | Proxy geolocation |
+| `currency` | ISO 4217 display currency |
+| `language` | ISO language code |
+| `device` | `desktop` or `mobile` |
+| `zip_code` | Postal code. Changes prices and delivery promises |
+| `light_request` | Default `True` at 5 credits. `False` forces a browser at 15 |
+| `add_html` | Include the raw page alongside the JSON |
+| `autoselect_variant` | Pick a variant automatically |
+| `screenshot` | Capture the page. Always 15 credits, ignores `light_request` |
+| `tag` | Your own label, returned in the response headers |
+
+Related landing pages: [Amazon search API](https://www.scrapingbee.com/scrapers/amazon-search-api/), [Amazon keyword scraper API](https://www.scrapingbee.com/scrapers/amazon-keyword-scraper-api/), [Amazon organic results API](https://www.scrapingbee.com/scrapers/amazon-organic-results-api/), [Amazon filters API](https://www.scrapingbee.com/scrapers/amazon-filters-api/), [Amazon related searches API](https://www.scrapingbee.com/scrapers/amazon-related-searches-api/), [Amazon spell check API](https://www.scrapingbee.com/scrapers/amazon-spell-check-api/), [Amazon zip code API](https://www.scrapingbee.com/scrapers/amazon-zip-code-api/).
+
+### `product(asin, **params)`
+
+`GET /api/v1/amazon/product`. **5 credits.**
+
+**The wire parameter is `query`, not `asin`.** The value has to be a valid 10 character ASIN, but the field is named `query`. This client takes `asin` as its argument name and sends `query` for you.
+
+```python
+detail = bee.product("B0GTMTZF3V")
+detail["brand"]          # 'Fitbit'
+detail["price"]          # 99.99
+detail["currency"]       # 'USD'
+detail["rating"]         # 4.3
+detail["reviews_count"]  # 2036
+```
+
+The live response carried **56 top level keys**. The ones worth knowing:
+
+| Field | Contents |
+|---|---|
+| `bullet_points` | The feature bullets, newline separated |
+| `category` | A `ladder` of breadcrumb steps, each with `name` and `url` |
+| `featured_merchant` | `name`, `seller_id`, `shipped_from`, `is_amazon_fulfilled` |
+| `product_details` | Spec table as key and value pairs, including `best_sellers_rank` |
+| `technical_details` | The second spec table |
+| `rating_stars_distribution` | Review counts per star rating |
+| `sales_rank` | Category rank entries |
+| `variations` | Other sizes, colours and configurations |
+| `images` | Image URLs |
+| `delivery` | Delivery promises with type and date |
+| `pricing_url` | The offer listing page for this ASIN |
+| `parent_asin` | The variation parent |
+| `discount_percentage`, `price_strikethrough`, `coupon` | Promotion state |
+| `stock`, `max_quantity` | Availability |
+
+Related: [Amazon ASIN API](https://www.scrapingbee.com/scrapers/amazon-asin-api/), [Amazon image API](https://www.scrapingbee.com/scrapers/amazon-image-api/), [Amazon review API](https://www.scrapingbee.com/scrapers/amazon-review-api/), [Amazon best sellers API](https://www.scrapingbee.com/scrapers/amazon-best-sellers-api/), [Amazon video results API](https://www.scrapingbee.com/scrapers/amazon-video-results-api/), [Amazon URL API](https://www.scrapingbee.com/scrapers/amazon-ulr-api/).
+
+### `pricing(asin, **params)`
+
+`GET /api/v1/amazon/pricing`. **5 credits.**
+
+**This endpoint takes `asin` on the wire.** Search and product both take `query`. Pricing does not, and it rejects `query` explicitly:
+
+```json
+{"errors": {"query": {"asin": ["Missing data for required field."], "query": ["Unknown field."]}}}
+```
+
+That rejected call was billed **0 credits**, confirmed by `spb-cost: 0` on the response. This client raises `ScrapingBeeError` with the API's own error dict in `.payload`, so the offending field is never a guess.
+
+```python
+offers = bee.pricing("B0GTMTZF3V")
+for offer in offers["pricing"]:
+    print(offer["seller"], offer["price"], offer["condition"])
+```
+
+Each offer carries `seller`, `seller_id`, `seller_link`, `condition`, `price`, `price_shipping`, `currency`, `rating_count` and a `delivery_options` list.
+
+Related: [Amazon offers API](https://www.scrapingbee.com/scrapers/amazon-offers-api/), [Amazon seller API](https://www.scrapingbee.com/scrapers/amazon-seller-api/), [Amazon vendor API](https://www.scrapingbee.com/scrapers/amazon-vendor-api/), [Amazon shipping API](https://www.scrapingbee.com/scrapers/amazon-shipping-api/).
+
+### `usage()`
+
+`GET /api/v1/usage`. **Free.**
+
+```python
+bee.usage()
+# {'max_api_credit': 1000000, 'used_api_credit': 353946,
+#  'max_concurrency': 100, 'current_concurrency': 0,
+#  'renewal_subscription_date': '2026-09-21T12:06:28'}
+```
+
+Call this before a large run. Note it lags by minutes, so do not read it immediately afterwards to compute what a batch cost.
+
+---
+
+## Placement helpers
+
+Amazon search markup gives every card the same classes, so CSS selectors cannot tell a paid slot from an earned rank. The endpoint labels each result instead, which turns the problem into a filter.
+
+Per product placement fields:
+
+| Field | Type | Meaning |
+|---|---|---|
+| `is_sponsored` | bool | Paid placement |
+| `sponsored_position` | int or None | Rank among the ads |
+| `organic_position` | int or None | Rank among earned results |
+| `is_amazons_choice` | bool | Amazon's Choice badge |
+| `best_seller` | bool | Best Seller badge |
+| `sales_volume` | str | For example `10K+ bought in past month` |
+
+```python
+page = bee.search("fitness tracker", sort_by="featured")
+
+AmazonScraper.featured(page)   # sponsored, ordered by ad slot
+AmazonScraper.organic(page)    # earned, ordered by organic rank
+AmazonScraper.badged(page)     # Amazon's Choice or Best Seller
+AmazonScraper.facets(page)     # the refinements object
+```
+
+Two live runs on the same query returned 7 featured of 24 products, then 9 of 26. Paid density moves between requests, so measure it rather than assuming a fixed ratio.
+
+`is_prime` came back `False` on every row of both pages, so verify it against your own target category before building a Prime filter on it.
+
+---
+
+## Credit cost
+
+Measured from `spb-cost` response headers, not quoted from a pricing page. This client stores the value on `bee.last_cost` after every call.
+
+| Call | Credits |
+|---|---|
+| Search, default light request | 5 per page |
+| Search, `light_request=False` | 15 per page |
+| Product, default | 5 |
+| Product, `light_request=False` | 15 |
+| Pricing | 5 |
+| Any screenshot | 15 |
+| Rejected request | 0 |
+| `usage()` | 0 |
+
+Light requests skip the browser. They were sufficient for search, product and pricing on every call made here. Turn them off when you need review text or other content that appears only after JavaScript runs.
+
+Failed requests are retried inside the API for up to 30 seconds, so set client timeouts above that. This client defaults to 60 seconds.
+
+Plan tiers: [ScrapingBee pricing](https://www.scrapingbee.com/pricing).
+
+---
+
+## Scope
+
+Public Amazon listing and product pages. Nothing in this package signs in, and scraping under login credentials is prohibited by ScrapingBee's terms of service.
+
+## Related features
+
+[AI web scraping](https://www.scrapingbee.com/features/ai-web-scraping-api/), [data extraction rules](https://www.scrapingbee.com/features/data-extraction/), [Amazon feature page](https://www.scrapingbee.com/features/amazon/), [screenshots](https://www.scrapingbee.com/features/screenshot/), [markdown scraper](https://www.scrapingbee.com/features/markdown-scraper/), [Make integration](https://www.scrapingbee.com/features/make/), [n8n integration](https://www.scrapingbee.com/features/n8n/), [Zapier integration](https://www.scrapingbee.com/features/zapier/).
+
+The no code version of this workflow, with the Make scenario and the extraction rules, is at [github.com/ScrapingBee/nocode-amazon](https://github.com/ScrapingBee/nocode-amazon).
+
+## License
+
+MIT

nocode_amazon-0.0.1/README.md

@@ -0,0 +1,214 @@
+# nocode-amazon
+
+A Python client for ScrapingBee's three dedicated Amazon endpoints, plus the helpers that separate paid placements from earned ones.
+
+The package name comes from the no code Make and Airtable workflow this grew out of. The library is the code path for people who outgrew the spreadsheet: same data, same public Amazon pages, no visual scenario to maintain.
+
+**Verified against the live API on 2026-09-10.** Every parameter name, response field and credit figure below came back from a real call. Where the documentation and the API disagreed, the API won and the difference is noted.
+
+```bash
+pip install nocode-amazon
+```
+
+Requires Python 3.8 or newer and `requests`.
+
+## Authentication
+
+Header based, on every request:
+
+```
+Authorization: Bearer YOUR_API_KEY
+```
+
+The `api_key` query parameter still answers but the current documentation marks it deprecated. This client sends the header.
+
+```python
+from nocode_amazon import AmazonScraper
+
+bee = AmazonScraper("YOUR_API_KEY")
+```
+
+Get a key and 1,000 free credits from [ScrapingBee](https://www.scrapingbee.com/). Full reference: [Amazon API documentation](https://www.scrapingbee.com/documentation/amazon/).
+
+---
+
+## Endpoint reference
+
+### `search(query, pages=1, **params)`
+
+`GET /api/v1/amazon/search`. **5 credits per page.**
+
+Amazon search results as structured JSON. No HTML, no selectors.
+
+```python
+page = bee.search("fitness tracker")
+page["products_count"]   # 23
+page["products"]         # list of product dicts
+page["refinements"]      # Amazon's own facets for this query
+page["url"]              # the Amazon URL that was fetched
+page["page"]             # 1
+```
+
+Live call on `fitness tracker` returned 23 products and a `refinements` object with 53 facet groups, including `brands`, `band_color`, `band_material_type`, `battery_average_life`, `battery_charge_time` and `case_diameter`.
+
+Optional parameters, all verified present on the endpoint:
+
+| Parameter | Notes |
+|---|---|
+| `pages` | Pages to fetch. Billed per page |
+| `sort_by` | `featured`, `most_recent`, `price_low_to_high`, `price_high_to_low`, `average_review`, `bestsellers` |
+| `category_id` | Restrict to one Amazon category |
+| `merchant_id` | Restrict to one seller |
+| `domain` | Marketplace top level domain: `com`, `co.uk`, `de`, `in` |
+| `country` | Proxy geolocation |
+| `currency` | ISO 4217 display currency |
+| `language` | ISO language code |
+| `device` | `desktop` or `mobile` |
+| `zip_code` | Postal code. Changes prices and delivery promises |
+| `light_request` | Default `True` at 5 credits. `False` forces a browser at 15 |
+| `add_html` | Include the raw page alongside the JSON |
+| `autoselect_variant` | Pick a variant automatically |
+| `screenshot` | Capture the page. Always 15 credits, ignores `light_request` |
+| `tag` | Your own label, returned in the response headers |
+
+Related landing pages: [Amazon search API](https://www.scrapingbee.com/scrapers/amazon-search-api/), [Amazon keyword scraper API](https://www.scrapingbee.com/scrapers/amazon-keyword-scraper-api/), [Amazon organic results API](https://www.scrapingbee.com/scrapers/amazon-organic-results-api/), [Amazon filters API](https://www.scrapingbee.com/scrapers/amazon-filters-api/), [Amazon related searches API](https://www.scrapingbee.com/scrapers/amazon-related-searches-api/), [Amazon spell check API](https://www.scrapingbee.com/scrapers/amazon-spell-check-api/), [Amazon zip code API](https://www.scrapingbee.com/scrapers/amazon-zip-code-api/).
+
+### `product(asin, **params)`
+
+`GET /api/v1/amazon/product`. **5 credits.**
+
+**The wire parameter is `query`, not `asin`.** The value has to be a valid 10 character ASIN, but the field is named `query`. This client takes `asin` as its argument name and sends `query` for you.
+
+```python
+detail = bee.product("B0GTMTZF3V")
+detail["brand"]          # 'Fitbit'
+detail["price"]          # 99.99
+detail["currency"]       # 'USD'
+detail["rating"]         # 4.3
+detail["reviews_count"]  # 2036
+```
+
+The live response carried **56 top level keys**. The ones worth knowing:
+
+| Field | Contents |
+|---|---|
+| `bullet_points` | The feature bullets, newline separated |
+| `category` | A `ladder` of breadcrumb steps, each with `name` and `url` |
+| `featured_merchant` | `name`, `seller_id`, `shipped_from`, `is_amazon_fulfilled` |
+| `product_details` | Spec table as key and value pairs, including `best_sellers_rank` |
+| `technical_details` | The second spec table |
+| `rating_stars_distribution` | Review counts per star rating |
+| `sales_rank` | Category rank entries |
+| `variations` | Other sizes, colours and configurations |
+| `images` | Image URLs |
+| `delivery` | Delivery promises with type and date |
+| `pricing_url` | The offer listing page for this ASIN |
+| `parent_asin` | The variation parent |
+| `discount_percentage`, `price_strikethrough`, `coupon` | Promotion state |
+| `stock`, `max_quantity` | Availability |
+
+Related: [Amazon ASIN API](https://www.scrapingbee.com/scrapers/amazon-asin-api/), [Amazon image API](https://www.scrapingbee.com/scrapers/amazon-image-api/), [Amazon review API](https://www.scrapingbee.com/scrapers/amazon-review-api/), [Amazon best sellers API](https://www.scrapingbee.com/scrapers/amazon-best-sellers-api/), [Amazon video results API](https://www.scrapingbee.com/scrapers/amazon-video-results-api/), [Amazon URL API](https://www.scrapingbee.com/scrapers/amazon-ulr-api/).
+
+### `pricing(asin, **params)`
+
+`GET /api/v1/amazon/pricing`. **5 credits.**
+
+**This endpoint takes `asin` on the wire.** Search and product both take `query`. Pricing does not, and it rejects `query` explicitly:
+
+```json
+{"errors": {"query": {"asin": ["Missing data for required field."], "query": ["Unknown field."]}}}
+```
+
+That rejected call was billed **0 credits**, confirmed by `spb-cost: 0` on the response. This client raises `ScrapingBeeError` with the API's own error dict in `.payload`, so the offending field is never a guess.
+
+```python
+offers = bee.pricing("B0GTMTZF3V")
+for offer in offers["pricing"]:
+    print(offer["seller"], offer["price"], offer["condition"])
+```
+
+Each offer carries `seller`, `seller_id`, `seller_link`, `condition`, `price`, `price_shipping`, `currency`, `rating_count` and a `delivery_options` list.
+
+Related: [Amazon offers API](https://www.scrapingbee.com/scrapers/amazon-offers-api/), [Amazon seller API](https://www.scrapingbee.com/scrapers/amazon-seller-api/), [Amazon vendor API](https://www.scrapingbee.com/scrapers/amazon-vendor-api/), [Amazon shipping API](https://www.scrapingbee.com/scrapers/amazon-shipping-api/).
+
+### `usage()`
+
+`GET /api/v1/usage`. **Free.**
+
+```python
+bee.usage()
+# {'max_api_credit': 1000000, 'used_api_credit': 353946,
+#  'max_concurrency': 100, 'current_concurrency': 0,
+#  'renewal_subscription_date': '2026-09-21T12:06:28'}
+```
+
+Call this before a large run. Note it lags by minutes, so do not read it immediately afterwards to compute what a batch cost.
+
+---
+
+## Placement helpers
+
+Amazon search markup gives every card the same classes, so CSS selectors cannot tell a paid slot from an earned rank. The endpoint labels each result instead, which turns the problem into a filter.
+
+Per product placement fields:
+
+| Field | Type | Meaning |
+|---|---|---|
+| `is_sponsored` | bool | Paid placement |
+| `sponsored_position` | int or None | Rank among the ads |
+| `organic_position` | int or None | Rank among earned results |
+| `is_amazons_choice` | bool | Amazon's Choice badge |
+| `best_seller` | bool | Best Seller badge |
+| `sales_volume` | str | For example `10K+ bought in past month` |
+
+```python
+page = bee.search("fitness tracker", sort_by="featured")
+
+AmazonScraper.featured(page)   # sponsored, ordered by ad slot
+AmazonScraper.organic(page)    # earned, ordered by organic rank
+AmazonScraper.badged(page)     # Amazon's Choice or Best Seller
+AmazonScraper.facets(page)     # the refinements object
+```
+
+Two live runs on the same query returned 7 featured of 24 products, then 9 of 26. Paid density moves between requests, so measure it rather than assuming a fixed ratio.
+
+`is_prime` came back `False` on every row of both pages, so verify it against your own target category before building a Prime filter on it.
+
+---
+
+## Credit cost
+
+Measured from `spb-cost` response headers, not quoted from a pricing page. This client stores the value on `bee.last_cost` after every call.
+
+| Call | Credits |
+|---|---|
+| Search, default light request | 5 per page |
+| Search, `light_request=False` | 15 per page |
+| Product, default | 5 |
+| Product, `light_request=False` | 15 |
+| Pricing | 5 |
+| Any screenshot | 15 |
+| Rejected request | 0 |
+| `usage()` | 0 |
+
+Light requests skip the browser. They were sufficient for search, product and pricing on every call made here. Turn them off when you need review text or other content that appears only after JavaScript runs.
+
+Failed requests are retried inside the API for up to 30 seconds, so set client timeouts above that. This client defaults to 60 seconds.
+
+Plan tiers: [ScrapingBee pricing](https://www.scrapingbee.com/pricing).
+
+---
+
+## Scope
+
+Public Amazon listing and product pages. Nothing in this package signs in, and scraping under login credentials is prohibited by ScrapingBee's terms of service.
+
+## Related features
+
+[AI web scraping](https://www.scrapingbee.com/features/ai-web-scraping-api/), [data extraction rules](https://www.scrapingbee.com/features/data-extraction/), [Amazon feature page](https://www.scrapingbee.com/features/amazon/), [screenshots](https://www.scrapingbee.com/features/screenshot/), [markdown scraper](https://www.scrapingbee.com/features/markdown-scraper/), [Make integration](https://www.scrapingbee.com/features/make/), [n8n integration](https://www.scrapingbee.com/features/n8n/), [Zapier integration](https://www.scrapingbee.com/features/zapier/).
+
+The no code version of this workflow, with the Make scenario and the extraction rules, is at [github.com/ScrapingBee/nocode-amazon](https://github.com/ScrapingBee/nocode-amazon).
+
+## License
+
+MIT

nocode_amazon-0.0.1/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "nocode-amazon"
+version = "0.0.1"
+description = "No code Amazon scraper and Amazon API client: search, product, pricing and featured or sponsored placements via ScrapingBee."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "wordstotech" }]
+keywords = ["amazon scraper", "amazon api", "no code scraper", "scrape amazon products", "amazon product scraper", "amazon featured products", "web scraping", "scrapingbee"]
+dependencies = ["requests>=2.25.0"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Text Processing :: Markup :: HTML",
+]
+
+[project.urls]
+Homepage = "https://github.com/ScrapingBee/nocode-amazon"
+Repository = "https://github.com/ScrapingBee/nocode-amazon"
+Documentation = "https://www.scrapingbee.com/documentation/"
+
+[tool.setuptools.packages.find]
+where = ["src"]

nocode_amazon-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

nocode_amazon-0.0.1/src/nocode_amazon/__init__.py

@@ -0,0 +1,6 @@
+"""No code Amazon scraper, plus a client for the ScrapingBee Amazon API."""
+
+from .client import AmazonScraper, ScrapingBeeError
+
+__all__ = ["AmazonScraper", "ScrapingBeeError"]
+__version__ = "0.0.1"

nocode_amazon-0.0.1/src/nocode_amazon/client.py

@@ -0,0 +1,205 @@
+"""ScrapingBee Amazon API client.
+
+Every endpoint, parameter name and credit figure here was verified against
+the live API on 2026-09-10. Auth is the Authorization Bearer header, which
+is what the current documentation uses. The api_key query parameter still
+answers but is marked deprecated.
+"""
+
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional
+
+import requests
+
+__all__ = ["AmazonScraper", "ScrapingBeeError"]
+
+BASE_URL = "https://app.scrapingbee.com/api/v1"
+
+
+class ScrapingBeeError(RuntimeError):
+    """Raised when the API returns a validation error or a failed request."""
+
+    def __init__(self, message: str, status: Optional[int] = None,
+                 payload: Any = None) -> None:
+        super().__init__(message)
+        self.status = status
+        self.payload = payload
+
+
+class AmazonScraper:
+    """Client for the three dedicated ScrapingBee Amazon endpoints.
+
+        >>> bee = AmazonScraper("YOUR_API_KEY")
+        >>> page = bee.search("fitness tracker")
+        >>> len(bee.featured(page))
+        3
+
+    Credit cost, measured live: 5 per call on a light request, 15 with
+    ``light_request=False``, 15 for any screenshot, 0 for a rejected
+    request. Search bills per page.
+    """
+
+    def __init__(self, api_key: str, base_url: str = BASE_URL,
+                 timeout: int = 60, session: Optional[requests.Session] = None) -> None:
+        if not api_key:
+            raise ValueError("api_key is required")
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+        self._session = session or requests.Session()
+        self.last_cost: Optional[int] = None
+
+    # ------------------------------------------------------------------ core
+
+    def _get(self, path: str, params: Dict[str, Any]) -> Dict[str, Any]:
+        clean = {k: v for k, v in params.items() if v is not None}
+        for key, value in list(clean.items()):
+            if isinstance(value, bool):
+                clean[key] = "true" if value else "false"
+
+        response = self._session.get(
+            f"{self.base_url}/{path}",
+            headers={"Authorization": f"Bearer {self.api_key}"},
+            params=clean,
+            timeout=self.timeout,
+        )
+
+        # Cost arrives as a response header. Names are lowercased over HTTP/2.
+        cost = response.headers.get("spb-cost")
+        self.last_cost = int(cost) if cost and cost.isdigit() else None
+
+        try:
+            body = response.json()
+        except ValueError:
+            raise ScrapingBeeError(
+                f"non JSON response ({response.status_code})",
+                response.status_code,
+                response.text[:500],
+            ) from None
+
+        # The API names the offending field, so surface it rather than a guess.
+        if isinstance(body, dict) and "errors" in body:
+            raise ScrapingBeeError(
+                f"API rejected the request: {body['errors']}",
+                response.status_code,
+                body["errors"],
+            )
+        response.raise_for_status()
+        return body
+
+    # ------------------------------------------------------------- endpoints
+
+    def search(self, query: str, pages: int = 1, *, sort_by: Optional[str] = None,
+               category_id: Optional[str] = None, merchant_id: Optional[str] = None,
+               country: Optional[str] = None, currency: Optional[str] = None,
+               domain: Optional[str] = None, language: Optional[str] = None,
+               device: Optional[str] = None, zip_code: Optional[str] = None,
+               light_request: Optional[bool] = None, add_html: Optional[bool] = None,
+               autoselect_variant: Optional[bool] = None,
+               screenshot: Optional[bool] = None,
+               tag: Optional[str] = None) -> Dict[str, Any]:
+        """Amazon search results. 5 credits per page.
+
+        Returns ``products``, ``products_count``, ``refinements``, ``url``
+        and ``page``. ``sort_by`` accepts ``featured``, ``most_recent``,
+        ``price_low_to_high``, ``price_high_to_low``, ``average_review``
+        and ``bestsellers``.
+
+        ``domain`` selects the marketplace, for example ``co.uk`` or ``in``.
+        ``zip_code`` matters because Amazon prices and delivery promises are
+        postal code dependent.
+        """
+        return self._get("amazon/search", {
+            "query": query, "pages": pages, "sort_by": sort_by,
+            "category_id": category_id, "merchant_id": merchant_id,
+            "country": country, "currency": currency, "domain": domain,
+            "language": language, "device": device, "zip_code": zip_code,
+            "light_request": light_request, "add_html": add_html,
+            "autoselect_variant": autoselect_variant,
+            "screenshot": screenshot, "tag": tag,
+        })
+
+    def product(self, asin: str, *, country: Optional[str] = None,
+                currency: Optional[str] = None, domain: Optional[str] = None,
+                language: Optional[str] = None, device: Optional[str] = None,
+                zip_code: Optional[str] = None, light_request: Optional[bool] = None,
+                add_html: Optional[bool] = None, screenshot: Optional[bool] = None,
+                tag: Optional[str] = None) -> Dict[str, Any]:
+        """Structured product detail. 5 credits.
+
+        Note the wire parameter is ``query``, not ``asin``, even though the
+        value must be a 10 character ASIN. Sending ``asin`` here is rejected.
+
+        The live response carries 56 top level keys, including ``price``,
+        ``brand``, ``rating``, ``reviews_count``, ``bullet_points``,
+        ``category`` as a breadcrumb ladder, ``featured_merchant``,
+        ``rating_stars_distribution``, ``sales_rank``, ``variations`` and
+        ``technical_details``.
+        """
+        return self._get("amazon/product", {
+            "query": asin, "country": country, "currency": currency,
+            "domain": domain, "language": language, "device": device,
+            "zip_code": zip_code, "light_request": light_request,
+            "add_html": add_html, "screenshot": screenshot, "tag": tag,
+        })
+
+    def pricing(self, asin: str, *, country: Optional[str] = None,
+                currency: Optional[str] = None, domain: Optional[str] = None,
+                language: Optional[str] = None, device: Optional[str] = None,
+                zip_code: Optional[str] = None, light_request: Optional[bool] = None,
+                add_html: Optional[bool] = None,
+                tag: Optional[str] = None) -> Dict[str, Any]:
+        """Seller offers for one ASIN. 5 credits.
+
+        This endpoint takes ``asin`` on the wire, unlike search and product,
+        which both take ``query``. Sending ``query`` returns
+        ``{"errors": {"query": {"asin": ["Missing data for required field."],
+        "query": ["Unknown field."]}}}`` and bills 0 credits.
+
+        Each entry in ``pricing`` has ``seller``, ``seller_id``,
+        ``condition``, ``price``, ``price_shipping``, ``currency``,
+        ``rating_count`` and ``delivery_options``.
+        """
+        return self._get("amazon/pricing", {
+            "asin": asin, "country": country, "currency": currency,
+            "domain": domain, "language": language, "device": device,
+            "zip_code": zip_code, "light_request": light_request,
+            "add_html": add_html, "tag": tag,
+        })
+
+    def usage(self) -> Dict[str, Any]:
+        """Account credit usage. Free, no credits charged."""
+        return self._get("usage", {})
+
+    # -------------------------------------------------------------- helpers
+
+    @staticmethod
+    def featured(page: Dict[str, Any]) -> List[Dict[str, Any]]:
+        """Paid placements from a search response, ordered by ad slot.
+
+        The endpoint labels every result, so this is a filter rather than a
+        parsing problem. CSS selectors cannot make this distinction because
+        every card shares the same markup.
+        """
+        ads = [p for p in page.get("products", []) if p.get("is_sponsored")]
+        return sorted(ads, key=lambda p: p.get("sponsored_position") or 0)
+
+    @staticmethod
+    def organic(page: Dict[str, Any]) -> List[Dict[str, Any]]:
+        """Earned results from a search response, ordered by organic rank."""
+        rows = [p for p in page.get("products", []) if not p.get("is_sponsored")]
+        return sorted(rows, key=lambda p: p.get("organic_position") or 0)
+
+    @staticmethod
+    def badged(page: Dict[str, Any]) -> List[Dict[str, Any]]:
+        """Results carrying an Amazon's Choice or Best Seller badge."""
+        return [
+            p for p in page.get("products", [])
+            if p.get("is_amazons_choice") or p.get("best_seller")
+        ]
+
+    @staticmethod
+    def facets(page: Dict[str, Any]) -> Dict[str, Any]:
+        """Amazon's own filter facets for the query, from ``refinements``."""
+        return page.get("refinements") or {}

nocode_amazon-0.0.1/src/nocode_amazon.egg-info/PKG-INFO

@@ -0,0 +1,244 @@
+Metadata-Version: 2.4
+Name: nocode-amazon
+Version: 0.0.1
+Summary: No code Amazon scraper and Amazon API client: search, product, pricing and featured or sponsored placements via ScrapingBee.
+Author: wordstotech
+License: MIT
+Project-URL: Homepage, https://github.com/ScrapingBee/nocode-amazon
+Project-URL: Repository, https://github.com/ScrapingBee/nocode-amazon
+Project-URL: Documentation, https://www.scrapingbee.com/documentation/
+Keywords: amazon scraper,amazon api,no code scraper,scrape amazon products,amazon product scraper,amazon featured products,web scraping,scrapingbee
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Dynamic: license-file
+
+# nocode-amazon
+
+A Python client for ScrapingBee's three dedicated Amazon endpoints, plus the helpers that separate paid placements from earned ones.
+
+The package name comes from the no code Make and Airtable workflow this grew out of. The library is the code path for people who outgrew the spreadsheet: same data, same public Amazon pages, no visual scenario to maintain.
+
+**Verified against the live API on 2026-09-10.** Every parameter name, response field and credit figure below came back from a real call. Where the documentation and the API disagreed, the API won and the difference is noted.
+
+```bash
+pip install nocode-amazon
+```
+
+Requires Python 3.8 or newer and `requests`.
+
+## Authentication
+
+Header based, on every request:
+
+```
+Authorization: Bearer YOUR_API_KEY
+```
+
+The `api_key` query parameter still answers but the current documentation marks it deprecated. This client sends the header.
+
+```python
+from nocode_amazon import AmazonScraper
+
+bee = AmazonScraper("YOUR_API_KEY")
+```
+
+Get a key and 1,000 free credits from [ScrapingBee](https://www.scrapingbee.com/). Full reference: [Amazon API documentation](https://www.scrapingbee.com/documentation/amazon/).
+
+---
+
+## Endpoint reference
+
+### `search(query, pages=1, **params)`
+
+`GET /api/v1/amazon/search`. **5 credits per page.**
+
+Amazon search results as structured JSON. No HTML, no selectors.
+
+```python
+page = bee.search("fitness tracker")
+page["products_count"]   # 23
+page["products"]         # list of product dicts
+page["refinements"]      # Amazon's own facets for this query
+page["url"]              # the Amazon URL that was fetched
+page["page"]             # 1
+```
+
+Live call on `fitness tracker` returned 23 products and a `refinements` object with 53 facet groups, including `brands`, `band_color`, `band_material_type`, `battery_average_life`, `battery_charge_time` and `case_diameter`.
+
+Optional parameters, all verified present on the endpoint:
+
+| Parameter | Notes |
+|---|---|
+| `pages` | Pages to fetch. Billed per page |
+| `sort_by` | `featured`, `most_recent`, `price_low_to_high`, `price_high_to_low`, `average_review`, `bestsellers` |
+| `category_id` | Restrict to one Amazon category |
+| `merchant_id` | Restrict to one seller |
+| `domain` | Marketplace top level domain: `com`, `co.uk`, `de`, `in` |
+| `country` | Proxy geolocation |
+| `currency` | ISO 4217 display currency |
+| `language` | ISO language code |
+| `device` | `desktop` or `mobile` |
+| `zip_code` | Postal code. Changes prices and delivery promises |
+| `light_request` | Default `True` at 5 credits. `False` forces a browser at 15 |
+| `add_html` | Include the raw page alongside the JSON |
+| `autoselect_variant` | Pick a variant automatically |
+| `screenshot` | Capture the page. Always 15 credits, ignores `light_request` |
+| `tag` | Your own label, returned in the response headers |
+
+Related landing pages: [Amazon search API](https://www.scrapingbee.com/scrapers/amazon-search-api/), [Amazon keyword scraper API](https://www.scrapingbee.com/scrapers/amazon-keyword-scraper-api/), [Amazon organic results API](https://www.scrapingbee.com/scrapers/amazon-organic-results-api/), [Amazon filters API](https://www.scrapingbee.com/scrapers/amazon-filters-api/), [Amazon related searches API](https://www.scrapingbee.com/scrapers/amazon-related-searches-api/), [Amazon spell check API](https://www.scrapingbee.com/scrapers/amazon-spell-check-api/), [Amazon zip code API](https://www.scrapingbee.com/scrapers/amazon-zip-code-api/).
+
+### `product(asin, **params)`
+
+`GET /api/v1/amazon/product`. **5 credits.**
+
+**The wire parameter is `query`, not `asin`.** The value has to be a valid 10 character ASIN, but the field is named `query`. This client takes `asin` as its argument name and sends `query` for you.
+
+```python
+detail = bee.product("B0GTMTZF3V")
+detail["brand"]          # 'Fitbit'
+detail["price"]          # 99.99
+detail["currency"]       # 'USD'
+detail["rating"]         # 4.3
+detail["reviews_count"]  # 2036
+```
+
+The live response carried **56 top level keys**. The ones worth knowing:
+
+| Field | Contents |
+|---|---|
+| `bullet_points` | The feature bullets, newline separated |
+| `category` | A `ladder` of breadcrumb steps, each with `name` and `url` |
+| `featured_merchant` | `name`, `seller_id`, `shipped_from`, `is_amazon_fulfilled` |
+| `product_details` | Spec table as key and value pairs, including `best_sellers_rank` |
+| `technical_details` | The second spec table |
+| `rating_stars_distribution` | Review counts per star rating |
+| `sales_rank` | Category rank entries |
+| `variations` | Other sizes, colours and configurations |
+| `images` | Image URLs |
+| `delivery` | Delivery promises with type and date |
+| `pricing_url` | The offer listing page for this ASIN |
+| `parent_asin` | The variation parent |
+| `discount_percentage`, `price_strikethrough`, `coupon` | Promotion state |
+| `stock`, `max_quantity` | Availability |
+
+Related: [Amazon ASIN API](https://www.scrapingbee.com/scrapers/amazon-asin-api/), [Amazon image API](https://www.scrapingbee.com/scrapers/amazon-image-api/), [Amazon review API](https://www.scrapingbee.com/scrapers/amazon-review-api/), [Amazon best sellers API](https://www.scrapingbee.com/scrapers/amazon-best-sellers-api/), [Amazon video results API](https://www.scrapingbee.com/scrapers/amazon-video-results-api/), [Amazon URL API](https://www.scrapingbee.com/scrapers/amazon-ulr-api/).
+
+### `pricing(asin, **params)`
+
+`GET /api/v1/amazon/pricing`. **5 credits.**
+
+**This endpoint takes `asin` on the wire.** Search and product both take `query`. Pricing does not, and it rejects `query` explicitly:
+
+```json
+{"errors": {"query": {"asin": ["Missing data for required field."], "query": ["Unknown field."]}}}
+```
+
+That rejected call was billed **0 credits**, confirmed by `spb-cost: 0` on the response. This client raises `ScrapingBeeError` with the API's own error dict in `.payload`, so the offending field is never a guess.
+
+```python
+offers = bee.pricing("B0GTMTZF3V")
+for offer in offers["pricing"]:
+    print(offer["seller"], offer["price"], offer["condition"])
+```
+
+Each offer carries `seller`, `seller_id`, `seller_link`, `condition`, `price`, `price_shipping`, `currency`, `rating_count` and a `delivery_options` list.
+
+Related: [Amazon offers API](https://www.scrapingbee.com/scrapers/amazon-offers-api/), [Amazon seller API](https://www.scrapingbee.com/scrapers/amazon-seller-api/), [Amazon vendor API](https://www.scrapingbee.com/scrapers/amazon-vendor-api/), [Amazon shipping API](https://www.scrapingbee.com/scrapers/amazon-shipping-api/).
+
+### `usage()`
+
+`GET /api/v1/usage`. **Free.**
+
+```python
+bee.usage()
+# {'max_api_credit': 1000000, 'used_api_credit': 353946,
+#  'max_concurrency': 100, 'current_concurrency': 0,
+#  'renewal_subscription_date': '2026-09-21T12:06:28'}
+```
+
+Call this before a large run. Note it lags by minutes, so do not read it immediately afterwards to compute what a batch cost.
+
+---
+
+## Placement helpers
+
+Amazon search markup gives every card the same classes, so CSS selectors cannot tell a paid slot from an earned rank. The endpoint labels each result instead, which turns the problem into a filter.
+
+Per product placement fields:
+
+| Field | Type | Meaning |
+|---|---|---|
+| `is_sponsored` | bool | Paid placement |
+| `sponsored_position` | int or None | Rank among the ads |
+| `organic_position` | int or None | Rank among earned results |
+| `is_amazons_choice` | bool | Amazon's Choice badge |
+| `best_seller` | bool | Best Seller badge |
+| `sales_volume` | str | For example `10K+ bought in past month` |
+
+```python
+page = bee.search("fitness tracker", sort_by="featured")
+
+AmazonScraper.featured(page)   # sponsored, ordered by ad slot
+AmazonScraper.organic(page)    # earned, ordered by organic rank
+AmazonScraper.badged(page)     # Amazon's Choice or Best Seller
+AmazonScraper.facets(page)     # the refinements object
+```
+
+Two live runs on the same query returned 7 featured of 24 products, then 9 of 26. Paid density moves between requests, so measure it rather than assuming a fixed ratio.
+
+`is_prime` came back `False` on every row of both pages, so verify it against your own target category before building a Prime filter on it.
+
+---
+
+## Credit cost
+
+Measured from `spb-cost` response headers, not quoted from a pricing page. This client stores the value on `bee.last_cost` after every call.
+
+| Call | Credits |
+|---|---|
+| Search, default light request | 5 per page |
+| Search, `light_request=False` | 15 per page |
+| Product, default | 5 |
+| Product, `light_request=False` | 15 |
+| Pricing | 5 |
+| Any screenshot | 15 |
+| Rejected request | 0 |
+| `usage()` | 0 |
+
+Light requests skip the browser. They were sufficient for search, product and pricing on every call made here. Turn them off when you need review text or other content that appears only after JavaScript runs.
+
+Failed requests are retried inside the API for up to 30 seconds, so set client timeouts above that. This client defaults to 60 seconds.
+
+Plan tiers: [ScrapingBee pricing](https://www.scrapingbee.com/pricing).
+
+---
+
+## Scope
+
+Public Amazon listing and product pages. Nothing in this package signs in, and scraping under login credentials is prohibited by ScrapingBee's terms of service.
+
+## Related features
+
+[AI web scraping](https://www.scrapingbee.com/features/ai-web-scraping-api/), [data extraction rules](https://www.scrapingbee.com/features/data-extraction/), [Amazon feature page](https://www.scrapingbee.com/features/amazon/), [screenshots](https://www.scrapingbee.com/features/screenshot/), [markdown scraper](https://www.scrapingbee.com/features/markdown-scraper/), [Make integration](https://www.scrapingbee.com/features/make/), [n8n integration](https://www.scrapingbee.com/features/n8n/), [Zapier integration](https://www.scrapingbee.com/features/zapier/).
+
+The no code version of this workflow, with the Make scenario and the extraction rules, is at [github.com/ScrapingBee/nocode-amazon](https://github.com/ScrapingBee/nocode-amazon).
+
+## License
+
+MIT

nocode_amazon-0.0.1/src/nocode_amazon.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+src/nocode_amazon/__init__.py
+src/nocode_amazon/client.py
+src/nocode_amazon.egg-info/PKG-INFO
+src/nocode_amazon.egg-info/SOURCES.txt
+src/nocode_amazon.egg-info/dependency_links.txt
+src/nocode_amazon.egg-info/requires.txt
+src/nocode_amazon.egg-info/top_level.txt

nocode_amazon-0.0.1/src/nocode_amazon.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

nocode_amazon-0.0.1/src/nocode_amazon.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.25.0

nocode_amazon-0.0.1/src/nocode_amazon.egg-info/top_level.txt

@@ -0,0 +1 @@
+nocode_amazon