🛒✨ eBay Search Scraper

🛒✨ eBay Search Scraper

The 🛒✨ eBay Search Scraper is an Apify actor that turns eBay search results into clean, structured product data — including titles, prices, images, shipping, returns, seller feedback, and item specifics — at scale. It solves the pain of manually collecting eBay marketplace data by automating keyword-based discovery and deep product-page parsing. Built for marketers, developers, data analysts, and researchers, this eBay search scraper delivers a reliable eBay search API alternative for price tracking, market research, SEO insights, and product monitoring — ready to export and integrate into your stack.

With support for regional sites and filters like location, sort, “Show only,” and buying format, you can focus your eBay listings scraper on the exact results you need and run it at scale across multiple pages with live results streaming into your dataset.

What data / output can you get?

Below are the top-level fields saved for each item. Each field is structured to help you analyze, enrich, and export your data easily (CSV, JSON, or Excel via Apify dataset exports).

Data type	Description	Example value
source_url	Canonical eBay listing URL that was scraped	https://www.ebay.com/itm/123456789012
listing_card	Compact summary for quick scanning: title, price, condition, shipping/returns, seller stats	{ "title": "Apple iPhone 12 64GB", "price": "$299.99", "seller_username": "best_seller_123", ... }
images	Normalized image set with thumbnail/original/zoom URLs and sizes	[ { "original": { "url": "https://i.ebayimg.com/images/g/.../s-l400.jpg" }, "mediaType": "IMAGE" } ]
shipping_section_module	Shipping details module with structured rows	{ "title": "Shipping", "sections": { "shipping": { "dataItems": { "shippingRate": { "label": "Shipping Rate", "value": "Free" } } } } }
returns_section_module	Returns policy module with structured items	{ "title": "Returns", "sections": { "returns": { "dataItems": [ { "label": "Return Policy Category", "value": "Domestic" } ] } } }
payments_section_module	Payments module with accepted methods	{ "title": "Payments", "sections": { "paymentMethods": { "dataItems": [ "PayPal", "Visa" ] } } }
condition_description	Short/long condition descriptors extracted from DOM	{ "title": "New", "sections": [ { "dataItems": [ { "label": "Condition (detail)", "value": "New with tags" } ] } ] }
title	Main title extracted from the page/JSON-LD	{ "mainTitle": "Apple iPhone 12 64GB - Black" }
buy_box	Buy box details: price, financing messages, delivery messages, and seller info	{ "binModel": { "price": "299.99" }, "deliveryInfo": { "deliveryMessage": [ "Free 3-day delivery" ] } }
quantity	Quantity/availability data from the buy box	{ "displayLabel": "Quantity", "maxQuantity": "5", "outOfStock": false }
buy_box_cta	CTAs visible in the buy box (localized when available)	{ "buttons": [ "Buy It Now", "Add to cart", "View in cart", "Add to Watchlist", "Added to Watchlist" ] }
about_this_item_min_view	Item specifics (brand, item number, attributes)	{ "title": "About this item", "sections": { "itemSpecificsSection": { "dataItems": { "itemNumber": "123456789012", "brand": "Apple", "color": "Black", "quantity": [ ... ] } } } }
item_desc_seller	Item description preview and iframe URL (if exposed)	{ "title": "Item description from the seller", "sections": { "itemDescriptionSection": { "dataItems": { "iframeUrl": "https://.../desc_ifr", "preview": "Condition: New..." } } } }
shipping_returns_payment_section_module	Consolidated shipping/returns/payments snippet	{ "title": "Shipping, returns, and payments", "sections": { "spr": { "dataItems": { ... } } } }
about_this_seller_section_module	Seller card summary: username, trust signals, feedback	{ "title": "About the seller", "sections": [ { "username": "best_seller_123", "trustSignals": [ "99.8% positive feedback" ] } ] }

Note: Images and metadata are normalized for analysis. Apify lets you export to CSV, JSON, Excel, and more directly from the dataset.

Key features

