# Changelog
Source: https://docs.easyscraper.com/changelog

Product updates

<Update label="v1.4.0">
  ## ✨ New

  * Added ability to scrape details from current list without uploading a CSV
  * Added comprehensive documentation site (you're looking at it!)
</Update>

<Update label="v1.3.6">
  ## 🔔 Changes

  * Modified bundled code to resolve Chrome Web Store warning
</Update>

<Update label="v1.3.5">
  ## ✨ New

  * Added "Copy" button to copy table to clipboard

  ## 🛠 Fixed

  * Fixed bug where "next page" or "load more" button wouldn't be clicked if it was outside of the viewport
</Update>

<Update label="v1.3.4">
  ## ✨ New

  * Added tip when a list is downloaded to inform users about how to scrape details pages

  ## 🛠 Fixed

  * Fixed bug where the maximum wait time was always used when waiting for new items to load rather than until new items appear
  * Fixed bug that prevented selecting elements that are not links or buttons as the "Next page" or "Load more" element
</Update>

<Update label="v1.3.3">
  ## 🔔 Changes

  * Updated name of extension to "Easy Scraper — One-click web scraper"
</Update>

<Update label="v1.3.2">
  ## 🔔 Changes

  * Made element mask more responsive to scrolling by removing throttle

  ## 🛠 Fixed

  * Translated text for instructions when selecting an element
</Update>

<Update label="v1.3.1">
  ## ✨ New

  * Added "Max items" option to limit the number of items when scraping a list

  ## 🛠 Fixed

  * Prevent field description from being cut-off by the edge of the screen when building a new details scraper
  * Fixed bug where non-Latin word characters were sanitized in filenames
  * Fixed bug where downloaded CSV files were not explicitly encoded as UTF-8, potentially leading to non-Latin characters being garbled if applications opened them as US-ASCII (the default for `text` MIME types)
</Update>

<Update label="v1.3.0">
  ## 🔔 Changes

  * Added warning when URL column name appears to be a URL which may indicate that the header row is missing
  * Generate more reliable text selectors by using only words without numbers if possible
  * Generate a wider variety of selectors to increase stability for details scrapers

  ## 🛠 Fixed

  * Fixed bug where newline at end of uploaded CSV resulted in an extra row being displayed in the preview
</Update>

<Update label="v1.2.0">
  ## ✨ New

  * Added localization for all languages
</Update>

<Update label="v1.1.9">
  ## 🔔 Changes

  * Remove restriction on Google Maps
</Update>

<Update label="v1.1.7">
  ## 🔔 Changes

  * Increased usage condition to trigger rate alert
</Update>

<Update label="v1.1.6">
  ## ✨ New

  * Added localization for Chinese

  ## 🛠 Fixed

  * Fixed bug where links without href were missing from scraped data
</Update>

<Update label="v1.1.5">
  ## 🛠 Fixed

  * Fixed bug where next page was not detected for some client-side navigation (e.g. houzz.com)
</Update>

<Update label="v1.1.4">
  No changes: Used to change name of extension
</Update>

<Update label="v1.1.3">
  No changes: Used for submitting a separate beta build
</Update>

<Update label="v1.1.2">
  ## 🔔 Changes

  * Help button moved to navigation bar
</Update>

<Update label="v1.1.1">
  ## 🔔 Changes

  * Added overlay when recordings a details page scraper

  ## 🛠 Fixed

  * Fixed bug where incorrect error message was shown when extension is opened while navigating
  * Fixed bug where list data was cleared after navigating to details tab
  * Fixed bug where details scraper data was not automatically cleared after changing scrapers
  * Fixed bug where list wasn't highlighted when extension is opened
</Update>

<Update label="v1.1.0">
  ## ✨ New

  * Details Scrapers! 🎉
    * Upload a CSV of URLs and scrape each page

  ## 🔔 Changes

  * Added timestamp to downloaded filenames

  ## 🛠 Fixed

  * Fixed bug where error was shown when extension was opened while page is loading
  * Fixed bug where element mask lagged when scrolling
  * Fixed bug where element mask didn't update when window is resized
  * Fixed bug where element mask disappeared after scrolling a lot
</Update>

<Update label="v1.0.4">
  ## ✨ New

  * Spinner is shown on page while scraping
  * Warning is shown when trying to close popup while scraping

  ## 🛠 Fixed

  * Fixed bug where no data was loaded after reloading popup
</Update>

<Update label="v1.0.3">
  ## 🛠 Fixed

  * Fixed bug where extension sometimes crashed when resizing a column
  * Fixed bug where next page cannot be scraped after service worker goes inactive
  * Fixed bug where page is not cleaned up when closing popup after service worker goes inactive
</Update>

<Update label="v1.0.2">
  ## 🔔 Changes

  * Updated heuristic for selecting a list when the extension is opened

  ## 🛠 Fixed

  * Fixed delay when selecting an element due to slow selector generation
</Update>

<Update label="v1.0.1">
  ## 🔔 Changes

  * Increased minimum wait time from 1 second to 2 seconds when clicking link to next page for better reliability (e.g. scraping yelp.com)

  ## 🛠 Fixed

  * Fixed bug where instructions to select element showed up with bad styles due to host page
  * Fixed bug where extension crashed when scraping a field with a CSS class that included a period
  * Fixed bug where extension crashed when resizing a column while scraping lots of data
</Update>

<Update label="v1.0.0">
  ## ✨ New

  * Initial release! 🎉
</Update>


# Page Details Scraping
Source: https://docs.easyscraper.com/details-scraping

Extract data from multiple individual pages using a list of URLs

## Overview

Details scraping (also called "page scraping" or "URL scraping") allows you to extract specific data from multiple individual pages. Instead of scraping a list from one page, you provide a list of URLs and Easy Scraper visits each URL to extract the data you specify.

**Use cases:**

* Extract product details from a list of product URLs
* Gather article content from multiple blog posts
* Collect company information from business profile pages
* Scrape property details from real estate listings
* Extract contact information from multiple profile pages

## How Page Details Scraping Works

<Steps>
  <Step title="Provide URLs">
    Give Easy Scraper a list of URLs to visit. This can come from:

    * URLs scraped from a list
    * A CSV file you upload
  </Step>

  <Step title="Define data to extract">
    Create a scraper by selecting which fields to extract from each page. You do this by visiting a test URL and clicking on the elements you want to scrape.
  </Step>

  <Step title="Run the scraper">
    Easy Scraper visits each URL, extracts the data, and compiles it into a table that you can export.
  </Step>
</Steps>

## Step-by-Step Guide

### Step 1: Select URLs

<Tabs>
  <Tab title="From List Scraping">
    The easiest way to get URLs for details scraping is from a list scraping result.

    <Steps>
      <Step title="Scrape a list">
        First, use [List Scraping](/list-scraping) to scrape a list that includes URLs (links to detail pages).
      </Step>

      <Step title="Click 'Scrape each URL'">
        After list scraping completes, click the "Scrape each URL" button at the top of the results.
      </Step>

      <Step title="Select the URL field">
        Choose which field from your list scraping results contains the URLs you want to visit.
      </Step>
    </Steps>

    <Tip>
      This workflow is ideal for scraping e-commerce products: first scrape the product list to get URLs, then scrape each product page for detailed information.
    </Tip>
  </Tab>

  <Tab title="Upload CSV">
    You can also upload a CSV file containing URLs.

    <Steps>
      <Step title="Prepare your CSV">
        Create a CSV file with a header row. One column should contain the URLs you want to scrape.

        Example:

        ```csv  theme={null}
        product_url,product_name
        https://example.com/product1,Product 1
        https://example.com/product2,Product 2
        ```
      </Step>

      <Step title="Upload the file">
        In the Details tab, click "Upload CSV" and select your file.
      </Step>

      <Step title="Select URL column">
        Choose which column contains the URLs. Easy Scraper will show you a preview of the URLs.
      </Step>
    </Steps>

    <Warning>
      Make sure your CSV includes a header row. If Easy Scraper detects that your URLs might be in the first row, it will warn you.
    </Warning>
  </Tab>
</Tabs>

### Step 2: Select Data to Extract

Now you need to tell Easy Scraper what data to extract from each page.

<Steps>
  <Step title="Select a test URL">
    Select a test URL from the list of URLs you provided. This should be a representative page that has all the data you want to extract.
  </Step>

  <Step title="Click 'Select data to extract'">
    This opens the test page and enters "recording mode" where you can click on elements to select them.
  </Step>

  <Step title="Click on elements">
    Click on each piece of data you want to extract. For example:

    * Product title
    * Price
    * Description
    * Images
    * Specifications

    Each click adds a new field to your scraper. The extension will show you an overlay as you select each field.
  </Step>

  <Step title="Review the preview">
    After selecting your fields, Easy Scraper shows you a preview of the extracted data. Check that all fields are captured correctly.
  </Step>

  <Step title="Name your fields">
    Give each field a descriptive name (e.g., "Product Title", "Price", "Main Image URL"). This helps you identify the data in your export.
  </Step>
</Steps>

<Note>
  Easy Scraper generates smart selectors for each element that work across multiple pages of the same website. The selectors are designed to be reliable even if the exact HTML structure varies slightly between pages.
</Note>

### Step 3: Name Your Scraper (Optional)

Your scraper is automatically saved to your browser for future reuse.

<Steps>
  <Step title="Name your scraper">
    Give your scraper a descriptive name (e.g., "Amazon Product Details", "Blog Article Scraper").
  </Step>

  <Step title="Automatic save">
    The scraper is automatically saved to your browser and associated with the website's domain.
  </Step>

  <Step title="Reuse later">
    Next time you scrape pages from the same website, you can select your saved scraper instead of creating a new one.
  </Step>
</Steps>

#### Managing Saved Scrapers

<Accordion title="Export a scraper">
  Click the export button to save your scraper as a JSON file. This allows you to share scrapers with others or move scrapers between browsers.
</Accordion>

<Accordion title="Import a scraper">
  Click the import button and select a previously exported scraper JSON file.
</Accordion>

<Accordion title="Delete a scraper">
  Click the delete button to remove a scraper you no longer need.
</Accordion>

<Accordion title="Rename a scraper">
  Edit the scraper name field and the new name is automatically saved.
</Accordion>

### Step 4: Run the Scraper

<Steps>
  <Step title="Configure wait times">
    Set how long to wait between visiting each page:

    * **Min wait time**: Minimum delay between pages (default: 1s)
    * **Max wait time**: Maximum time to wait for page to load (default: 3s)

    <Warning>
      Scraping too quickly may trigger rate limiting or anti-bot measures on some websites. Use appropriate wait times to be respectful of server resources.
    </Warning>
  </Step>

  <Step title="Click 'Start Scraping'">
    Easy Scraper will visit each URL in sequence and extract the data.
  </Step>

  <Step title="Monitor progress">
    The extension shows you:

    * Number of pages scraped
    * Number of pages remaining
    * Current page being scraped
  </Step>

  <Step title="View results">
    Once complete, all extracted data is displayed in a table. Each row represents one page, and each column represents one field you selected.
  </Step>
</Steps>

### Step 5: Export Your Data

After scraping completes, export your data in your preferred format:

* **Download CSV**: Best for spreadsheet applications
* **Download JSON**: Best for programmatic use
* **Copy to Clipboard**: Copy as TSV to paste directly into Excel, Google Sheets, or other applications

## Field Types

Details scrapers can extract the same three types of data as list scrapers:

| Type          | Description                   | Examples                                      |
| ------------- | ----------------------------- | --------------------------------------------- |
| **Text**      | Visible text content          | Product names, descriptions, prices, headings |
| **Link URL**  | The `href` attribute of links | Related product URLs, external references     |
| **Image URL** | The `src` attribute of images | Product photos, thumbnails, logos             |

<Tip>
  When selecting an element, Easy Scraper automatically detects whether to extract text, a link, or an image URL based on the element type.
</Tip>

## Tips for Successful Page Details Scraping

<AccordionGroup>
  <Accordion title="Choose a good test URL">
    Select a test URL that has all the data you want to extract. Some pages may be missing optional fields, so test with a complete example.
  </Accordion>

  <Accordion title="Be specific when selecting elements">
    Click directly on the element containing the data you want. Don't click on parent containers unless you want all the text from that container.
  </Accordion>

  <Accordion title="Test with a small sample first">
    Before scraping hundreds of URLs, test with just 5-10 URLs to ensure your scraper is working correctly. You can always run it again on all URLs.
  </Accordion>

  <Accordion title="Use appropriate wait times">
    * Fast websites: 1-2 seconds between pages
    * Slow websites: 3-5+ seconds
    * If you're getting incomplete data, increase the max wait time
  </Accordion>

  <Accordion title="Handle missing data gracefully">
    Not all pages will have all fields. Empty fields will appear as blank cells in your export, which is normal.
  </Accordion>

  <Accordion title="Name your scrapers">
    Your scrapers are automatically saved. Give them descriptive names so you can easily find and reuse them for similar pages in the future.
  </Accordion>
</AccordionGroup>

## Common Issues and Solutions

<AccordionGroup>
  <Accordion title="Field is empty for some pages">
    **Problem:** A field works on the test URL but is empty for other URLs.

    **Solutions:**

    * The element may not exist on some pages (this is normal)
    * Content may be loaded dynamically - increase the max wait time
    * Check if the website uses different templates for different pages
  </Accordion>

  <Accordion title="Scraper stops before finishing all URLs">
    **Problem:** Details scraping stops before visiting all URLs.

    **Solutions:**

    * Check your browser console for errors
    * The website may have rate limiting - increase wait times and try again
    * Some URLs may be invalid or return errors - check your URL list
  </Accordion>

  <Accordion title="Extracted data is incorrect">
    **Problem:** The scraper extracts the wrong data or includes extra content.

    **Solutions:**

    * Use "Verify" on the test URL to see exactly what's being selected
    * Try clicking more precisely on the exact element you want
    * Remove the field and select it again
  </Accordion>

  <Accordion title="Can't reuse a saved scraper on similar pages">
    **Problem:** A scraper that works on one domain doesn't work on another similar website.

    **Solutions:**

    * Scrapers are domain-specific by design
    * Create a new scraper for the new domain
    * You can export the old scraper and manually modify the JSON if the sites are very similar
  </Accordion>

  <Accordion title="Upload CSV shows wrong URLs">
    **Problem:** After uploading a CSV, the wrong column is being detected as URLs.

    **Solutions:**

    * Make sure your CSV has a header row
    * Manually select the correct column from the dropdown
    * Check that URLs are properly formatted (include `https://` or `http://`)
  </Accordion>
</AccordionGroup>

<Card title="Learn List Scraping" icon="arrow-left" href="/list-scraping">
  Learn how to scrape lists of items with URLs that you can use for details scraping
</Card>


# FAQ
Source: https://docs.easyscraper.com/faq

Frequently asked questions

## General Questions

<AccordionGroup>
  <Accordion title="Is Easy Scraper free?">
    Yes, Easy Scraper is currently free to use. You can scrape as many pages as you need without any subscription or payment.
  </Accordion>

  <Accordion title="Which browsers are supported?">
    Easy Scraper works on all Chromium-based browsers including:

    * Google Chrome
    * Microsoft Edge
    * Brave
    * Opera
    * Vivaldi

    Note: Easy Scraper is not compatible with Firefox or Safari.
  </Accordion>

  <Accordion title="Do I need coding knowledge to use Easy Scraper?">
    No! Easy Scraper is designed for everyone. You interact with a visual interface - just click on the data you want to extract. No coding, programming, or technical knowledge required.
  </Accordion>

  <Accordion title="Is my data private?">
    Yes. All scraping happens locally in your browser. The data you scrape is stored only on your device and is never sent to Easy Scraper's servers. Your scraped data remains completely private.
  </Accordion>

  <Accordion title="Can I scrape any website?">
    Technically, Easy Scraper can attempt to scrape most websites. However:

    * You should always respect the website's Terms of Service
    * Some websites have technical measures that prevent scraping
    * Some content may be protected by copyright
    * Always scrape ethically and responsibly
  </Accordion>

  <Accordion title="What languages does Easy Scraper support?">
    Easy Scraper supports multiple languages including English, Spanish, French, German, Chinese, Japanese, and more. The interface automatically adapts to your browser's language settings.
  </Accordion>
</AccordionGroup>

## Getting Started

<AccordionGroup>
  <Accordion title="How do I install Easy Scraper?">
    1. Visit the [Chrome Web Store](https://easyscraper.com/install)
    2. Click "Add to Chrome" (or your browser's equivalent)
    3. Confirm the installation
    4. Pin the extension to your toolbar for easy access

    See the [Getting Started](/index) guide for detailed instructions.
  </Accordion>

  <Accordion title="Why doesn't Easy Scraper detect any lists on my page?">
    This can happen for several reasons:

    * The page is still loading - wait a few seconds and refresh
    * The page doesn't have a repeating list structure
    * The list uses a complex or non-standard layout
    * Content is loaded dynamically - try scrolling or interacting with the page first

    If you're sure there's a list on the page, try refreshing and waiting longer for the page to fully load.
  </Accordion>

  <Accordion title="How do I know what data I can extract?">
    Easy Scraper can extract three types of data:

    1. **Text content** - Any visible text on the page
    2. **Links (URLs)** - The href attribute from link elements
    3. **Images (URLs)** - The src attribute from image elements

    The extension automatically detects which type to extract based on the element you click.
  </Accordion>

  <Accordion title="Can I scrape data from multiple pages?">
    Yes! Easy Scraper supports pagination through:

    * **Infinite scroll** - Automatically scrolls to load more items
    * **Next page buttons** - Clicks "Next" or page numbers
    * **Load more buttons** - Clicks "Load More" or "Show More"

    See the [List Scraping](/list-scraping) guide for details.
  </Accordion>
</AccordionGroup>

## List Scraping

<AccordionGroup>
  <Accordion title="Why are some items missing from my scraped list?">
    Common causes:

    * **Wait time too short**: Items didn't finish loading before scraping moved on
    * **Scroll issues**: Page didn't scroll far enough to trigger loading
    * **Rate limiting**: Website blocked further requests
    * **Max items limit**: You set a limit on the number of items

    **Solutions:**

    * Increase the max wait time in your configuration
    * Add a scroll delay
    * Reduce scraping speed to avoid rate limiting
    * Remove or increase the max items limit
  </Accordion>

  <Accordion title="How do I scrape a paginated list?">
    1. Start scraping the first page normally
    2. In the scraping configuration, choose a load more option:
       * "Scroll Down" for infinite scroll
       * "Click Next Page Button" for pagination
    3. Configure wait times
    4. Optionally set a max items limit
    5. Start scraping

    See the [Pagination Options](/list-scraping#pagination-options) section for detailed instructions.
  </Accordion>

  <Accordion title="Why do I have duplicate items in my results?">
    This can happen when:

    * The page has multiple instances of the same list
    * Pagination loads items that were already scraped
    * The page structure causes the same elements to be detected multiple times

    **Solutions:**

    * Check if the page has duplicate content
    * Refresh and try again
    * After exporting, remove duplicates in your spreadsheet application
  </Accordion>

  <Accordion title="What's the maximum number of items I can scrape?">
    There's no hard limit, but practical considerations include:

    * Browser memory (very large scrapes may slow down or crash)
    * Website rate limiting (sites may block excessive requests)
    * Time (scraping thousands of items can take hours)

    **Recommendation:** For large scrapes, use the "Max items" limit to scrape in smaller batches.
  </Accordion>
</AccordionGroup>

## Page Details Scraping

<AccordionGroup>
  <Accordion title="What's the difference between list scraping and page details scraping?">
    * **List scraping**: Extracts multiple items from a single page (e.g., product listings)
    * **Page details scraping**: Visits multiple URLs and extracts data from each individual page (e.g., product detail pages)

    They work great together: use list scraping to get URLs, then use page details scraping to get more information from each URL.
  </Accordion>

  <Accordion title="How do I get URLs for page details scraping?">
    Two ways:

    1. **From list scraping**: Scrape a list that includes URLs, then click "Scrape each URL"
    2. **Upload a CSV**: Upload a CSV file with a column containing URLs

    See the [Page Details Scraping guide](/details-scraping) for step-by-step instructions.
  </Accordion>

  <Accordion title="Can I reuse a scraper I created?">
    Yes! When creating a details scraper:

    1. Select your fields as normal
    2. Give your scraper a descriptive name
    3. It's automatically saved
    4. Next time you scrape pages from the same domain, select your saved scraper from the dropdown

    You can also export scrapers as JSON files to back them up or share them.
  </Accordion>

  <Accordion title="Why doesn't my saved scraper work on different pages?">
    Scrapers are domain-specific and designed for pages with similar structure. If a scraper doesn't work:

    * The new pages may have a different HTML structure
    * Content may be in different locations or use different element types
    * You may need to create a new scraper for the new page type

    Test your scraper on a few examples before running it on many URLs.
  </Accordion>

  <Accordion title="Some fields are empty in my results. Is this normal?">
    Yes, this is completely normal! Not every page will have every field. For example:

    * Some products don't have reviews
    * Some listings don't have images
    * Optional fields may be blank for some items

    Empty fields will appear as blank cells in your export, which is expected behavior.
  </Accordion>

  <Accordion title="How many URLs can I scrape with page details scraping?">
    You can scrape as many URLs as you want, but consider:

    * **Time**: With 2-3 second delays, 100 URLs takes 3-5 minutes, 1000 URLs takes 30-50 minutes
    * **Rate limiting**: Scraping too many pages too quickly may trigger anti-bot measures
    * **Browser performance**: Keep the browser window active for best results

    **Recommendation:** Test with 10-20 URLs first, then scale up once you're confident the scraper works correctly.
  </Accordion>
</AccordionGroup>

## Technical Issues

<AccordionGroup>
  <Accordion title="Easy Scraper isn't opening or is showing a blank screen">
    **Solutions:**

    1. Refresh the page you're on and try again
    2. Close and reopen the extension
    3. Restart your browser
    4. Check if the extension is enabled (check chrome://extensions/)
    5. Try updating to the latest version of the extension
    6. Clear your browser cache and cookies
  </Accordion>

  <Accordion title="The extension stopped working mid-scrape">
    This can happen if:

    * You closed the popup window
    * The browser tab became inactive (some browsers throttle background tabs)
    * You ran out of memory
    * The website blocked further requests

    **Solutions:**

    * Keep the popup window open while scraping
    * Keep the browser tab active (don't minimize or switch away)
    * Close other tabs if you're running out of memory
    * Increase wait times and try again
  </Accordion>

  <Accordion title="Data isn't appearing or is incomplete">
    **Common causes and solutions:**

    **For dynamically loaded content:**

    * Increase the max wait time to 5-10 seconds
    * Manually interact with the page before scraping

    **For timing issues:**

    * Add a scroll delay (500-1000ms)
    * Increase min wait times between actions

    **For JavaScript-heavy sites:**

    * Let the page fully load before opening the extension
    * Wait for loading spinners to disappear
    * Some sites may not be compatible with scraping
  </Accordion>

  <Accordion title="I'm getting 'Element not found' errors">
    This means the scraper couldn't find the element using its selector. This happens when:

    * The page structure is different from the test page
    * Content hasn't loaded yet
    * The website changed its HTML structure

    **Solutions:**

    * Increase wait times
    * Remove and re-add the field
    * Create a new scraper if the website changed significantly
    * Check if the element actually exists on the page
  </Accordion>

  <Accordion title="Scraping is very slow">
    Scraping speed depends on:

    * Your configured wait times (intentional delays)
    * How fast the website responds
    * How much data you're extracting

    This is normal - web scraping is inherently a slow process because you need to:

    * Wait for pages to load
    * Be respectful of server resources
    * Avoid triggering anti-bot measures

    **To speed up (carefully):**

    * Reduce min wait times
    * Reduce max wait times if pages load quickly
    * Remove unnecessary fields
  </Accordion>

  <Accordion title="I'm seeing CAPTCHA challenges">
    This means the website has detected automated access and is challenging you to prove you're human.

    **What to do:**

    1. Complete the CAPTCHA manually
    2. Slow down your scraping (increase wait times to 3-5+ seconds)
    3. Reduce the number of pages per session
    4. Take breaks between scraping sessions

    Frequent CAPTCHAs indicate the website doesn't want automated access. Consider if continuing is appropriate.
  </Accordion>
</AccordionGroup>

## Exporting Data

<AccordionGroup>
  <Accordion title="Which export format should I use?">
    * **CSV**: Best for Excel, Google Sheets, databases, and data analysis
    * **JSON**: Best for programming, APIs, and further processing with scripts
    * **Copy (TSV)**: Best for quickly pasting into spreadsheets or documents

    All formats contain the same data - choose based on what you plan to do with it.
  </Accordion>

  <Accordion title="Special characters look wrong in my CSV file">
    This is an encoding issue. Easy Scraper exports CSV files with UTF-8 encoding, which supports all international characters.

    **If you see garbled characters in Excel:**

    1. Don't double-click the CSV file to open it
    2. Open Excel first
    3. Use File > Import > CSV/Text File
    4. Choose UTF-8 encoding in the import wizard

    **If you see garbled characters in Google Sheets:**
    This shouldn't happen - Google Sheets handles UTF-8 automatically. Try uploading the file again.
  </Accordion>

  <Accordion title="Where are my exported files saved?">
    Downloaded files (CSV and JSON) are saved to your browser's default download location, typically:

    * Windows: `C:\Users\YourName\Downloads`
    * Mac: `/Users/YourName/Downloads`
    * Linux: `/home/YourName/Downloads`

    Check your browser's download settings to see or change the location.
  </Accordion>
</AccordionGroup>

## Best Practices

<AccordionGroup>
  <Accordion title="How can I scrape more reliably?">
    Follow these best practices:

    1. **Test first**: Always test with a small sample before full scrape
    2. **Use adequate wait times**: Don't rush - give pages time to load
    3. **Verify selectors**: Use the "Verify" button to check your selections
    4. **Monitor progress**: Watch the first few items to ensure everything works
    5. **Save your work**: Export data frequently and save scrapers for reuse
  </Accordion>

  <Accordion title="How fast can I scrape without getting blocked?">
    There's no universal answer, but general guidelines:

    * **Safe for most sites**: 2-3 seconds
    * **Conservative**: 3-5 seconds
    * **Very cautious**: 5-10 seconds

    If you're getting blocked or seeing CAPTCHAs, slow down significantly.
  </Accordion>

  <Accordion title="Is it legal to scrape websites?">
    Web scraping legality is complex and varies by jurisdiction. Generally:

    **Usually acceptable:**

    * Scraping publicly available data for personal use
    * Respecting robots.txt and Terms of Service
    * Using reasonable rate limits

    **Potentially problematic:**

    * Scraping copyrighted content for republication
    * Scraping personal data in violation of privacy laws (GDPR, CCPA)
    * Violating a website's Terms of Service
    * Scraping data behind authentication without permission
    * Using scraped data commercially without rights

    **Recommendation:** Always review the website's Terms of Service and robots.txt before scraping. When in doubt, seek legal advice.
  </Accordion>

  <Accordion title="Should I scrape during business hours?">
    Consider scraping during off-peak hours (evenings, weekends) for:

    * Large scraping jobs (hundreds or thousands of pages)
    * Websites that may have limited server capacity
    * Being extra respectful of server resources

    For small scrapes (dozens of pages), timing is less critical.
  </Accordion>
</AccordionGroup>

## Data and Privacy

<AccordionGroup>
  <Accordion title="What permissions does Easy Scraper need?">
    Easy Scraper requires certain browser permissions to function:

    * **Access to all websites**: Needed to scrape any website you visit
    * **Storage**: To save your scrapers and scraping data locally
    * **Active tab**: To interact with the page you're currently viewing

    These are standard permissions for web scraping extensions. Your data stays local on your device.
  </Accordion>

  <Accordion title="Does Easy Scraper collect my data?">
    No. All scraping happens locally in your browser. Easy Scraper does not:

    * Send your scraped data to any servers
    * Track what websites you scrape
    * Collect or store your personal information
    * Share your data with third parties

    Your scraped data and saved scrapers remain entirely on your device.
  </Accordion>

  <Accordion title="What happens to my scraped data?">
    Your scraped data is stored locally in your browser until you:

    * Export it (download CSV/JSON or copy to clipboard)
    * Clear your browser data
    * Uninstall the extension

    The data never leaves your computer unless you explicitly export and share it.
  </Accordion>
</AccordionGroup>

## Still Need Help?

<CardGroup cols={2}>
  <Card title="Report a Bug" icon="bug" href="https://easyscraper.com/report-bug">
    Found an issue? Let us know so we can fix it
  </Card>

  <Card title="Documentation" icon="book-open" href="/index">
    Read the full documentation and guides
  </Card>
</CardGroup>


# Getting Started
Source: https://docs.easyscraper.com/index

Install Easy Scraper and run your first scrape in minutes

## Installation

<Steps>
  <Step title="Install the extension">
    Install Easy Scraper from the [Chrome Web Store](https://easyscraper.com/install). The extension is compatible with all Chromium-based browsers including Chrome, Edge, Brave, and Opera.
  </Step>

  <Step title="Pin the extension">
    After installation, pin the Easy Scraper extension to your browser toolbar for easy access. Click the puzzle icon in your toolbar and click the pin icon next to Easy Scraper.
  </Step>
</Steps>

## Your First Scrape

Let's walk through a simple example to get you started.

<Steps>
  <Step title="Navigate to a website with a list">
    Go to any website that displays a list of items. For example, a search results page, product listings, or a blog with multiple articles.
  </Step>

  <Step title="Open Easy Scraper">
    Click the Easy Scraper icon in your browser toolbar. The extension will automatically detect lists on the page.
  </Step>

  <Step title="Configure your scrape">
    The extension will show you a preview of the detected list. You can:

    * Edit fields
    * Configure pagination options (scroll, next page, load more)
    * Set limits on the number of items to scrape
  </Step>

  <Step title="Start scraping">
    Click the "Start Scraping" button. Easy Scraper will extract the data and display it in a table.
  </Step>

  <Step title="Export your data">
    Download your data as CSV or JSON, or copy it to your clipboard to paste into a spreadsheet.
  </Step>
</Steps>

## What's Next?

Now that you've completed your first scrape, explore more advanced features:

<CardGroup cols={2}>
  <Card title="List Scraping Guide" icon="list" href="/list-scraping">
    Learn how to scrape lists with pagination and advanced options
  </Card>

  <Card title="Page Details Scraping Guide" icon="file-text" href="/details-scraping">
    Extract data from multiple individual pages using URLs
  </Card>

  <Card title="FAQ" icon="circle-question-mark" href="/faq">
    Find answers to common questions and troubleshooting tips
  </Card>
</CardGroup>

## Need Help?

If you run into any issues or have questions:

* Check the [FAQ](/faq) for common solutions
* [Report a bug](https://easyscraper.com/report-bug) if you encounter issues
* Read the detailed guides for [List Scraping](/list-scraping) and [Page Details Scraping](/details-scraping)


# List Scraping
Source: https://docs.easyscraper.com/list-scraping

Learn how to scrape lists of items from web pages

## Overview

List scraping allows you to extract multiple items from a web page, such as:

* Product listings from e-commerce sites
* Search results
* Article listings from blogs
* Directory entries
* Social media posts
* And much more

Easy Scraper automatically detects lists on the page and extracts data from each item.

## How to Scrape a List

<Steps>
  <Step title="Navigate to the page">
    Go to the webpage containing the list you want to scrape. Make sure the list is fully loaded before opening the extension.
  </Step>

  <Step title="Open Easy Scraper">
    Click the Easy Scraper icon in your browser toolbar. The extension will automatically detect lists on the page.
  </Step>

  <Step title="Review detected items">
    Easy Scraper will show you a preview of the detected items and fields. Each field represents a piece of data extracted from each item (e.g., title, price, link).
  </Step>

  <Step title="Configure fields">
    You can customize fields:

    * **Rename fields**: Click on the field name to edit it
    * **Highlight fields**: Click the search icon to highlight where the field data comes from
    * **Remove fields**: Click the delete icon next to any field you don't need
  </Step>

  <Step title="Configure pagination">
    If your list spans multiple pages or requires scrolling, configure the load more options (see [Pagination Options](#pagination-options) below).
  </Step>

  <Step title="Start scraping">
    Click "Start Scraping". Easy Scraper will extract all the data and display it in a table.
  </Step>

  <Step title="Export your data">
    Once scraping is complete, export your data:

    * **Download CSV**: Import into Excel or Google Sheets
    * **Download JSON**: Use in applications or scripts
    * **Copy**: Copy as tab-separated values to paste into spreadsheets
  </Step>
</Steps>

## Pagination Options

Easy Scraper supports four methods for handling pagination and loading more items:

### Option 1: None (No Additional Loading)

Use this when all items are already visible on the page. Easy Scraper will extract only the items currently displayed.

**Best for:**

* Single-page lists
* All items already loaded

### Option 2: Scroll down to load more items

Automatically scrolls to the bottom of the page to trigger loading of additional items. This works with infinite scroll implementations.

**Best for:**

* Infinite scroll pages (e.g., social media feeds)
* Pages that load more items as you scroll

**Configuration:**

* **Min wait time**: Minimum seconds to wait for new items to load (default: 1s)
* **Max wait time**: Maximum seconds to wait for new items to load (default: 3s)
* **Scroll delay**: Delay in milliseconds between scroll actions (helps with slow-loading pages)
* **Max items**: Limit the total number of items to scrape

<Tip>
  If items aren't loading, try increasing the max wait time or adding a scroll delay.
</Tip>

### Option 3: Click link to navigate to next page

Clicks a "Next Page" button to navigate to a different page URL.

**Best for:**

* Traditional pagination with numbered pages that change the URL
* "Next" links that navigate to a new page
* Pagination that dynamically replaces the current page content without URL changes

**Configuration:**

* **Next Page Button**: Click "Select" to choose the button/link to click
* **Min wait time**: Minimum seconds to wait for new items to load
* **Max wait time**: Maximum seconds to wait for new items to load
* **Auto-scroll**: Automatically scroll the page during scraping
* **Scroll delay**: Delay in milliseconds between scroll actions
* **Max items**: Limit the total number of items to scrape

<Steps>
  <Step title="Select the button">
    Click "Select" next to "Next Page Button" and then click the pagination button on the page.
  </Step>

  <Step title="Verify selection">
    Click "Verify" to ensure you've selected the correct button (it will be highlighted).
  </Step>

  <Step title="Configure wait times">
    Set appropriate wait times based on how long the page takes to load.
  </Step>
</Steps>

<Warning>
  Make sure the button you select actually navigates to a new page URL. If it loads more items on the same page, use Option 4 instead.
</Warning>

### Option 4: Click button to load more items on same page

Clicks a "Load More" or "Show More" button that adds additional items to the current page without navigating away.

**Best for:**

* "Load More" buttons that append items to the page
* "Show More" links that expand the list in-place

**Configuration:**

* **Load More Button**: Click "Select" to choose the button to click
* **Min wait time**: Minimum seconds to wait for new items to load
* **Max wait time**: Maximum seconds to wait for new items to load
* **Auto-scroll**: Automatically scroll the page during scraping
* **Scroll delay**: Delay in milliseconds between scroll actions
* **Max items**: Limit the total number of items to scrape

<Steps>
  <Step title="Select the button">
    Click "Select" next to "Load More Button" and then click the button that loads more items on the page.
  </Step>

  <Step title="Verify selection">
    Click "Verify" to ensure you've selected the correct button (it will be highlighted).
  </Step>

  <Step title="Configure wait times">
    Set appropriate wait times based on how long new items take to load after clicking.
  </Step>
</Steps>

<Tip>
  This option is ideal when clicking the button adds more items to the current page rather than navigating to a new URL. If the button navigates to a different page, use Option 3 instead.
</Tip>

## Field Types

Easy Scraper can extract three types of data from each field:

<Accordion title="Text Content">
  Extracts the visible text content of an element.

  **Examples:**

  * Product names
  * Prices
  * Descriptions
  * Headings

  **How it works:** The extension reads the text content from the selected HTML element.
</Accordion>

<Accordion title="Link URLs (href)">
  Extracts the URL from a link element.

  **Examples:**

  * Product page URLs
  * Article links
  * External references

  **How it works:** Extracts the `href` attribute from `<a>` (link) elements. Automatically converts relative URLs to absolute URLs.

  <Tip>
    These URLs can be used later with [Page Details Scraping](/details-scraping) to extract data from each linked page.
  </Tip>
</Accordion>

<Accordion title="Image URLs (src)">
  Extracts image URLs from image elements.

  **Examples:**

  * Product images
  * Thumbnails
  * Profile pictures
  * Icons

  **How it works:** Extracts the `src` attribute from `<img>` elements or background images from elements with CSS background-image properties.
</Accordion>

## Tips for Successful List Scraping

<AccordionGroup>
  <Accordion title="Let the page fully load">
    Before opening Easy Scraper, wait for the page to fully load. If content is still loading, the extension may not detect all items.
  </Accordion>

  <Accordion title="Start with a small test">
    When scraping large lists, start by setting a low "Max items" limit (e.g., 10-20 items) to test your configuration before running a full scrape.
  </Accordion>

  <Accordion title="Use appropriate wait times">
    * For fast websites: Use shorter wait times (1-2 seconds)
    * For slow websites: Increase wait times (3-5 seconds)
    * Add a scroll delay if items aren't loading properly
  </Accordion>

  <Accordion title="Watch for dynamic content">
    Some websites load content dynamically. If you're not getting all the data, try:

    * Increasing wait times
    * Adding a scroll delay
    * Manually scrolling before starting the scrape
  </Accordion>

  <Accordion title="Check your data quality">
    After scraping, review the data table to ensure:

    * All fields are populated correctly
    * URLs are complete (not broken)
    * No missing or duplicate items
  </Accordion>
</AccordionGroup>

## Common Issues and Solutions

<AccordionGroup>
  <Accordion title="No list detected">
    **Problem:** Easy Scraper says "No list detected" when you open it.

    **Solutions:**

    * Make sure the page has fully loaded
    * Check that the page actually contains a list of repeating items
    * Try refreshing the page and waiting a few seconds before opening the extension
    * Some pages use complex layouts that may not be automatically detected
  </Accordion>

  <Accordion title="Missing items">
    **Problem:** Not all items are being scraped.

    **Solutions:**

    * If using scroll mode, increase the max wait time
    * Add a scroll delay to give the page time to load
    * Try using "Click Next Page" instead of scroll if pagination buttons exist
    * Check if the website has rate limiting or anti-scraping measures
  </Accordion>

  <Accordion title="Duplicate items">
    **Problem:** The same items appear multiple times in the results.

    **Solutions:**

    * Check if the page has multiple identical lists
    * Try removing and re-adding fields
    * Refresh the page and start over
  </Accordion>

  <Accordion title="Empty or incorrect field data">
    **Problem:** Some fields are empty or contain wrong data.

    **Solutions:**

    * Use "Verify" to check that the field selector is correct
    * Remove the field and add it again by selecting the correct element
    * Make sure you're clicking the right element when adding fields
    * Some data may be loaded dynamically - try waiting longer before scraping
  </Accordion>

  <Accordion title="Scraping stops before all pages">
    **Problem:** Scraping stops before reaching the last page.

    **Solutions:**

    * Increase the max wait time for page loads
    * Check if the "Next Page" button selector is still valid on later pages
    * Some websites may block scraping after a certain number of requests
    * Try reducing the scraping speed by increasing wait times
  </Accordion>
</AccordionGroup>

## Next Steps

After scraping a list, you can:

1. **Export the data** for analysis or use in other applications
2. **Scrape details from each URL** using [Page Details Scraping](/details-scraping)
3. **Save your configuration** by creating a reusable scraper

<Card title="Learn Page Details Scraping" icon="arrow-right" href="/details-scraping">
  Take your scraped URLs and extract detailed information from each page
</Card>