eBay Motors Vehicle & Parts Scraper

What does eBay Motors Vehicle & Parts Scraper do?

eBay Motors Vehicle & Parts Scraper extracts evidence-backed, publicly visible listing data from eBay Motors through direct public HTTP requests. It provides structured output through the Apify API and dataset interfaces for vehicles, motorcycles, boats, RVs, ATVs, and parts.

The Actor only publishes information found on the requested public eBay page. It has no eBay developer credential fields and no official-API runtime path. It uses a bounded anonymous session established through eBay's public help page; it does not use mirrors, private endpoints, login sessions, or access-control bypasses. If eBay presents a CAPTCHA, login wall, paywall, geofence, rate limit, device/browser check, WAF page, or another access boundary, the Actor stops for that target and emits a diagnostic row instead of inventing or substituting data. Browser-visible attributes are optional and omitted when the page does not disclose them.

Why use eBay Motors Vehicle & Parts Scraper?

• Search public eBay Motors listings by keyword and category.
• Generate marketplace-specific Motors searches for eBay US, UK, or Germany.
• Filter returned evidence by condition, price range, and model year.
• Reject promoted accessories, die-cast models, manuals, service kits, and other non-vehicle rows from vehicle searches.
• Optionally enrich up to 20 generated results from their public item pages while retaining useful card data when detail access is unavailable.
• Scrape explicitly supplied public item URLs in byListingUrls mode.
• Receive bounded, normalized records with backward-compatible url, priceFormatted, and listingType fields.
• Run on a schedule, access results through the Apify API, connect datasets to integrations, and monitor failures in Apify Console.

The Actor uses one public request at a time with bounded timeouts, a 12 MB streaming response cap, a short pacing delay, and at most one retry for transient network failures. Optional proxyConfiguration is honored, and usedProxy records the actual route. It does not retry access-control responses.

What data can eBay Motors Vehicle & Parts Scraper extract?

Field	Type	Description
itemId / itemUrl	string	Public eBay listing identifier and URL when present.
title	string	Public listing title.
price / priceNumeric	string / number	Displayed price and parsed numeric value.
condition	string	Public listing condition.
year, make, model, trim, vin	number / string	Vehicle identity when present.
mileage	number	Public mileage or odometer value.
engine, transmission, drivetrain, fuelType, bodyStyle	string	Public mechanical and body attributes.
exteriorColor, interiorColor, doors, seats	mixed	Additional public vehicle attributes.
detailStatus, detailUrl, searchSourceUrl	string	Detail-enrichment outcome and provenance.
seller, location, shipping, images	object / array / string	Bounded public listing details when present.
found, dataAvailable	boolean	Evidence and availability flags. Diagnostic rows set both to false.
accessStatus, diagnosticCode	string	Explanation for a fail-closed row.

Optional values are omitted when the public page does not provide them. The dataset schema documents every field the runtime can emit.

How to scrape eBay Motors

1. Open the Actor's Input tab.
2. Select searchVehicles, searchParts, or byListingUrls.
3. For a search, provide a query and any category, condition, price, year, sort, and result-limit controls.
4. For byListingUrls, provide public eBay item URLs such as https://www.ebay.com/itm/100000000001.
5. Start with a small maxItems value, run the Actor, and inspect the dataset and any diagnostic rows.

Search mode requests one public eBay search page and, by default, enriches up to maxDetailPages accepted vehicle cards from their public item pages. A generated vehicle must expose a plausible model year and a vehicle signal, and known promoted-part patterns are rejected before enrichment. The site may return fewer listings than the requested maximum. Listing-URL mode processes supplied item pages sequentially until the requested maximum is reached.

How much will it cost to scrape eBay Motors?

You pay for the Actor's Apify compute usage. Actual duration depends on the number of requested URLs, response size, and any bounded network retry. Start with a small input to estimate cost before running a larger collection.

Input

See the Input tab for the complete configuration. Controls include mode, marketplace, search query, vehicle and parts categories, condition, sorting, marketplace-currency price bounds, year bounds, public start URLs, maximum items, includeDetails, and maxDetailPages.

Output

You can download the dataset in formats such as JSON, HTML, CSV, or Excel. A successful listing row has found: true and dataAvailable: true. When public evidence is unavailable, the Actor returns a row with found: false and dataAvailable: false, along with accessStatus, diagnosticCode, HTTP status, and a short sanitized response preview when available. This Actor writes to the dataset only; it does not write key-value-store records.

[
  {
    "recordType": "ebay-motors-listing",
    "found": true,
    "dataAvailable": true,
    "itemUrl": "https://www.ebay.com/itm/100000000001",
    "title": "Example 2018 Sedan Listing",
    "price": "$18,500",
    "year": 2018
  },
  {
    "recordType": "ebay-motors-access-diagnostic",
    "found": false,
    "dataAvailable": false,
    "accessStatus": "captcha_or_human_check",
    "diagnosticCode": "page_challenge"
  }
]

Tips and advanced options

The lifecycle entrypoint is src/main.js; src/actor.js owns Apify initialization and shutdown, while src/runner.js contains public request, listing extraction, filtering, diagnostics, and dataset output.

• Start with one search or one item URL and a low maxItems value.
• Treat access diagnostics as a boundary; do not attempt to work around them.
• Use explicit item URLs when you need evidence from known public listings.
• Keep the requested filters aligned with the public fields you expect to find.

Key-value store

The actor does not write custom key-value records. Listing and access-diagnostic rows are stored in the dataset; the declared key-value store is intentionally empty.

FAQ, disclaimers, and support

Does this Actor scrape private data?

No. It processes public page evidence only and does not defeat authentication, access controls, paywalls, CAPTCHAs, or WAF restrictions.

What should I do when a diagnostic row appears?

Review accessStatus and diagnosticCode, reduce the request size, and respect the target's access controls. Persistent restrictions are reported as limitations rather than bypassed.

Data-protection notice

Our Actors are ethical and do not intentionally extract private user data. They only process information available on public pages. Results can still contain personal data protected by the GDPR and other laws. Do not process personal data without a legitimate reason; consult legal counsel if uncertain.

For feedback, use the Actor's Issues tab. For programmatic use, open the API tab in Apify Console.