src/routes.js

# First, specify the base Docker image. You can read more about
# the available images at https://sdk.apify.com/docs/guides/docker-images
# You can also use any other image from Docker Hub.
FROM apify/actor-node:16

# Second, copy just package.json and package-lock.json since those are the only
# files that affect "npm install" in the next step, to speed up the build.
COPY package*.json ./

# Install NPM packages, skip optional and development dependencies to
# keep the image small. Avoid logging too much and print the dependency
# tree for debugging
RUN npm --quiet set progress=false \
 && npm install --only=prod --no-optional \
 && echo "Installed NPM packages:" \
 && (npm list || true) \
 && echo "Node.js version:" \
 && node --version \
 && echo "NPM version:" \
 && npm --version

# Next, copy the remaining files and directories with the source code.
# Since we do this after NPM install, quick build will be really fast
# for most source file changes.
COPY . ./

# Optionally, specify how to launch the source code of your actor.
# By default, Apify's base Docker images define the CMD instruction
# that runs the Node.js source code using the command specified
# in the "scripts.start" section of the package.json file.
# In short, the instruction looks something like this:
#
# CMD npm start


Dockerfile

Max items

It's required to use proxies when running on the platform.

Choose what proxies you are going to use.

Proxy configuration

Start URLs

eBay items scraper

INPUT_SCHEMA.json

