eBay Listings Scraper

Apify Actor that scrapes public eBay search listings for legitimate market research and price monitoring. Supports ebay.com, ebay.co.uk, ebay.de, ebay.com.au, ebay.ca, ebay.es, ebay.fr, and ebay.it.

Built with Crawlee + Playwright (HTML parsed with Cheerio), concurrency 1, polite 1.5–3s delays, itemId deduplication. Proxy is optional; enable Apify RESIDENTIAL if you get blocked or empty results.

---

What it does

1. Opens eBay search pages for your query on the selected marketplace
2. Extracts structured fields from public result cards (classic li.s-item and current .s-card markup)
3. Deduplicates by itemId and stops at maxItems
4. Writes a clean dataset for price tracking, comps, or competitive analysis

Output fields

Field	Description
itemId	eBay item / listing id
title	Listing title
price	Numeric price when shown (first value if range)
currency	Currency code as shown by eBay (USD, COP, EUR, GBP, …) — follows site localization / IP
condition	Condition text when public (e.g. Brand New, Open Box, Used)
shipping	Shipping / logistics snippet when public
seller	Seller username when shown publicly on the card
url	Canonical item URL
query	Search query used for the run
marketplace	Marketplace domain
scrapedAt	ISO timestamp

---

Input

Field	Required	Default	Description
query	✅	—	Search term, e.g. mechanical keyboard
marketplace		ebay.com	eBay site domain
maxItems		20	Max unique listings (cap 200)
maxPages		1	Max search pages (cap 10)
proxyConfiguration		off	Optional; use Apify Proxy + RESIDENTIAL if blocked

Example input

{
  "query": "mechanical keyboard",
  "marketplace": "ebay.com",
  "maxItems": 8,
  "maxPages": 1,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

If blocked, switch to:

{
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}

---

Example output (real run)

Local verification (2026-07-29): query mechanical keyboard, marketplace ebay.com, maxItems: 8. Extracted 8 unique listings (prices localized to COP for this IP; USD/EUR appear when eBay serves that locale). Full dump: STORAGE_SAMPLES.json.

[
  {
    "itemId": "146984332653",
    "title": "GK61 Mechanical Gaming RGB LED Keyboard - White, Gaetron Optical Red Switches",
    "price": 63954.01,
    "currency": "COP",
    "condition": "Brand New",
    "shipping": "+COP $55,635.83 shipping",
    "seller": "cidhighwind",
    "url": "https://www.ebay.com/itm/146984332653",
    "query": "mechanical keyboard",
    "marketplace": "ebay.com",
    "scrapedAt": "2026-07-29T05:12:22.810Z"
  },
  {
    "itemId": "407103034170",
    "title": "AULA F99 Wireless Mechanical Keyboard RGB Hot-Swap Full Size White/Gray New",
    "price": 143968.5,
    "currency": "COP",
    "condition": "Open Box",
    "shipping": "+COP $98,410.47 shipping",
    "seller": "brookiedunlimited",
    "url": "https://www.ebay.com/itm/407103034170",
    "query": "mechanical keyboard",
    "marketplace": "ebay.com",
    "scrapedAt": "2026-07-29T05:12:22.811Z"
  },
  {
    "itemId": "800421568031",
    "title": "New Listing Ro75 Beige Creamy Aluminum Mechanical Keyboard Wired RGB Backlit",
    "price": 319930,
    "currency": "COP",
    "condition": "Open Box",
    "shipping": "+COP $159,133.18 shipping",
    "seller": "strawberryjam1986",
    "url": "https://www.ebay.com/itm/800421568031",
    "query": "mechanical keyboard",
    "marketplace": "ebay.com",
    "scrapedAt": "2026-07-29T05:12:22.812Z"
  }
]

---

Suggested pricing

Plan	Price	Notes
Pay per result	$1–2 / 1,000 results	Occasional comps / market checks
Rental	$19–29 / month	Recurring price monitoring

Residential proxy compute (if used) is billed separately by Apify.

---

Responsible use / Terms of Service

• Use only for legitimate market research, price monitoring, and competitive analysis on publicly available search result data.
• Respect eBay User Agreement, eBay robots / crawling policies, and applicable local laws.
• Do not use this Actor to overwhelm eBay infrastructure, bypass authentication for private data, scrape personal information beyond what is publicly shown on search cards, or violate eBay’s anti-bot rules at abusive scale.
• Keep concurrency low (default 1), use polite delays, and enable RESIDENTIAL proxies only when needed.
• You are responsible for compliance with eBay ToS and your jurisdiction’s data / fair-use rules.

---

Tips for reliable runs

1. Start with maxItems ≤ 20 and maxPages = 1.
2. If you get 0 items or challenges, enable Apify Proxy → RESIDENTIAL and match proxy country to the marketplace.
3. Displayed currency follows eBay’s localization for the request IP / site — not always the marketplace’s home currency.
4. Avoid aggressive schedules; space recurring runs by minutes, not seconds.
5. Seller is included only when eBay shows it publicly on the search card.

---

Local development

export APIFY_TOKEN=$(grep '^APIFY_TOKEN=' ../.env | cut -d= -f2-)
npm install --registry https://registry.npmjs.org/
apify run

On Apify Cloud:

apify push -f
apify call joseolmedosotoaguirre/ebay-listings-scraper --input '{...}'

Actor: https://console.apify.com/actors/pG4rCWzw33sl4FWZi
Username slug: joseolmedosotoaguirre/ebay-listings-scraper