eBay Sold Comps

Search eBay completed/sold listings and get aggregated comp pricing with statistical outlier fencing, lot normalization, and a data-quality confidence score (A–D grade).

Built for resellers, pawn shops, auction tools, and any pricing service that needs to know what items actually sold for — not what sellers are hoping to get.

---

Why this actor is different

Most eBay sold scrapers return a raw dump of listings and leave the pricing math to you. This actor does the work before it hands you results:

Feature	What it does
Lot normalization	Detects multi-item listings ("lot of 3", "bundle of 5", "2x") and divides to per-unit price before computing averages
IQR outlier fencing	Removes statistical outliers using interquartile range fencing — one $500 anomaly won't skew your $45 avg
Confidence score (A–D)	Every result includes a grade based on comp count, price spread, and recency so you know when to trust the number
Recommended listing price	A single suggested price — weighted blend of median (60%) and p75 (40%) — so you don't have to do the math yourself
Relevance filtering	Token-based scoring drops junk comps that technically matched the keyword but aren't the item
Condition-adjusted pricing	Optional breakdown of avg sold price by condition tier (new / used / refurbished / for_parts)
8 eBay marketplaces	US, UK, DE, FR, IT, ES, CA, AU — search regional sold data with a single input field
Clean schema	One camelCase field per data point — no duplicate aliases, no mixed casing

---

Pricing

This actor uses Pay Per Event pricing — you only pay for what you get back.

Event	Cost	When charged
comp-record-returned	$0.02 / record	Per individual sold listing in the dataset
pricing-report-generated	$0.10 / run	Once per run when aggregated stats are produced

Example: A typical run returning 25 comp records = 25 × $0.02 + $0.10 = $0.60 total.

There is no subscription, no minimum spend, and no charge for runs that return zero results.

---

Input

Field	Type	Required	Default	Description
searchQuery	string	✅	—	What to search for. Be specific — include brand, model, size.
maxResults	integer		25	Max comp records to return (1–100).
condition	string		all	Filter by: new, used, refurbished, for_parts.
eBaySite	string		ebay.com	Marketplace: ebay.com, ebay.co.uk, ebay.de, ebay.fr, ebay.it, ebay.es, ebay.ca, ebay.com.au.
minPrice	number		—	Drop listings below this price (applied at eBay search level).
maxPrice	number		—	Drop listings above this price (applied at eBay search level).
daysBack	integer		—	Only include comps sold within this many days (1–90).
knownBrands	string[]		[]	Brand mismatch filter. Listings with a different brand from this list are dropped.
excludedPhrases	string[]		[]	Plain-text phrases — matching titles are dropped.
excludedPatterns	string[]		[]	Regex patterns (case-insensitive) — matching titles are dropped.
includeConditionPricing	boolean		false	Add per-condition price breakdown to stats output.

Example input

{
    "searchQuery": "dewalt 20v drill driver",
    "maxResults": 25,
    "condition": "used",
    "eBaySite": "ebay.com",
    "minPrice": 15,
    "maxPrice": 150,
    "daysBack": 30,
    "knownBrands": ["dewalt", "milwaukee", "makita"],
    "excludedPhrases": ["case only", "charger only"],
    "includeConditionPricing": true
}

---

Output

Comp records — default dataset

One record per sold listing:

{
    "id": "145023948271",
    "title": "DeWalt 20V MAX Drill Driver DCD771 Bare Tool",
    "url": "https://www.ebay.com/itm/145023948271",
    "soldDate": "Dec 18, 2024",
    "soldPrice": 42.00,
    "shippingCost": 0,
    "totalPrice": 42.00,
    "isLot": false,
    "inferredLotSize": null,
    "normalizedPrice": 42.00,
    "normalizationMethod": "none",
    "normalizationConfidence": 1.0,
    "condition": "Used",
    "conditionTier": "used",
    "relevanceScore": 0.88,
    "primaryImageUrl": "https://i.ebayimg.com/images/g/.../s-l500.jpg",
    "thumbnailUrl": "https://i.ebayimg.com/images/g/.../s-l225.jpg",
    "detailPageFetched": true,
    "detailPageFailReason": null
}

Aggregated stats — key-value store key: stats

{
    "searchQuery": "dewalt 20v drill driver",
    "condition": "used",
    "compCount": 18,
    "rawCandidateCount": 24,
    "price": {
        "avg": 47.82,
        "median": 44.50,
        "low": 28.00,
        "high": 89.00,
        "p25": 36.75,
        "p75": 58.00,
        "stdDev": 14.21
    },
    "recommendedPrice": 49.90,
    "confidence": {
        "score": 0.74,
        "grade": "B",
        "compCount": 18,
        "priceSpread": 0.61,
        "recencyDays": 22,
        "outliersRemoved": 2,
        "lotNormalizedCount": 1,
        "notes": []
    },
    "conditionPricing": {
        "new":         { "avg": 89.00, "count": 2 },
        "used":        { "avg": 43.50, "count": 14 },
        "refurbished": { "avg": 55.00, "count": 2 },
        "for_parts":   { "avg": null,  "count": 0 }
    },
    "dropped": {
        "byRelevance": 3,
        "byNegativePhrase": 1,
        "byNegativePattern": 0,
        "byBrandMismatch": 2,
        "byConditionFilter": 0,
        "byMaxResultsCap": 0
    },
    "lot": {
        "detected": 2,
        "normalized": 1
    },
    "outliers": {
        "removed": 2,
        "prices": [4.99, 220.00],
        "fencingApplied": true
    },
    "runtime": {
        "totalSeconds": 18.4,
        "searchSeconds": 4.1,
        "detailSeconds": 14.3
    }
}

---

Confidence grade guide

Grade	Score	What it means
A	≥ 0.85	High comp count, tight price spread, recent sales — strong signal
B	≥ 0.65	Solid data with minor caveats
C	≥ 0.45	Limited comps or noisy spread — use with judgment
D	< 0.45	Thin market, old data, or very wide spread — treat with caution

The confidence score is a weighted blend of three sub-signals: comp count (40%), price spread (35%), and recency (25%).

---

Use cases

• Pawn shops — instant comp price before making an offer
• Resellers / flippers — verify buy prices against real sold data
• Auction software — embed real-time eBay comp pricing into bidding tools
• Estate sale pricing — bulk item valuation from actual market data
• Consignment shops — set listing prices based on what's actually selling
• Pricing APIs — embed as a data source in your own resale or inventory platform

---

Notes

• This actor scrapes publicly available eBay sold listing data. It is not affiliated with or endorsed by eBay Inc.
• You are responsible for complying with eBay's Terms of Service when using data retrieved by this actor.
• Detail page fetches are used only when the search result card does not include an image. Most runs require few or no detail page fetches, keeping runtime low.
• Lot normalization confidence is 1.0 when no lot is detected, 0.85 for successful size-inferred division, and 0.30 when a lot is detected but size cannot be inferred.