Scrape and download product information without the limitations of the [eBay API](https://developer.ebay.com), including but not limited to reviews, prices, or product descriptions.

eBay Items Scraper extracts all and any items from any category page on eBay or by the specific keyword, provided you copy&paste the search URL. Download your data as HTML or Excel table, as well as in JSON, CSV or XML format. 

**How to use the data extracted from eBay:**
- **Establish automated price and bidding monitoring** -  scan dozens e-commerce items and products  in real-timeto adjust your own buying or pricing strategies.
- **Track competitors' prices** - track listings, product, and sales data from various online stores to compare with competitor's and bidder's prices, and back up your decision-making process with real data. 
- **Facilitate market analysis** - scan and analyze eBay for images, products, related keywords, whole new categories and more to stay ahead of emerging trends and consumer habits. 
- **Optimize performance and implement lightweight automation** - collect data about products easily, non-manually, be it for market research, machine learning or new product development.

For more ideas on how to use data extracted from eBay, check out our  [industries pages](https://apify.com/industries) which describe **at least 12 ways** of how web scraping data is used across the projects and businesses of various scale and direction, specifically in the area of [retail and e-commerce](https://apify.com/industries/ecommerce-and-retail).

## Tutorial
If you want to know more about how the eBay Scraper works, here's a detailed explanation and [step-by-step guide](https://blog.apify.com/how-to-scrape-ebay-and-extract-listings-data/) with screenshots and examples.

## Cost of usage
Keep in mind that it is much more efficient to run one longer scrape (at least one minute) than a few shorter ones.  because of the startup time. In average, this scraper will cost you around **0.63 USD** per 1000 items. For more details, see the [platform pricing page](https://apify.com/pricing/actors).
If you’re not sure how much CUs you have left on your plan and whether you might need to upgrade, you can always check your limits in the *Settings -> Usage and Billing* tab in  [your Console](https://console.apify.com/). The easiest way to know how many CUs you will need is to *perform a test run.*

## Input Parameters
This actor will need only two settings from you - **a link** and a **proxy**: 
 - **startUrls** *(required)*: List of [Request objects](https://sdk.apify.com/docs/api/request#docsNav), specifying the search queries/categories you want to scrape. The URL can be any search/category page on eBay.
 - **proxyConfiguration** *(required)*: Specifies the proxy settings used while running the actor. When running this actor on the platform, the proxy setting must always be set on. The default value is  `{ "useApifyProxy": true }`

### Example
```json
{
  "startUrls": [
    {
      "url": "https://www.ebay.com/sch/i.html?_from=R40&_trksid=p2499334.m570.l1313&_nkw=massage%2Brecliner%2Bchair&_sacat=6024"
    },
    {
      "url": "https://www.ebay.com/sch/i.html?_from=R40&_trksid=p2334524.m570.l1313&_nkw=motor+parts&_sacat=0&LH_TitleDesc=0"
    },
    {
      "url": "https://www.ebay.com/sch/i.html?_from=R40&_trksid=p2334524.m570.l1313&_nkw=bicycle+handlebars&_sacat=0&LH_TitleDesc=0"
    }
  ],
  "maxItems": 10,
  "proxyConfig": {
    "useApifyProxy": true
  }
}
```

## Output
After the eBay actor finishes the scraping run, it will store the scraped results in a dataset and show them to you as output results. The results can be downloaded in various formats. 

### Output example:
```json
[{
  "url": "https://www.ebay.com/itm/164790739659",
  "categories": [
    "Camera Drones",
    "Other RC Model Vehicles & Kits"
  ],
  "itemNumber": "164790739659",
  "title": "2021 New RC Drone 4k HD Wide Angle Camera WIFI FPV Drone Dual Camera Quadcopter",
  "subTitle": "US Stock! Fast Shipping! Highest Quality! Best Service!",
  "whyToBuy": [
    "Free shipping and returns",
    "1,403 sold",
    "Ships from United States"
  ],
  "price": 39,
  "priceWithCurrency": "US $39.00",
  "wasPrice": 41.05,
  "wasPriceWithCurrency": "US $41.05",
  "available": 10,
  "availableText": "More than 10 available",
  "sold": 1,
  "image": "https://i.ebayimg.com/images/g/pp4AAOSwKtRgZPzC/s-l300.jpg",
  "seller": "everydaygadgetz",
  "itemLocation": "Alameda, California, United States",
  "ean": null,
  "mpn": null,
  "upc": "Does not apply",
  "brand": "Unbranded",
  "type": "Professional Drone"
}]
```
Note that the search results may vary if you're executing scraping from different locations. We recommend to use the proxies for the best scraping results from the same location.

## Proxy usage
This actor, as many scrapers in the [retail industry](https://apify.com/industries/ecommerce-and-retail), will require you to use **Proxy servers** to function properly. 
We don't recommend running it on a free account for more complicated tasks than getting a sample of results. If you are planning to run this scraper for getting more than a few results, subscribing to the [Apify platform](https://console.apify.com/sign-up) will provide you with access to a large pool of proxies. 

## Supported countries
This actor supports scraping eBay in the following countries and domains:
* 🇺🇸 **US** - https://www.ebay.com
* 🇬🇧 **GB** - https://www.ebay.co.uk
* 🇩🇪 **DE** - https://www.ebay.de
* 🇪🇸 **ES** - https://www.ebay.es
* 🇫🇷 **FR** - https://www.ebay.fr
* 🇮🇹 **IT** - https://www.ebay.it
* 🇮🇳 **IN** - https://www.ebay.in
* 🇨🇦 **CA** - https://www.ebay.ca
* 🇯🇵 **JP** - https://www.ebay.co.jp
* 🇦🇪 **AE** - https://www.ebay.ae
* 🇸🇦 **SA** - https://www.ebay.sa
* 🇧🇷 **BR** - https://www.ebay.com.br
* 🇲🇽 **MX** - https://www.ebay.com.mx
* 🇸🇬 **SG** - https://www.ebay.sg
* 🇹🇷 **TR** - https://www.ebay.com.tr
* 🇳🇱 **NL** - https://www.ebay.nl
* 🇦🇺 **AU** - https://www.ebay.com.au
* 🇸🇪 **SE** - https://www.ebay.se
If you'd like any more countries and domains to be added to this scraping list, please email [dtrungtin@gmail.com](mailto:dtrungtin@gmail.com) with your request.

## Other e-commerce scrapers
We have many more e-commerce and retail scrapers in stock for you; to see the list of those, check out the [E-commerce Category in Apify Store](https://apify.com/store?category=ECOMMERCE ).

README.md

main.js

ebay-items-scraper

package.json

Unofficial eBay API to extract data from eBay based on keywords or categories. Scrape reviews, prices, product descriptions, images, location, availability, brand, and more. Download extracted data in structured format and use it in reports, spreadsheets, databases, and applications.

eBay API to scrape reviews, prices, descriptions, images, location, availability, brand, and more. Get structured data in JSON, XML, CSV, Excel.

eBay Scraper

Unofficial eBay API to extract data from eBay based on keywords or categories. Scrape reviews, prices, product descriptions, images, location, availability, brand, and more. Download extracted data...

eBay Scraper

Start URLs

Max items

Proxy configuration

Build new tools

Get a custom solution