• 🚀 Real-time dataset streaming — Each product row is saved to your Output as soon as it’s collected, so you can start analyzing immediately.
• 🌍 Regional eBay support — Target 17 eBay sites (US, UK, DE, AU, and more) using the domain input for localized pricing and inventory.
• 🎯 Granular filters — Combine query + location + sort + “Show only” (e.g., sold items, completed listings, free shipping) + buying format (Auction · Buy It Now · Accepts Offers).
• 🔎 Deep product parsing — Extracts listing details, images, shipping, returns, payments, seller feedback, item specifics, and description previews for structured analysis.
• 🛡️ Smart proxy escalation — Direct by default; if blocked, escalate to datacenter → residential with up to 3 residential retries, then enable sticky residential for stability (when Apify Proxy is enabled).
• 📝 Optional long description — Toggle fetch_description_iframe to retrieve richer seller descriptions when available.
• 💻 Developer-friendly — Works as an eBay data extraction tool in your pipelines; integrate with the Apify API or connect to your eBay scraper Python workflows.
• 📈 Built for scale — Control max pages and max listings; internal batching and delays balance throughput and reliability for eBay web scraping bot use cases.

How to use 🛒✨ eBay Search Scraper — step by step

1. Create or log into your Apify account.
2. Open the 🛒✨ eBay Search Scraper actor.
3. Enter your search configuration:
   • Set query (e.g., “coffee grinder”) and choose the domain (e.g., “ebay.com”).
   • Optionally adjust location (ship-to), sort, “Show only,” and buying_format.
   • Set max_pages and maxItems to control depth and volume.
   • Optional: enable Use Apify Proxy and configure proxyConfiguration.
   • Optional: enable fetch_description_iframe for richer item descriptions.
4. Start the run.
5. Watch the run log. The scraper first searches eBay (Step 1) to collect candidate listings, then opens each listing (Step 2) and saves rows live.
6. Open the Output tab to browse results as they arrive.
7. Export your dataset to CSV, JSON, or Excel for downstream analysis or automation.
8. Pro Tip: Use show_only with sold_items or completed_items to focus on eBay sold items scraper and eBay completed listings scraper scenarios.

Use cases

Use case name	Description
Price tracking for retail	Monitor pricing trends and shipping costs across regions, using the eBay price scraper outputs to benchmark and optimize margins.
Market research for brands	Analyze competitors and product variants by extracting eBay product data scraper fields (condition, brand, item specifics) at scale.
SEO & content strategy	Identify titles, keywords, and listing attributes from the eBay search results scraper to improve marketplace visibility.
Resale & arbitrage	Track eBay listings for profitable flips using filters like sold/completed to estimate demand and achievable prices.
Catalog enrichment	Enrich internal catalogs with images, item specifics, and seller metadata from the eBay marketplace data scraper.
Academic & trend analysis	Study category dynamics and consumer behavior with structured, export-ready data for reproducible research.
Automation pipelines (API)	Trigger runs via API and pipe eBay search results to CSV into ETL/data warehouses for analytics and dashboards.

Why choose 🛒✨ eBay Search Scraper?

Built for precision, automation, and reliability, this eBay scraping tool focuses on structured, high-signal marketplace data without manual overhead.

• 🎯 Accurate, structured output: Extracts rich product details from individual listing pages for consistent analysis.
• 🌐 Localization-ready: Target 17 eBay country sites for currency- and inventory-accurate datasets.
• ⚡ Scalable & fast: Pagination and maxItems controls, plus internal batching for larger runs.
• 🧑‍💻 Developer access: Works seamlessly with the Apify API and your eBay scraper Python workflows for automation.
• 🛡️ Robustness built-in: Smart proxy escalation with sticky residential mode for consistent throughput (when enabled).
• 🔒 No login required: Scrapes public listing pages without cookies or authentication.
• 💰 Cost-effective alternative: A dependable eBay search API alternative for high-quality eBay data extraction workflows.

In short: a production-ready eBay web scraping bot that outperforms browser extensions and brittle scripts by delivering structured, repeatable results.

Is it legal / ethical to use 🛒✨ eBay Search Scraper?

Yes — when done responsibly. This actor collects publicly available information from eBay product pages and search results. It does not access private or authenticated data.

Guidelines for responsible use:

• Only extract public listing information and respect platform policies.
• Ensure compliance with applicable laws and regulations (e.g., GDPR, CCPA) for your use case and geography.
• Avoid collecting personal data or using the data for spam.
• Consult your legal team for edge cases and jurisdiction-specific constraints.

