This tutorial shows how to scrape Amazon Best Sellers and adjacent Amazon top-list pages into CSV with the Amazon Top Lists Scraper template for UScraper. You will import the workflow, validate the first rows, and let pagination append the remaining product cards.
Before you start
Prerequisites and source checks
You need UScraper installed, the current JSON from the Amazon Top Lists Scraper template, one approved Amazon top-list URL, and a local folder for the CSV. Start small: open the official Amazon Best Sellers page, choose one category, and treat the first run as validation rather than production.
Top-list pages are useful for product discovery, category research, FBA scans, and merchandising reviews. They are not a sanctioned bulk data feed. Before automating, review Amazon's robots.txt, current Conditions of Use, and the official Product Advertising API documentation if you need approved programmatic access.
Compliance first: collect only data you are allowed to access, keep runs modest, do not defeat CAPTCHA or access controls, and get legal review before commercial reuse.
Workflow anatomy
What the Amazon Top Lists Scraper does
The bundled workflow follows a simple loop: Navigate -> Wait for Page Load -> Wait for Element -> Structured Export -> Element Exists -> Click Next -> wait and repeat. It starts at https://www.amazon.com/gp/bestsellers/, waits for ranking-card layouts, exports matching rows, checks for an enabled Next pagination link, and stops when the list ends.
The export is best-effort because Amazon may show CAPTCHA, bot checks, redirects, unavailable product cards, or updated selectors. Review the first CSV while the browser is still open.
| Workflow part | What to check | Why it matters |
|---|---|---|
| Navigate | The Best Sellers or top-list URL you are allowed to process | Controls the category and marketplace represented in the CSV. |
| Wait for Element | Product-card selectors such as gridItemRoot variants | Prevents export before list cards finish rendering. |
| Structured Export | Filename, save folder, headers, append mode, and 9 columns | Creates the spreadsheet you will audit and reuse. |
| Element Exists and Click | Enabled Amazon Next pagination link | Appends additional pages until no active next page remains. |
Runbook
How to scrape Amazon Best Sellers to CSV
Choose the top-list page
Keep the default Best Sellers URL or replace it with a specific Amazon category page you are allowed to review. Avoid mixing marketplaces in one test run.
Confirm the export destination
In Structured Export, confirm amazon_top_lists_scraper_suite.csv, headers, append mode, and a project-specific local save folder.
Run one page first
Export the first page, then pause. Compare rank, title, product URL, image URL, price, rating, and review count against the browser.
Resume pagination
Continue the Next loop only after the first page passes QA. Stop if the URL does not advance, product cards vanish, or Amazon shows an access page.
After export, sort by list_name, subcategory, and rank_position. Save the source URL list, run date, marketplace, and template version beside the CSV.
Output
What the CSV export includes
The Amazon Top Lists Scraper is an amazon top products scraper for visible ranking pages, not a deep product-detail crawler.
| CSV column | Meaning | QA check |
|---|---|---|
list_name | Best Sellers page title, selected list label, or document title fallback | Confirm it matches the category you opened. |
subcategory | Category hint inferred from the product link when available | Treat blanks as acceptable when the URL does not expose a clean hint. |
rank_position | Visible rank badge or fallback position | Compare the first five rows against the page. |
title | Product title or image alt text fallback | Watch for truncated titles and layout changes. |
product_url | Canonical Amazon product URL when an ASIN is available | Use it for dedupe and follow-up detail checks. |
image_url | Primary product image URL from the card | Open samples before using images in reports. |
price | Visible price text | Expect blanks where Amazon hides or omits price. |
rating | Visible star-rating text | Locale and layout changes can alter formatting. |
review_count | Parsed visible ratings or review count | Compare several rows before trend analysis. |
Decision point
Amazon Best Sellers API alternative vs scraper workflow
Use UScraper when you need a supervised CSV from visible pages, editable selectors, an inspectable no-code flow, and local file output for research or review.
Amazon's own Best Sellers Rank explainer and PA-API browse nodes and sales ranks documentation are worth reading before treating scraped rows as sales-rank truth. A list export is still a snapshot of what rendered in the browser.
Troubleshooting
Common issues when scraping Amazon top lists
| Symptom | Likely cause | Fix |
|---|---|---|
| CSV is empty | Product cards did not render or the selector no longer matches | Reopen one category, wait for the page, and inspect the row selector. |
| Access or CAPTCHA page appears | Amazon challenged the session | Stop the run. Do not bypass access controls. |
| Price cells are blank | Amazon did not render price for those cards | Keep the blank value and validate manually. |
| Duplicate products appear | Same ASIN surfaced across categories or pagination repeated | Dedupe downstream by ASIN or canonical product_url. |
| Pagination repeats | Next clicked before the page changed | Increase waits and stop if URL or rank range does not advance. |
FAQ
Amazon Best Sellers scraper FAQ
Public visibility does not automatically grant unrestricted automation rights. Review Amazon's current Conditions of Use, robots directives, marketplace policies, intellectual property rights, privacy obligations, and local law. Do not bypass CAPTCHA, login walls, account controls, paywalls, or other access restrictions.
Next step
Download the Amazon Top Lists Scraper template
When you are ready, download the JSON from Amazon Top Lists Scraper, run one category, validate every column, then expand the source list only after the CSV matches the browser. For adjacent workflows, browse all UScraper templates or the UScraper blog.