# eBay Sold Listings Search (`caffein.dev/ebay-sold-listings`) Actor
Get confirmed eBay sold prices. Search by keyword across 8 marketplaces, filter by date range, and export clean structured data for comps, resale pricing, and market research.
- **URL**: https://apify.com/caffein.dev/ebay-sold-listings.md
- **Developed by:** [Caffein Dev](https://apify.com/caffein.dev) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Features:** Limited permissions
- **Stats:** 4,803 total users, 918 monthly users, 97.2% runs succeeded, 52 bookmarks
- **User rating**: 4.38 out of 5 stars
## Pricing
from $2.50 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event
## What's an Apify Actor?
An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.
For examples already wired to this Actor's own input schema, see the [API](#api) section below.
Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).
# README
## eBay Sold Listings API (Real Sold Items Only)
Fetch **real sold listings from eBay** β actual completed sales with final prices.
This Actor returns **sold items only**, not active listings and **not completed-but-unsold items**.
Built for **price analysis, resale tools, market research, and pricing intelligence**.
***
### π What This API Provides
This Apify Actor extracts **eBay sold listings** and returns structured, machine-readable data for each sale:
- Final sold price
- Currency
- Sale end date
- Listing title
- Item URL
- Item ID
β
**Every result represents an item that actually sold**
β No active listings
β No unsold βcompletedβ listings
β No estimated or AI-generated prices
***
### βοΈ Input
```json
{
"keywords": ["rtx 4080", "rtx 4090"],
"categoryId": "58058", // any eBay category ID; "0" = All Categories
"subcategoryId": "", // any eBay subcategory ID; overrides categoryId when set
"daysToScrape": 30,
"count": 100,
"ebaySite": "ebay.com",
"sortOrder": "endedRecently",
"minPrice": 100,
"maxPrice": 500,
"itemLocation": "default",
"itemCondition": "any"
}
```
| Field | Type | Default | Description |
| -------------------------- | -------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `keywords` | string\[] | **required** | 1β6 search terms. Each runs as a separate search with the same filters. Results are tagged with `keyword` for easy filtering. |
| `keyword` | string | β | **Deprecated.** Use `keywords` array instead. Accepted for backward compatibility. |
| `search` | string | β | **Deprecated.** Alias for `keyword`. Use `keywords` array instead. Accepted for backward compatibility with callers that send `search`. Backslash-escaped quotes (`\"`) in the value are unescaped before the search runs. |
| `daysToScrape` | number | `30` | Days back to scrape (1β90) |
| `count` | number | `100` | Max results per keyword |
| `categoryId` | string | `"0"` | Main category filter β accepts **any** eBay category ID as free text (maps to `_sacat`). Use `"0"` for All Categories. Look up IDs at [sold-comps.com/ebay-categories](https://sold-comps.com/ebay-categories). |
| `subcategoryId` | string | `""` | Optional subcategory filter β accepts **any** eBay subcategory ID as free text (maps to `_sacat`). If set, overrides `categoryId`. Look up IDs at [sold-comps.com/ebay-categories](https://sold-comps.com/ebay-categories). |
| `ebaySite` | string | `ebay.com` | eBay marketplace (see supported sites) |
| `sortOrder` | string | `endedRecently` | `endedRecently` Β· `timeNewlyListed` Β· `pricePlusPostageLowest` Β· `pricePlusPostageHighest` Β· `distanceNearest` |
| `minPrice` | integer | β | Minimum sold price filter (whole number, in the site's currency) |
| `maxPrice` | integer | β | Maximum sold price filter (whole number, in the site's currency) |
| `itemLocation` | string | `default` | `default` Β· `domestic` Β· `worldwide`. Ignored when `sellerCountry` is set. |
| `sellerCountry` | string | β | Only return listings from sellers located in this country. Two-letter ISO code (e.g. `JP`, `GB`; `UK` also works), case-insensitive. When set, `itemLocation` is ignored. An unknown code is ignored (results are unfiltered). If no listing matches, eBay can return listings from other countries β check `itemLocation` on each item. [Code list](https://sold-comps.com/seller-countries) |
| `postalCode` | string | β | Delivery postal code for more accurate shipping prices, in the selected site's format: `10001` (ebay.com), `SW1A 1AA` (ebay.co.uk), `10115` (ebay.de/.fr/.it/.es), `M5V 3L9` (ebay.ca), `2000` (ebay.com.au). Only changes calculated shipping, not the delivery country. Blank = a central postcode for the site. A wrong-format value is ignored with a warning. |
| `itemCondition` | string | `any` | `any` Β· `new` Β· `used` |
| `conditionId` | integer | β | Numeric eBay condition ID (e.g. `1000` New, `3000` Used, `7000` For parts). Overrides `itemCondition` when set. |
| `buyingFormat` | string | `all` | `all` Β· `auction` Β· `buyItNow` Β· `acceptsOffers` |
| `sellerType` | string | `any` | `any` Β· `private` Β· `business`. **EU sites only** β works on `ebay.de`, `ebay.fr`, `ebay.it`, `ebay.es`. Ignored on all other sites (results are unfiltered). |
| `aspectFilter` | object | β | eBay item-aspect facet filters as a JSON object, using the facet names shown on eBay, e.g. `{"Brand": "Nike"}` |
| `includeCompletedListings` | boolean | `true` | Include eBay's Completed Listings filter. Enables accurate Best Offer Accepted detection (`listingType`, `isBestOfferAccepted`). Set to `false` for strictly sold-only results β BOA items will show as `buy_it_now`. See [Completed Listings & Best Offer Accepted Detection](#completed-listings-and-best-offer-accepted-detection). |
| `exactMatch` | boolean | `true` | When `true`, eBay's loosened "results matching fewer words" items are removed. Set to `false` to include them. |
#### Supported eBay Sites
`ebay.com` Β· `ebay.co.uk` Β· `ebay.de` Β· `ebay.fr` Β· `ebay.it` Β· `ebay.es` Β· `ebay.ca` Β· `ebay.com.au`
***
### π€ Output
```json
{
"itemId": "306671421088",
"url": "https://www.ebay.com/itm/306671421088?nordt=true",
"epid": "3049291546",
"title": "Apple iPhone 13 Pro Max - 128GB - Unlocked - Cracked Back",
"condition": "Pre-Owned",
"conditionId": 3000,
"endedAt": "2025-12-22",
"soldPrice": "215",
"soldPriceMax": null,
"buyItNowPrice": null,
"soldCurrency": "USD",
"listingType": "buy_it_now",
"isBestOfferAccepted": false,
"buyingFormat": "buyItNow",
"bidCount": null,
"shippingPrice": "6.20",
"shippingCurrency": "USD",
"shippingType": "paid",
"totalPrice": "221.20",
"thumbnailUrl": "https://i.ebayimg.com/thumbs/images/g/abc123/s-l500.jpg",
"fullResThumbnailUrl": "https://i.ebayimg.com/images/g/abc123/s-l1600.jpg",
"sellerUsername": "example_seller",
"sellerPositivePercent": 99.2,
"sellerFeedbackScore": 1842,
"sellerType": null,
"itemLocation": "United States",
"scrapedAt": "2026-01-19T21:53:17.613Z"
}
```
| Field | Description |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `itemId` | eBay item ID |
| `url` | Full listing URL. Carries `?nordt=true` so it opens the listing itself rather than redirecting to a catalog page |
| `epid` | eBay catalog product ID β stable across sellers for the same product variant. `null` when the listing has no catalog match. |
| `title` | Listing title |
| `condition` | Localized eBay condition label as shown on the search card (e.g. `"Pre-Owned"` on ebay.com, `"Gebraucht"` on ebay.de, `"Neuf"` on ebay.fr, `"Nuovo"` on ebay.it, `"Usado"` on ebay.es). `null` when eBay didn't display one. This is the authoritative field β what the buyer actually saw. |
| `conditionId` | Best-effort numeric eBay condition ID resolved from `condition` via a static lookup table. `null` when `condition` is `null` or the label isn't in the lookup table (eBay can introduce new or locale-specific labels at any time β always check `condition` first). Common IDs: `1000` New Β· `1500` Open box / New Other Β· `1750` New with defects Β· `2000`β`2030` Refurbished tiers (Certified / Excellent / Very Good / Good) Β· `2500` Seller Refurbished Β· `2750` Like New Β· `3000` Used / Pre-Owned Β· `7000` For parts. [Full reference](https://developer.ebay.com/api-docs/sell/static/metadata/condition-id-values.html) |
| `categoryId` | Category id used for the search (`_sacat`) |
| `category` | Selected category label from the search page dropdown |
| `endedAt` | Sale date as `YYYY-MM-DD` (date only β eBay does not expose a time of day) |
| `soldPrice` | Final transaction price. **Note:** when `isBestOfferAccepted` is `true`, this is the *asking* price β the actual accepted offer is not disclosed by eBay. |
| `soldPriceMax` | High end of the price range eBay shows for a listing with variations. `soldPrice` is the low end. `null` for one price. |
| `buyItNowPrice` | On an auction that also had a Buy It Now option (`buyingFormat` = `"auctionWithBIN"`), the Buy It Now price. `null` for other listings. |
| `soldCurrency` | Currency code (e.g. `USD`, `GBP`) |
| `listingType` | How the item sold: `"best_offer_accepted"` Β· `"buy_it_now"` Β· `"auction"` Β· `null` (undetermined) |
| `isBestOfferAccepted` | `true` if sold via an accepted Best Offer. `soldPrice` is the asking price, not the actual transaction price. |
| `buyingFormat` | Richer buying-format enum: `"auction"` (bids only) Β· `"buyItNow"` (fixed price or best-offer) Β· `"auctionWithBIN"` (auction with a Buy It Now option) Β· `null` (undetermined) |
| `bidCount` | Number of bids received. `null` for fixed-price listings or when not shown. |
| `shippingPrice` | Shipping cost (`null` if not disclosed) |
| `shippingCurrency` | Currency of shipping price |
| `shippingType` | `free` Β· `paid` Β· `pickup` Β· `unknown` |
| `totalPrice` | `soldPrice + shippingPrice` when currencies match, otherwise equals `soldPrice` |
| `thumbnailUrl` | 500px product image URL from `i.ebayimg.com`. `null` when only a promo or logo image is available on the search card. |
| `fullResThumbnailUrl` | High-res (1600px) product image URL, derived from `thumbnailUrl`. `null` when no product image is available. Best-effort β may 404 for listings where eBay only hosts a low-res image. |
| `sellerUsername` | Seller username (best-effort) |
| `sellerPositivePercent` | Positive feedback % (best-effort) |
| `sellerFeedbackScore` | Feedback count (best-effort) |
| `sellerType` | `"private"` or `"business"` on EU sites (`ebay.de`, `.fr`, `.it`, `.es`). `null` on non-EU sites or when the label is unrecognised. |
| `itemLocation` | Seller's country as shown on the search results page. Written in the site's language (e.g. `"Stati Uniti"` on ebay.it). On `ebay.com` every listing has it; on the other sites it is normally only set for sellers abroad and `null` for domestic ones. (Not the same as the `itemLocation` input filter.) |
| `scrapedAt` | Scrape timestamp (ISO 8601) |
***
### π·οΈ Completed Listings & Best Offer Accepted Detection
The `includeCompletedListings` input (default `true`) controls whether eBay's **Completed Listings** filter (`LH_Complete=1`) is sent alongside the always-present **Sold** filter (`LH_Sold=1`).
**All results are genuinely sold items regardless of this setting** β the `LH_Sold=1` filter is always applied, so the actor never returns active or completed-but-unsold listings. This flag does **not** affect the sold/unsold guarantee; it only affects how accurately the actor can classify *how* an item sold.
#### Why the flag exists β an eBay HTML limitation
This is a limitation of eBay's own HTML, not a choice the actor makes. eBay only renders the signals needed to identify a **Best Offer Accepted** sale when the Completed Listings filter is active:
| Signal on the search card | `includeCompletedListings: true` (`LH_Complete=1`) | `includeCompletedListings: false` (`LH_Complete=0`) |
| ------------------------- | -------------------------------------------------- | --------------------------------------------------- |
| Best-offer text | `"Best offer accepted"` | `"or Best Offer"` (or nothing) |
| Price CSS class | `strikethrough` | `bold` |
| BOA detectable? | β
Yes | β No |
When `LH_Complete=0`, eBay strips the `"Best offer accepted"` text and the `strikethrough` price styling from the cards. Without those signals, a Best Offer Accepted sale is **indistinguishable in the HTML** from an ordinary Buy It Now sale β **the actor cannot accurately detect Best Offer Accepted status for each listing.**
#### What this means for the output
- **`includeCompletedListings: true` (default):** Best Offer Accepted sales are detected. `listingType` can be `"best_offer_accepted"` and `isBestOfferAccepted` can be `true`. (Note: even here, eBay does not disclose the *actual* accepted offer amount β `soldPrice` reflects the asking price for BOA items.)
- **`includeCompletedListings: false`:** BOA sales are reported as `listingType: "buy_it_now"` with `isBestOfferAccepted: false`. You still get every sold item and its sold price β you just lose the ability to know whether a given sale went through as an accepted Best Offer.
Set `includeCompletedListings: false` only if you want the search filter to match eBay's plain "Sold" view and don't rely on Best Offer Accepted classification.
***
### π₯ Who This API Is For
- Developers building pricing APIs or resale tools
- Data analysts and researchers
- Professional resellers and flippers
- SaaS founders validating secondary market prices
***
### π Support & Feedback
For issues, questions, or feature requests, please contact the Actor author via Apify.
***
### Category IDs & Subcategory IDs
Both `categoryId` and `subcategoryId` are free-text fields β you can pass **any** eBay category or subcategory ID, not just ones from a preset list. The ID is passed straight through to eBay's `_sacat` search parameter, so any ID eBay recognizes will work. When `subcategoryId` is set it overrides `categoryId` β the output always reflects the effective category used.
Not sure which ID to use? We maintain a full, searchable list of every eBay category and subcategory ID:
**[π Browse & search all category IDs and subcategory IDs β](https://sold-comps.com/ebay-categories)**
***
# Changelog
This Actor's version history is a separate document: https://apify.com/caffein.dev/ebay-sold-listings/changelog.md
# Actor input Schema
## `keywords` (type: `array`):
One or more search keywords. Each keyword runs as a separate search with the same filters applied to all.
## `keyword` (type: `string`):
Single search keyword. Deprecated: use the 'keywords' array field instead.
## `search` (type: `string`):
Deprecated: alias for the single-keyword `keyword` field. Use the `keywords` array instead. Accepted for backward compatibility with callers that send `search`. Backslash-escaped quotes (") in the value are unescaped before the search runs.
## `categoryId` (type: `string`):
eBay category ID β maps directly to the `_sacat` URL parameter. Enter ANY eBay category ID as free text; you are not limited to a preset list. Use "0" (the default) for All Categories. Don't know the ID? We maintain the full, up-to-date list of category & subcategory IDs at https://sold-comps.com/ebay-categories
## `subcategoryId` (type: `string`):
Optional eBay subcategory ID β also maps to `_sacat`. Enter ANY subcategory ID as free text. When set, it overrides the Category field above. Leave blank to search at the category level. Full ID reference: https://sold-comps.com/ebay-categories. The output record's `categoryId` / `category` fields reflect the effective category actually used for the search.
## `ebaySite` (type: `string`):
eBay site to scrape from
## `daysToScrape` (type: `integer`):
Number of days back to scrape sold listings (default: 30)
## `count` (type: `integer`):
Number of listings to scrape (default: 100)
## `sortOrder` (type: `string`):
Sort order for the sold search results page.
## `minPrice` (type: `integer`):
Minimum sold price filter (search-page filter).
## `maxPrice` (type: `integer`):
Maximum sold price filter (search-page filter).
## `buyingFormat` (type: `string`):
Search-page buying format filter.
## `itemLocation` (type: `string`):
Search-page item location filter.
## `sellerCountry` (type: `string`):
Only return listings from sellers located in this country. Two-letter ISO code, e.g. JP or GB. When set, the Item location filter is ignored. If no listing matches, eBay can return listings from other countries: check itemLocation on each item. Country codes
## `postalCode` (type: `string`):
Delivery postal code for more accurate shipping prices, in the format of the selected eBay site (e.g. a ZIP code on ebay.com, SW1A 1AA on ebay.co.uk). Leave blank to use a central postcode for the site. A value in the wrong format is ignored with a warning.
## `itemCondition` (type: `string`):
Search-page condition filter.
## `conditionId` (type: `integer`):
Numeric eBay condition ID β overrides itemCondition when set.
## `sellerType` (type: `string`):
Filter by seller type. EU sites only β works on ebay.de, ebay.fr, ebay.it and ebay.es. On all other sites this filter is ignored and results are unfiltered.
## `aspectFilter` (type: `object`):
eBay aspect facet filters, e.g. {"Brand": "Nike"}. Keys and values are double-encoded per eBay's convention.
## `includeCompletedListings` (type: `boolean`):
When true (default), includes eBay's Completed Listings filter alongside the Sold filter. This enables accurate detection of 'Best Offer Accepted' listings via the listingType and isBestOfferAccepted fields. When false, uses only the Sold filter β all results are guaranteed sold items, but Best Offer Accepted items will appear as regular 'buy_it_now' with the asking price shown as soldPrice.
## `exactMatch` (type: `boolean`):
When true (default), eBay's loosened 'results matching fewer words' items are removed so only listings closely matching the keyword are returned. Set to false to include them.
## Actor input object example
```json
{
"keywords": [
"rtx 4080"
],
"categoryId": "0",
"subcategoryId": "",
"ebaySite": "ebay.com",
"daysToScrape": 30,
"count": 100,
"sortOrder": "endedRecently",
"buyingFormat": "all",
"itemLocation": "default",
"itemCondition": "any",
"sellerType": "any",
"includeCompletedListings": true,
"exactMatch": true
}
```
# Actor output Schema
## `dataset` (type: `string`):
No description
## `overview` (type: `string`):
No description
## `summary` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"keywords": [
"rtx 4080"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("caffein.dev/ebay-sold-listings").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`πΎ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// π Want to learn more π? Go to β https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = { "keywords": ["rtx 4080"] }
# Run the Actor and wait for it to finish
run = client.actor("caffein.dev/ebay-sold-listings").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print(f"πΎ Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item)
# π Want to learn more π? Go to β https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"keywords": [
"rtx 4080"
]
}' |
apify call caffein.dev/ebay-sold-listings --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"type": "http",
"url": "https://mcp.apify.com/?tools=fetch-actor-details,caffein.dev/ebay-sold-listings"
}
}
}
```
The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).
## OpenAPI specification
Download the OpenAPI definition: https://api.apify.com/v2/actors/oTtB3VgfuE9GtxQt2/builds/zjWA2ac2iGFCha8JZ/openapi.json