{"id":15039323,"url":"https://github.com/oxylabs/amazon-scraper","last_synced_at":"2025-05-14T06:12:54.953Z","repository":{"id":134336519,"uuid":"571924887","full_name":"oxylabs/amazon-scraper","owner":"oxylabs","description":"Free Trial Amazon Scraper API for extracting search, product, offer listing, reviews, question and answers, best sellers and sellers data.","archived":false,"fork":false,"pushed_at":"2025-04-09T08:46:56.000Z","size":387,"stargazers_count":1663,"open_issues_count":5,"forks_count":53,"subscribers_count":18,"default_branch":"main","last_synced_at":"2025-04-12T05:59:41.336Z","etag":null,"topics":["amazon-aip","amazon-api","amazon-api-data","amazon-price-tracker","amazon-product-scraper","amazon-products-api","amazon-scrape-api","amazon-scraper","amazon-scraper-api","amazon-scraping","amazon-scraping-library","e-commerce-api","how-to-scrape-amazon","price-scraper","price-scraper-api","python","scrape-amazon","scraping-amazon","scraping-api","web-scraping"],"latest_commit_sha":null,"homepage":"https://oxylabs.io/products/scraper-api/ecommerce/amazon?utm_source=git-internal\u0026utm_medium=github\u0026utm_campaign=repo\u0026utm_content=oxylabs/amazon-scraper","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oxylabs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-11-29T07:18:14.000Z","updated_at":"2025-04-11T19:42:41.000Z","dependencies_parsed_at":"2024-03-25T10:25:40.363Z","dependency_job_id":"e359bab8-ee0c-43a7-b990-c9f38193cd72","html_url":"https://github.com/oxylabs/amazon-scraper","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oxylabs%2Famazon-scraper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oxylabs%2Famazon-scraper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oxylabs%2Famazon-scraper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oxylabs%2Famazon-scraper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oxylabs","download_url":"https://codeload.github.com/oxylabs/amazon-scraper/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254080897,"owners_count":22011520,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amazon-aip","amazon-api","amazon-api-data","amazon-price-tracker","amazon-product-scraper","amazon-products-api","amazon-scrape-api","amazon-scraper","amazon-scraper-api","amazon-scraping","amazon-scraping-library","e-commerce-api","how-to-scrape-amazon","price-scraper","price-scraper-api","python","scrape-amazon","scraping-amazon","scraping-api","web-scraping"],"created_at":"2024-09-24T20:42:26.400Z","updated_at":"2025-05-14T06:12:54.878Z","avatar_url":"https://github.com/oxylabs.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Amazon_scraper (1)](https://raw.githubusercontent.com/oxylabs/amazon-scraper/refs/heads/main/Amazon-Scraper-API-1090x275.png)](https://oxylabs.go2cloud.org/aff_c?offer_id=7\u0026aff_id=877\u0026url_id=86) \n\n[![](https://dcbadge.vercel.app/api/server/eWsVUJrnG5)](https://discord.com/invite/Pds3gBmKMH)\n\n# Amazon Scraper\n\n- [Free Amazon Scraper](#free-amazon-scraper)\n    + [Prerequisites](#prerequisites)\n    + [Installation](#installation)\n    + [Retrieving the URL of an Amazon page to scrape](#retrieving-the-url-of-an-amazon-page-to-scrape)\n    + [Scraping Amazon product data](#scraping-amazon-product-data)\n    + [Retrieved data](#retrieved-data)\n    + [Notes](#notes)\n- [Scraping with Oxylabs API](#scraping-with-oxylabs-api)\n    + [URL](#url)\n    + [Search](#search)\n    + [Product](#product)\n    + [Offer listing](#offer-listing)\n    + [Reviews](#reviews)\n    + [Questions and Answers](#questions-and-answers)\n    + [Best Sellers](#best-sellers)\n    + [Sellers](#sellers)\n\n### Free Amazon Scraper\n\nA free tool used to get Amazon product data for any provided Amazon department page.\n\n### Prerequisites\n\nTo run this tool, you need to have Python 3.11 installed in your system.\n\n### Installation\n\nOpen up a terminal window, navigate to this repository and run this command:\n\n```make install```\n\n### Retrieving the URL of an Amazon page to scrape\n\nFirst off, open up Amazon and select a department from which you want to scrape. \n\nFor this example, we'll be using the `Computers \u0026 Accessories` department.\n\n\u003cimg width=\"1014\" alt=\"image\" src=\"https://github.com/user-attachments/assets/36fb8ec6-b678-4c6d-8fa1-12801dee6135\"\u003e\n\nAfter the page loads, simply copy the URL in the browser and save it. We'll need it for scraping product data for that department.\n\n### Scraping Amazon product data\n\nTo get data for products listed on the department page you chose, simply run this command in your terminal:\n\n```make scrape URL=\"\u003camazon_department_page_url\u003e\"```\n\nWith the URL we retrieved earlier, the command would look like this:\n\n```make scrape URL=\"https://www.amazon.com/s?i=specialty-aps\u0026bbn=16225009011\u0026rh=n%3A%2116225009011%2Cn%3A541966\u0026ref=nav_em__nav_desktop_sa_intl_computers_and_accessories_0_2_5_6\"```\n\nMake sure to surround the URL with quotation marks, otherwise the tool might have trouble parsing it.\n\nAfter running the command, your terminal should look something like this:\n\n\u003cimg width=\"1033\" alt=\"image\" src=\"https://github.com/user-attachments/assets/3ad1bb49-1047-4c1e-a036-0e344da67aef\"\u003e\n\nIf a listed product is out of stock, the tool will notify you with a message, as shown above.\n\n### Retrieved data\n\nAfter the tool has finished running, you should see a file named `amazon_products.csv` in your directory.\n\nThe generated CSV file contains data with these columns inside it:\n\n- `title` - The title of the product.\n- `url` - The URL pointing to the product's Amazon page.\n- `asin_code` - The product's unique ASIN code.\n- `image_url` - The URL of the image that contains the product.\n- `price` - The price of the product. This field can be empty, if the product is out of stock.\n\nThe data should look something like this:\n\n\u003cimg width=\"698\" alt=\"image\" src=\"https://github.com/user-attachments/assets/6b4ac4eb-5d8c-4414-874a-3c69c5bc3e08\"\u003e\n\n### Notes\n\nIn case the code doesn't work or your project is of bigger scale, please refer to the second part of the tutorial. There, we showcase how to scrape public data with Oxylabs Scraper API.\n\n### Scraping with Oxylabs API\n\nAlternatively, you can use Oxylabs Amazon Scraper API to get publicly-available data from any page on Amazon (reviews, pricing, product information, etc.) To access the tool, you'll need a paid subscription or the **7-day free trial** – claim it [here](https://oxy.yt/Xahk). \n\nHere is a quick overview of all the available data `source` values we support with Amazon: \n\n| Source               | Description                                                  | Structured data     |\n| -------------------- | ------------------------------------------------------------ | ------------------- |\n| `amazon`             | Submit any Amazon URL you like.                              | Depends on the URL. |\n| `amazon_bestsellers` | List of best seller items in a taxonomy node of your choice. | Yes                 |\n| `amazon_pricing`     | List of offers available for an ASIN of your choice.         | Yes.                |\n| `amazon_product`     | Product page of an ASIN of your choice.                      | Yes.                |\n| `amazon_questions`   | Q\\\u0026A page of an ASIN of your choice.                         | Yes.                |\n| `amazon_reviews`     | Reviews page of an ASIN of your choice.                      | Yes.                |\n| `amazon_search`      | Search results for a search term of your choice.             | Yes.                |\n| `amazon_sellers`     | Seller information of a seller of your choice.               | Yes.                |\n\n### URL\n\nThe `amazon` source is designed to retrieve the content from various Amazon URLs. Instead of sending multiple parameters, you can provide us with a direct URL to the required Amazon page. We don't strip any parameters or alter your URLs in any way.\n\n#### **Query parameters**\n\n| Parameter                                                   | Description                                                                                                                                       | Default Value |\n| ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |\n|  \u003cmark style=\"background-color:green;\"\u003e**`source`**\u003c/mark\u003e  | Data source.                                              | `amazon`           |\n|  \u003cmark style=\"background-color:green;\"\u003e**`url`**\u003c/mark\u003e     | Direct URL (link) to Amazon page                                                                                                                  | -             |\n| `user_agent_type`                                           | Device type and browser. The full list can be found [**here**](https://developers.oxylabs.io/scraper-apis/serp-scraper-api/features/user-agent-type). | `desktop`     |\n| `render`                                                    | Enables JavaScript rendering. [**More info.**](https://developers.oxylabs.io/scraper-apis/serp-scraper-api/features/javascript-rendering)                         | -             |\n| `callback_url`                                              | URL to your callback endpoint. [**More info**](https://developers.oxylabs.io/scraper-apis/serp-scraper-api/integration-methods/push-pull#callback).                     | -             |\n| `parse`                                                     | `true` will return structured data, as long as the URL submitted is for one of the [page types we can parse](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/amazon).                                       | `false`       |\n\n\u0026#x20;   \u003cmark style=\"background-color:green;\"\u003e\u003c/mark\u003e - required parameter\n\n#### Python code example\n\nIn the code example below, we make a request to retrieve the Amazon product page for `B0BDJ279KF` .\n\n```python\nimport requests\nfrom pprint import pprint\n\n\n# Structure payload.\npayload = {\n    'source': 'amazon',\n    'url': 'https://www.amazon.co.uk/dp/B0BDJ279KF',\n    'parse': True\n}\n\n# Get response.\nresponse = requests.request(\n    'POST',\n    'https://realtime.oxylabs.io/v1/queries',\n    auth=('YOUR_USERNAME', 'YOUR_PASSWORD'), #Your credentials go here\n    json=payload,\n)\n\n# Instead of response with job status and results url, this will return the\n# JSON response with results.\npprint(response.json())\n```\n\nTo see the response example with retrieved data, download [**this** **sample output**](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiwDdoZGfMbUe5cRL2417%2Fuploads%2FTsZ8TZKgQe4y7BT6DgKg%2Famazon.json?alt=media\\\u0026token=be9d00d0-d3e3-443b-be67-26cbdbcabc5d) in JSON format.\n\n### Search\n\nThe `amazon_search` source is designed to retrieve Amazon search result pages.\n\n#### Query parameters\n\n| Parameter                                                   | Description                                                                                                                                       | Default Value   |\n| ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- |\n|  \u003cmark style=\"background-color:green;\"\u003e**`source`**\u003c/mark\u003e  | Data source.                                             | `amazon_search` |\n| `domain`                                                    | Domain localization for Amazon. The full list of available domains can be found [**here**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/domain-locale-results-language#domain).                           | `com`           |\n|  \u003cmark style=\"background-color:green;\"\u003e**`query`**\u003c/mark\u003e   | UTF-encoded keyword                                                                                                                               | -               |\n| `start_page`                                                | Starting page number                                                                                                                              | `1`             |\n| `pages`                                                     | Number of pages to retrieve                                                                                                                       | `1`             |\n| `geo_location`                                              | The _Deliver to_ location. See our guide to using this parameter [**here**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/geo-location#amazon)**.**                               | -               |\n| `user_agent_type`                                           | Device type and browser. The full list can be found [**here**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/user-agent-type). | `desktop`       |\n| `render`                                                    | Enables JavaScript rendering. [**More info.**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/javascript-rendering)                         | -               |\n| `callback_url`                                              | URL to your callback endpoint. [**More info**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/integration-methods/push-pull#callback).                     | -               |\n| `parse`                                                     | `true` will return structured data.                                           | -               |\n| \u003cp\u003e\u003ccode\u003econtext\u003c/code\u003e:\u003cbr\u003e\u003ccode\u003ecategory_id\u003c/code\u003e\u003c/p\u003e    | Search for items in a particular browse node (product category).                                                                                  | -               |\n| \u003cp\u003e\u003ccode\u003econtext\u003c/code\u003e:\u003cbr\u003e\u003ccode\u003emerchant_id\u003c/code\u003e\u003c/p\u003e    | Search for items sold by a particular seller.                                                                                                     | -               |\n\n\u0026#x20;   \u003cmark style=\"background-color:green;\"\u003e\u003c/mark\u003e - required parameter\n\n#### Python code example\n\nIn the code example below, we make a request to retrieve product page for ASIN `3AA17D2BRD4YMT0X` on `amazon.nl` marketplace. In case the ASIN provided is a parent ASIN, we ask Amazon to return a product page of an automatically-selected variation.\n\n```python\nimport requests\nfrom pprint import pprint\n\n\n# Structure payload.\npayload = {\n    'source': 'amazon_search',\n    'domain': 'nl',\n    'query': 'adidas',\n    'start_page': 11,\n    'pages': 10,\n    'parse': True,\n    'context': [\n        {'key': 'category_id', 'value': 16391843031},\n        {'key': 'merchant_id', 'value':'3AA17D2BRD4YMT0X'}\n    ],\n}\n\n\n# Get response.\nresponse = requests.request(\n    'POST',\n    'https://realtime.oxylabs.io/v1/queries',\n    auth=('user', 'pass1'),\n    json=payload,\n)\n\n# Print prettified response to stdout.\npprint(response.json())\n```\n\nTo see the response example with retrieved data, download [**this** **sample output**](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiwDdoZGfMbUe5cRL2417%2Fuploads%2Fyg8tdLTqrajAxhtjiuR5%2Famazon\\_search.json?alt=media\\\u0026token=f02b1ceb-70f6-45cd-9f7c-7247196b2bd6) file in JSON format.\n \n### Product\n\nThe `amazon_product` data source is designed to retrieve Amazon product pages.\n\n#### Query parameters\n\n| Parameter                                                       | Description                                                                                                                                                                                                                                                                | Default Value    |\n| --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- |\n|  \u003cmark style=\"background-color:green;\"\u003e**`source`**\u003c/mark\u003e      | Data source.                                                                                                                                                                      | `amazon_product` |\n| `domain`                                                        | Domain localization for Amazon. The full list of available domains can be found [**here**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/domain-locale-results-language#domain).                                                                                                                                                    | `com`            |\n|  \u003cmark style=\"background-color:green;\"\u003e**`query`**\u003c/mark\u003e       | 10-symbol ASIN code                                                                                                                                                                                                                                                        | -                |\n| `geo_location`                                                  | The _Deliver to_ location. See our guide to using this parameter [**here**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/geo-location#amazon)**.**                                                                                                                                                        | -                |\n| `user_agent_type`                                               | Device type and browser. The full list can be found [**here**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/user-agent-type).                                                                                                                          | `desktop`        |\n| `render`                                                        | Enables JavaScript rendering. [**More info.**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/javascript-rendering)                                                                                                                                                 |                  |\n| `callback_url`                                                  | URL to your callback endpoint. [**More info**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/integration-methods/push-pull#callback).                                                                                                                                              | -                |\n| `parse`                                                         | `true` will return structured data.                                                                                                                                                           | -                |\n| \u003cp\u003e\u003ccode\u003econtext\u003c/code\u003e:\u003cbr\u003e\u003ccode\u003eautoselect_variant\u003c/code\u003e\u003c/p\u003e | To get accurate pricing/buybox data, set this parameter to `true` (which tells us to append the `th=1\u0026psc=1` URL parameters to the end of the product URL). To get an accurate representation of the parent ASIN's product page, omit this parameter or set it to `false`. | `false`          |\n\n\u0026#x20; \u003cmark style=\"background-color:green;\"\u003e\u003c/mark\u003e - required parameter\n\n#### Python code example\n\nIn the code example below, we make a request to retrieve product page for ASIN `B09RX4KS1G`on `amazon.nl` marketplace. In case the ASIN provided is a parent ASIN, we ask Amazon to return a product page of an automatically-selected variation.\n\n```python\nimport requests\nfrom pprint import pprint\n\n\n# Structure payload.\npayload = {\n    'source': 'amazon_product',\n    'domain': 'nl',\n    'query': 'B09RX4KS1G',\n    'parse': True,\n    'context': [\n    {\n      'key': 'autoselect_variant', 'value': True\n    }],\n}\n\n\n# Get response.\nresponse = requests.request(\n    'POST',\n    'https://realtime.oxylabs.io/v1/queries',\n    auth=('user', 'pass1'),\n    json=payload,\n)\n\n# Print prettified response to stdout.\npprint(response.json())\n```\n\nTo see the response example with retrieved data, download [**this** **sample output**](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiwDdoZGfMbUe5cRL2417%2Fuploads%2Fjj4ahNp1FpIqjY2JcSqz%2Famazon\\_product.json?alt=media\\\u0026token=42016a49-9790-4671-9022-bb0feed79d1a) file in JSON format.\n\n### Offer listing\n\nThe `amazon_pricing` data source is designed to retrieve Amazon product offer listings.\n\n#### Query parameters\n\n| Parameter                                                   | Description                                                                                                                                       | Default Value    |\n| ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- |\n|  \u003cmark style=\"background-color:green;\"\u003e**`source`**\u003c/mark\u003e  | Data source.                                              | `amazon_pricing` |\n| `domain`                                                    | Domain localization for Amazon. The full list of available domains can be found [**here**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/domain-locale-results-language#domain).                           | `com`            |\n|  \u003cmark style=\"background-color:green;\"\u003e**`query`**\u003c/mark\u003e   | 10-symbol ASIN code                                                                                                                               | -                |\n| `start_page`                                                | Starting page number                                                                                                                              | `1`              |\n| `pages`                                                     | Number of pages to retrieve                                                                                                                       | `1`              |\n| `geo_location`                                              | The _Deliver to_ location. See our guide to using this parameter [**here**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/geo-location#amazon).                                   | -                |\n| `user_agent_type`                                           | Device type and browser. The full list can be found [**here**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/user-agent-type). | `desktop`        |\n| `render`                                                    | Enables JavaScript rendering. [**More info.**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/javascript-rendering)                         |                  |\n| `callback_url`                                              | URL to your callback endpoint. [**More info**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/integration-methods/push-pull#callback).                     | -                |\n| `parse`                                                     | `true` will return structured data.                             | -                |\n\n\u0026#x20;   \u003cmark style=\"background-color:green;\"\u003e\u003c/mark\u003e - required parameter\n\n#### Python code example\n\nIn the code examples below, we make a request to retrieve product offer listing page for ASIN `B09RX4KS1G` on `amazon.nl`\u0026#x20; marketplace.\n\n```python\nimport requests\nfrom pprint import pprint\n\n\n# Structure payload.\npayload = {\n    'source': 'amazon_pricing',\n    'domain': 'nl',\n    'query': 'B09RX4KS1G',\n    'parse': True,\n}\n\n\n# Get response.\nresponse = requests.request(\n    'POST',\n    'https://realtime.oxylabs.io/v1/queries',\n    auth=('user', 'pass1'),\n    json=payload,\n)\n\n# Print prettified response to stdout.\npprint(response.json())\n```\n\nTo see what the parsed output looks like, download [**this**](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiwDdoZGfMbUe5cRL2417%2Fuploads%2FhGVtkmLp7gccwTLCJzLY%2Famazon\\_pricing.json?alt=media\\\u0026token=a30a8253-225f-44c2-880b-850e94e23c21) JSON file.\n \n### Reviews\n\nThe `amazon_reviews` data source is designed to retrieve Amazon product review pages of an ASIN of your choice.\n\n#### Query parameters\n\n| Parameter                                                   | Description                                                                                                                                       | Default Value    |\n| ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- |\n|  \u003cmark style=\"background-color:green;\"\u003e**`source`**\u003c/mark\u003e  | Data source.                                              | `amazon_reviews` |\n| `domain`                                                    | Domain localization for Amazon. The full list of available domains can be found [**here**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/domain-locale-results-language#domain).                           | `com`            |\n|  \u003cmark style=\"background-color:green;\"\u003e**`query`**\u003c/mark\u003e   | 10-symbol ASIN code                                                                                                                               | -                |\n| `geo_location`                                              | The _Deliver to_ location. See our guide to using this parameter [**here**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/geo-location#amazon).                                   | -                |\n| `user_agent_type`                                           | Device type and browser. The full list can be found [**here**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/user-agent-type). | `desktop`        |\n| `start_page`                                                | Starting page number                                                                                                                              | `1`              |\n| `pages`                                                     | Number of pages to retrieve                                                                                                                       | `1`              |\n| `render`                                                    | Enables JavaScript rendering. [**More info.**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/javascript-rendering)                         |                  |\n| `callback_url`                                              | URL to your callback endpoint. [**More info**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/integration-methods/push-pull#callback).                     | -                |\n| `parse`                                                     | `true` will return structured data.                                  | -                |\n\n\u0026#x20;   \u003cmark style=\"background-color:green;\"\u003e\u003c/mark\u003e - required parameter\n\n#### Python code example\n\n```python\nimport requests\nfrom pprint import pprint\n\n\n# Structure payload.\npayload = {\n    'source': 'amazon_reviews',\n    'domain': 'nl',\n    'query': 'B09RX4KS1G',\n    'parse': True,\n}\n\n\n# Get response.\nresponse = requests.request(\n    'POST',\n    'https://realtime.oxylabs.io/v1/queries',\n    auth=('user', 'pass1'),\n    json=payload,\n)\n\n# Print prettified response to stdout.\npprint(response.json())\n```\n\nTo see the response example with retrieved data, download this [**sample** **output**](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiwDdoZGfMbUe5cRL2417%2Fuploads%2F4Fx7BNOyFLw4rU6dJGDH%2Famazon\\_reviews.json?alt=media\\\u0026token=f1845f29-2286-41a3-9ac5-834a89b345c5) file in JSON format.\n\n### Questions and Answers\n\nThe `amazon_questions` data source is designed to retrieve any particular product's Questions \u0026 Answers pages.\n\n#### Query parameters\n\n| Parameter                                                   | Description                                                                                                                                       | Default Value      |\n| ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |\n|  \u003cmark style=\"background-color:green;\"\u003e**`source`**\u003c/mark\u003e  | Data source.                                              | `amazon_questions` |\n| `domain`                                                    | Domain localization for Amazon. The full list of available domains can be found [**here**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/domain-locale-results-language#domain).                           | `com`              |\n|  \u003cmark style=\"background-color:green;\"\u003e**`query`**\u003c/mark\u003e   | 10-symbol ASIN code                                                                                                                               | -                  |\n| `geo_location`                                              | The _Deliver to_ location. See our guide to using this parameter [**here**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/geo-location#amazon).                                   | -                  |\n| `user_agent_type`                                           | Device type and browser. The full list can be found [**here**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/user-agent-type). | `desktop`          |\n| `render`                                                    | Enables JavaScript rendering. [**More info.**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/javascript-rendering)****                         |                    |\n| `callback_url`                                              | URL to your callback endpoint. [**More info**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/integration-methods/push-pull#callback).                     | -                  |\n| `parse`                                                     | `true` will return structured data.                   | -                  |\n\n\u0026#x20;   \u003cmark style=\"background-color:green;\"\u003e\u003c/mark\u003e - required parameter\n\n#### Python code example\n\n```python\nimport requests\nfrom pprint import pprint\n\n\n# Structure payload.\npayload = {\n    'source': 'amazon_questions',\n    'domain': 'nl',\n    'query': 'B09RX4KS1G',\n    'parse': True,\n}\n\n\n# Get response.\nresponse = requests.request(\n    'POST',\n    'https://realtime.oxylabs.io/v1/queries',\n    auth=('user', 'pass1'),\n    json=payload,\n)\n\n# Print prettified response to stdout.\npprint(response.json())\n```\n\nTo see the response example with retrieved data, download this [**sample** **output**](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiwDdoZGfMbUe5cRL2417%2Fuploads%2F1i8qUTsaifrfTht9VdXK%2Famazon\\_questions.json?alt=media\\\u0026token=a59d9850-d79b-40bc-a2a6-bdd802eafd6b) file in JSON format.\n\n### Best Sellers\n\nThe `amazon_bestsellers` data source is designed to retrieve Amazon Best Sellers pages.\n\n#### Query parameters\n\n| Parameter                                                   | Description                                                                                                                                       | Default Value        |\n| ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- |\n|  \u003cmark style=\"background-color:green;\"\u003e**`source`**\u003c/mark\u003e  | Data source.                                              | `amazon_bestsellers` |\n| `domain`                                                    | Domain localization for Amazon. The full list of available domains can be found [**here**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/domain-locale-results-language#domain).                           | `com`                |\n| `query`                                                     | Department name. Example: `Clothing, Shoes \u0026 Jewelry`                                                                                             | -                    |\n| `start_page`                                                | Starting page number                                                                                                                              | `1`                  |\n| `pages`                                                     | Number of pages to retrieve                                                                                                                       | `1`                  |\n| `geo_location`                                              | The _Deliver to_ location. See our guide to using this parameter [**here**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/geo-location#amazon).                                   | -                    |\n| `user_agent_type`                                           | Device type and browser. The full list can be found [**here**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/user-agent-type). | `desktop`            |\n| `render`                                                    | Enables JavaScript rendering. [**More info.**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/javascript-rendering)                        |                      |\n| `callback_url`                                              | URL to your callback endpoint. [**More info**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/integration-methods/push-pull#callback).                     | -                    |\n| `parse`                                                     | `true` will return structured data.                                                                                                               | -                    |\n| \u003cp\u003e\u003ccode\u003econtext\u003c/code\u003e:\u003cbr\u003e\u003ccode\u003ecategory_id\u003c/code\u003e\u003c/p\u003e    | Search for items in a particular browse node (product category).                                                                                  | -                    |\n\n\u0026#x20;   \u003cmark style=\"background-color:green;\"\u003e\u003c/mark\u003e - required parameter\n\n#### Python code example\n\n```python\nimport requests\nfrom pprint import pprint\n\n\n# Structure payload.\npayload = {\n    'source': 'amazon_bestsellers',\n    'domain': 'de',\n    'query': 'automotive',\n    'start_page': 2,\n    'parse': True,\n    'context': [\n        {'key': 'category_id', 'value': 82400031},\n    ],\n}\n\n\n# Get response.\nresponse = requests.request(\n    'POST',\n    'https://realtime.oxylabs.io/v1/queries',\n    auth=('user', 'pass1'),\n    json=payload,\n)\n\n# Print prettified response to stdout.\npprint(response.json())\n```\n\nTo see the response example with retrieved data, download this [**sample output**](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiwDdoZGfMbUe5cRL2417%2Fuploads%2Frf2S2YKKlEEhu4cCoW6b%2Famazon\\_bestsellers.json?alt=media\\\u0026token=6b4b3817-5a6e-4095-96b0-81d8d9d0883f) file in JSON format.\n\n### Sellers\n\nThe `amazon_sellers` data source is designed to retrieve Amazon Sellers pages.\u0026#x20;\n\n#### Query parameters\n\n| Parameter                                                   | Description                                                                                                                                                                                                                                                                      | Default Value    |\n| ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- |\n|  \u003cmark style=\"background-color:green;\"\u003e**`source`**\u003c/mark\u003e  | Data source.                                                                                                                                                                             | `amazon_sellers` |\n| `domain`                                                    | Domain localization for Amazon. The full list of available domains can be found [**here**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/domain-locale-results-language#domain).                                                                                                                                                          | `com`            |\n|  \u003cmark style=\"background-color:green;\"\u003e**`query`**\u003c/mark\u003e   | 13-character seller ID                                                                                                                                                                                                                                                           | -                |\n| `geo_location`                                              | The _Deliver to_ location. See our guide to using this parameter [**here**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/geo-location#amazon).                                                                                                                                                                  | -                |\n| `user_agent_type`                                           | Device type and browser. The full list can be found [**here**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/user-agent-type).                                                                                                                                | `desktop`        |\n| `render`                                                    | Enables JavaScript rendering. [**More info.**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/features/javascript-rendering)                                                                                                                                                        |                  |\n| `callback_url`                                              | URL to your callback endpoint. [**More info**](https://developers.oxylabs.io/scraper-apis/e-commerce-scraper-api/integration-methods/push-pull#callback).                                                                                                                                                    | -                |\n| `parse`                                                     | `true` will return structured data. Please note that right now we only support parsed output for `desktop` device type. However, there is no apparent reason to get sellers pages with any other device type, as seller data is going to be exactly the same across all devices. | -                |\n\n\u0026#x20;   \u003cmark style=\"background-color:green;\"\u003e\u003c/mark\u003e - required parameter\n\n#### Python code example\n\nIn the code examples below, we make a request to retrieve the seller page for seller ID `ABNP0A7Y0QWBN` on `amazon.de` marketplace.\n\n```python\nimport requests\nfrom pprint import pprint\n\n\n# Structure payload.\npayload = {\n    'source': 'amazon_sellers',\n    'domain': 'de',\n    'query': 'ABNP0A7Y0QWBN',\n    'parse': True\n}\n\n\n# Get response.\nresponse = requests.request(\n    'POST',\n    'https://realtime.oxylabs.io/v1/queries',\n    auth=('user', 'pass1'),\n    json=payload,\n)\n\n# Print prettified response to stdout.\npprint(response.json())\n```\nCheck out our list of [Best Web Scraping Tools](https://medium.com/@oxylabs.io/top-12-best-web-scraping-tools-for-2024-ba5deb1b3851)\n\nLooking to scrape more other Amazon data? [Amazon Review Scraper](https://github.com/oxylabs/amazon-review-scraper), [Amazon ASIN Scraper](https://github.com/oxylabs/amazon-asin-scraper), [Bypass Amazon CAPTCHA](https://github.com/oxylabs/how-to-bypass-amazon-captcha), [How to Scrape Amazon Prices](https://github.com/oxylabs/how-to-scrape-amazon-prices), [Scraping Amazon Product Data](https://github.com/oxylabs/how-to-scrape-amazon-product-data)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foxylabs%2Famazon-scraper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foxylabs%2Famazon-scraper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foxylabs%2Famazon-scraper/lists"}