Input parameters & output format

Example JSON input

{
  "query": "coffee grinder",
  "domain": "ebay.com",
  "location": "1",
  "sort": "12",
  "show_only": ["sold_items"],
  "buying_format": "BIN",
  "max_pages": 2,
  "maxItems": 50,
  "useProxy": true,
  "fetch_description_iframe": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Parameter details

• query (string) — Type what you want to find; drives the search together with Country & filters. Default: "coffee". Required: No.
• domain (string) — Which eBay site to search (17 regional options). Default: "ebay.com". Required: No.
• location (string) — Ship-to location code to align results with buyer/delivery context. Default: "1". Required: No.
• sort (string) — Sort order (Best Match, ending soonest, newly listed, price high/low, distance). Default: "12". Required: No.
• show_only (array of strings) — Optional quick filters (e.g., "sold_items", "completed_items", "free_shipping"). Default: []. Required: No.
• buying_format (string) — Listing format: "Auction", "BIN" (Buy It Now), or "BO" (Accepts Offers). Default: "BIN". Required: No.
• max_pages (integer) — How many search result pages to walk. Default: 1. Required: No.
• maxItems (integer) — Cap on total rows in the dataset for this run. Default: 20. Required: No.
• useProxy (boolean) — Enable Apify Proxy routing. Default: true. Required: No.
• fetch_description_iframe (boolean) — Fetch richer seller description text when available (slower). Default: false. Required: No.
• proxyConfiguration (object) — Apify Proxy configuration (used when useProxy is enabled). Prefill: { "useApifyProxy": true }. Required: No.

Example JSON output

{
  "source_url": "https://www.ebay.com/itm/123456789012",
  "listing_card": {
    "title": "Apple iPhone 12 64GB - Black",
    "sponsored": false,
    "link": "https://www.ebay.com/itm/123456789012",
    "condition": "New",
    "thumbnail": "https://i.ebayimg.com/images/g/abc123/s-l1600.jpg",
    "price": "$299.99",
    "shipping": "Free shipping · United States",
    "returns": "30-day returns · Free returns",
    "seller_username": "best_seller_123",
    "seller_reviews": 15234,
    "seller_positive_feedback_in_percentage": 99.8
  },
  "images": [
    {
      "thumbnails": [
        { "url": "https://i.ebayimg.com/images/g/abc123/s-l64.jpg", "title": "1 of 3", "type": "thumbnail" }
      ],
      "original": { "url": "https://i.ebayimg.com/images/g/abc123/s-l400.jpg", "title": "1 of 3", "type": "original" },
      "zoom": { "url": "https://i.ebayimg.com/images/g/abc123/s-l1600.jpg", "title": "1 of 3", "type": "zoom" },
      "title": "1 of 3",
      "uploadedSize": { "height": 1600, "width": 1600 },
      "mediaType": "IMAGE"
    }
  ],
  "shipping_section_module": {
    "title": "Shipping",
    "sections": {
      "shipping": {
        "dataItems": {
          "shippingRate": { "label": "Shipping Rate", "value": "Free USD" },
          "shippingDestination": { "label": "Shipping Destination", "value": "US" }
        }
      },
      "title": { "title": "Delivery" }
    }
  },
  "returns_section_module": {
    "title": "Returns",
    "sections": {
      "returns": {
        "dataItems": [
          { "label": "Return Policy Category", "value": "Domestic" }
        ]
      }
    }
  },
  "payments_section_module": {
    "title": "Payments",
    "sections": {
      "paymentMethods": { "dataItems": ["PayPal", "Visa", "Mastercard"] }
    }
  },
  "condition_description": {
    "sections": [
      {
        "dataItems": [
          { "label": "Condition (detail)", "value": "New with tags" },
          { "label": "Condition (summary)", "value": "New with tags" }
        ]
      }
    ],
    "title": "New"
  },
  "title": { "mainTitle": "Apple iPhone 12 64GB - Black" },
  "buy_box": {
    "binModel": {
      "price": "299.99",
      "isAddedToCart": false,
      "priceTransparencyAction": "Price details"
    },
    "financingDetails": { "financingMessages": ["Special financing available"] },
    "repositionCoupon": false,
    "deliveryInfo": { "deliveryMessage": ["Free 3-day delivery"] },
    "sellerInfo": {
      "profileLogo": { "title": "best_seller_123" },
      "dataItems": ["best_seller_123", "99.8% positive feedback"]
    }
  },
  "quantity": {
    "displayLabel": "Quantity",
    "maxQuantityReached": "",
    "maxQuantity": "5",
    "outOfStock": false
  },
  "buy_box_cta": {
    "buttons": ["Buy It Now", "Add to cart", "View in cart", "Add to Watchlist", "Added to Watchlist"]
  },
  "about_this_item_min_view": {
    "title": "About this item",
    "sections": {
      "itemSpecificsSection": {
        "dataItems": {
          "quantity": [
            { "label": "available", "value": "5 available" },
            { "label": "sold", "value": "120 sold" }
          ],
          "itemNumber": "123456789012",
          "brand": "Apple",
          "condition": "New with tags",
          "color": "Black"
        }
      }
    }
  },
  "item_desc_seller": {
    "title": "Item description from the seller",
    "sections": {
      "itemDescriptionSection": {
        "dataItems": {
          "iframeUrl": "https://desc.ebay.com/desc_ifr?...",
          "preview": "Condition: New. Ships fast from US.",
          "plainText": "Condition: New. Includes charger and cable..."
        }
      }
    }
  },
  "shipping_returns_payment_section_module": {
    "title": "Shipping, returns, and payments",
    "sections": {
      "spr": {
        "dataItems": {
          "shippingRate": { "label": "Shipping Rate", "value": "Free USD" },
          "shippingDestination": { "label": "Shipping Destination", "value": "US" }
        }
      }
    }
  },
  "about_this_seller_section_module": {
    "sections": [
      {
        "profileLogo": { "title": "best_seller_123" },
        "username": "best_seller_123",
        "trustSignals": ["99.8% positive feedback"],
        "dataItems": ["best_seller_123", "99.8% positive feedback"]
      }
    ],
    "title": "About the seller"
  }
}

Note: Some fields (e.g., long descriptions, shipping/returns details, financing messages) may be missing or simplified when not exposed on a given listing.

FAQ

Do I need to log in or provide cookies to use this eBay scraping tool?

No. The actor works without login and does not require cookies. It collects publicly available listing and search result data.

Can I target specific eBay countries or currencies?

Yes. Use the domain parameter to choose among 17 regional eBay sites (e.g., ebay.com, ebay.co.uk, ebay.de). Prices and inventory align with the site you select.

How do I scrape sold items or completed listings?

Use the show_only array. Set ["sold_items"] to focus on sold results or ["completed_items"] for completed listings. You can combine it with sort and buying_format for precise targeting.

How many results can I scrape in one run?

Control volume with max_pages (how deep to go) and maxItems (hard cap on rows). Results stream to your Output as they’re collected.

How does the proxy work if I hit blocks or rate limits?

When useProxy is enabled, the actor escalates automatically: starts direct, then datacenter, then residential with up to 3 residential retries, and switches to sticky residential after a successful fetch for stability.

Can I get the full item description?

Yes. Enable fetch_description_iframe to fetch and parse the seller’s long description when eBay exposes it via an iframe. This adds richness but can slow runs.

Can I integrate this with my API/Python workflows?

Yes. It’s an Apify actor, so you can trigger runs via the Apify API and export results. Many teams use it as an eBay data extraction tool integrated into Python ETLs and dashboards.

What formats can I export to?

Use the Apify dataset to download results as JSON, CSV, or Excel. This makes it easy to move eBay search results to CSV for analytics or to feed other systems.

Closing CTA / Final thoughts

The 🛒✨ eBay Search Scraper is built for structured, scalable eBay marketplace data collection. With regional targeting, precise filters, deep product parsing, and smart proxy handling, it’s a dependable eBay search results scraper for marketers, developers, analysts, and researchers.

Run it as your eBay search API alternative, export results to CSV/JSON/Excel, and connect it to existing automation or eBay scraper Python pipelines. Start extracting smarter eBay insights today — from keyword to clean dataset, at scale.