**More from this account:** [YouTube Transcript Suite](https://apify.com/vonsensey/youtube-transcript-scraper) · [Website Contact & Email Suite](https://apify.com/vonsensey/website-contact-email-extractor) · [Career Site & ATS Jobs Suite](https://apify.com/vonsensey/career-page-job-postings-scraper-api) · [Google News Suite](https://apify.com/vonsensey/google-news-scraper-api) · [Keyword Research Suite](https://apify.com/vonsensey/google-keyword-ideas-scraper) · [Shopify Store Intelligence Suite](https://apify.com/vonsensey/shopify-store-leads-scraper) · [Amazon Reviews Suite](https://apify.com/vonsensey/amazon-reviews-scraper-api) · [Reddit](https://apify.com/vonsensey/reddit-scraper-posts-comments-api) · [Meta Ad Library](https://apify.com/vonsensey/facebook-ads-library-scraper-meta-ad-api) · [Vinted](https://apify.com/vonsensey/vinted-scraper-api)
Turn any eBay keyword, item number or seller name into clean, typed JSON.
Four things in one API: **active listings**, **full item detail**, **a seller's entire
inventory**, and **confirmed sale prices — what buyers actually paid**.
- **No login. No eBay API key. No developer application.**
- **No actor start fee.** You pay for rows, never for pressing Run.
- **A run that finds nothing costs nothing.** Errors and diagnostics are free rows.
- **19 marketplaces**, each served from its own country so prices come back in the site's own
currency. Four are measured end-to-end — US, Germany, France, Italy — with the coverage table
below; the rest are supported but unmeasured.
- **Set a hard ceiling on what a single run may cost**, in dollars.
> Unofficial and not affiliated with, endorsed by, or sponsored by eBay Inc.
> "eBay" is a trademark of eBay Inc. This actor reads only public, unauthenticated
> pages.
***
### Read this before you buy: eBay's sold-listings search needs a login now
Reported since **23 July 2026**, and verified by us on **18 August 2026**: eBay sends every
anonymous request for *sold* or *completed* search results to a sign-in wall. We checked it with
a real Chrome browser across twelve URL variants, four independent network paths, three
marketplaces, desktop and mobile. Every keyword-search variant lands on `signin.ebay.com`.
**So this actor does not sell you a keyword search over eBay's sold listings, because
nobody can deliver one without an eBay account.** If you point it at a sold-search URL,
you get a free row telling you exactly that, instead of an empty dataset and a bill.
**What you get instead is better for most jobs: real transaction prices.** For any seller, this
actor returns their confirmed completed orders — the price paid, the item, the item number and
the buyer's verdict on the order — and you can filter that feed by keyword. Measured on
18 August 2026: **at least 40,000 transactions reachable per seller**, and on a recent window
every row carried a price.
That is a sale that happened, at a price someone actually paid. Not an asking price.
***
### What you get
| Mode | Give it | Get back |
|---|---|---|
| **Search** | keywords, or any eBay search URL | every matching active listing, up to Max results |
| **Item** | item numbers or `/itm/` URLs | everything on the item page |
| **Seller** | a username | that seller's whole active inventory |
| **Sales** | a username (+ optional keyword) | confirmed orders with the price paid |
Most runs also get a **price summary** row — min, 25th percentile, median, 75th, 90th, max,
mean, standard deviation, total value and graded share. It is billed once per query, not per
result, and it is skipped entirely when a query returned fewer than 10 priced rows. Item mode
does not produce one.
Every run that gets past input validation also gets a **free diagnostics** row telling you how
many pages were fetched, how many were blocked, and exactly why the run stopped.
#### Listing rows
`itemId` · `url` · `title` · `price` · `priceMax` · `currency` · `priceIsRange` ·
`condition` · `listingFormat` · `bestOffer` · `bids` · `timeLeft` · `shippingCost` ·
`freeShipping` · `shippingIsEstimate` · `itemLocation` · **`soldCount`** · **`watchers`** ·
`imageUrl` · `isGraded` · `gradingCompany` · `grade` · **`queryTokenOverlap`** ·
**`titleMatchesQuery`** · `sellerName` · `sellerFeedbackScore` · `sellerPositivePct`
Two notes on those last three. eBay does **not** put the seller on a search result card, so
`sellerName` is filled in Seller mode (you named them) and on Item rows, and is `null` on a plain
keyword search rather than guessed. And every field on a row comes from that row's own listing —
nothing is ever borrowed from a neighbouring card, which is the quiet way a comps table gets
corrupted.
`titleMatchesQuery` is the other rare one. Thin result pages come back mixed with loosely related
listings that no filter catches, and they are the likeliest reason a median comes out wrong. Each
row scores how much of your query its title actually contains, so you can drop the padding
instead of averaging it into your numbers.
**`watchers` is the rarest field here.** Reviewing the published output fields of the twenty
largest eBay actors on the Apify Store in August 2026, we found none returning watch counts. It
is the cheapest demand signal eBay publishes, and it costs you nothing extra to receive.
#### Item rows
`itemId` · `url` · `title` · `price` · `currency` · `condition` · `conditionCode` ·
`soldCount` · `watchers` · `shippingCost` · `sellerName` · `sellerFeedbackScore` ·
`sellerPositivePct` · `isGraded` · `gradingCompany` · `grade` — plus `availability`,
`quantityAvailable`, `shippingCurrency`, `returnsAccepted`, `returnDays`, `brand`, `mpn`,
`model`, `color`, `images[]`, `productRating`, `productRatingCount`, `itemSpecifics{}` and
`categoryPath[]`.
An item row is not a superset of a listing row: auction-only fields (`bids`, `timeLeft`,
`bestOffer`, `listingFormat`) and the search-relevance fields live on listing rows only.
#### Sale rows
`feedbackId` · `seller` · **`price`** · `currency` · `itemId` · `itemUrl` · `itemTitle` ·
`rating` · `comment` · `buyer` · `buyerFeedbackScore` · `verifiedPurchase` ·
`automatedFeedback` · `periodBucket` · `recencyRank` · `isGraded` · `gradingCompany` ·
`grade`
***
### Honest limits, stated up front
Every actor in this category has these. Most do not tell you.
| Limit | The truth |
|---|---|
| **Sold-listing keyword search** | Not offered. eBay requires a login for it — see above. |
| **Sale dates** | eBay publishes only a coarse recency band, never a date, so there is no `soldDate` field — there is no honest way to fill one. `recencyRank` gives you exact ordering instead. |
| **Sale price coverage** | Varies by seller, and recent orders fare best. Measured across five sellers: 100%, 100%, 99%, 100% and 11%. Older feedback tends to keep the price but lose the link to the item. Use the **Sales period** filter to stay in the high-coverage window, and check `rowsFilteredOut` and the price fill in your own output rather than assuming. |
| **Search depth** | Any one query can only be paged so deep. This actor detects the end of the real results, never bills you twice for the same listing, and says so in the diagnostics row. Split a broad query by price band or category to reach more. |
| **Seller inventory depth** | Far deeper — 25,000+ items reachable for a large seller. |
| **Watchers & sold counts** | eBay prints these on some cards only, and which one it prints varies by surface. Measured on our own captured pages: watchers on 8-32% of US search cards, **0% of seller-inventory cards and 0% on DE/FR/IT**; sold counts are the reverse, 98% on seller inventory. Always `null`, never guessed — so filter on them, do not assume them. |
| **Seller on search rows** | eBay does not print the seller on a search card. Use Seller mode, or Item mode, where it is filled. |
| **Blocks** | eBay challenges some requests. When it does and will not relent, you get a **free** error row naming the input that failed. This actor never reports success on a page it could not read, and never bills you for one. |
| **Filters run after the fetch** | `excludeKeywords` and `gradeFilter` apply to rows eBay already returned. The diagnostics row reports how many were removed, and if they removed everything you get a free `ALL_FILTERED` row rather than an empty dataset. |
***
### Pricing
| You are charged for | FREE | BRONZE | SILVER | GOLD+ |
|---|---|---|---|---|
| Each listing row | $4.00 / 1,000 | $3.50 / 1,000 | $3.00 / 1,000 | **$2.50 / 1,000** |
| Each full item-detail row | $9.00 / 1,000 | $8.00 / 1,000 | $7.00 / 1,000 | $6.00 / 1,000 |
| Each confirmed sale row | $6.00 / 1,000 | $5.30 / 1,000 | $4.60 / 1,000 | $4.00 / 1,000 |
| Each price-summary row | $0.05 | $0.044 | $0.039 | $0.035 |
The price summary is one row per query, not per result, and it is skipped entirely on a query
that returned fewer than 10 priced rows — a percentile spread over a handful of listings is
noise, and you should not pay for noise. Turn it off with `includeMarketSummary: false`.
**Never charged:** pressing Run, error rows, diagnostics rows, duplicate rows, or a run
that returns nothing.
Item-detail costs more than a listing row because an item page is roughly 25 times the
data. If you only need price, condition, shipping and seller, stay in Search mode — it is
the cheap one, and it is what the headline price refers to.
**Set `maxCostUsd` and the run stops before it can exceed it**, priced at the highest tier so
the ceiling holds whatever plan you are on. Reviewing the input schemas of the twenty largest
eBay actors in August 2026, we found none exposing a spend ceiling as a run input.
***
### How to scrape eBay sold prices for a seller
Set **What to scrape** to *Sales*, put the seller's username in **Sellers**, and
optionally set **Filter sales by keyword**.
```json
{
"mode": "sales",
"sellers": ["musicmagpie"],
"salesKeyword": "vinyl",
"salesPeriod": "SIX_MONTHS",
"maxItems": 1000
}
```
Every row is a completed order with the amount paid. Filtering by keyword is how you get
comparable sales for one product: pick the sellers who move that product, then read what
their buyers actually paid.
### How to scrape eBay listings by keyword
```json
{
"mode": "search",
"searchQueries": ["nintendo switch oled", "steam deck oled"],
"condition": "used",
"minPrice": 100,
"maxPrice": 400,
"sortBy": "price_lowest",
"maxItems": 500
}
```
**There is no limit on how many keywords you can pass** — the largest actor in this category
caps its keyword list at six. Note that `maxItems` is a ceiling for the whole run, shared across
every keyword, so raise it when you pass many. Keywords the run never reached get a free
`NOT_REACHED` row naming them, rather than vanishing.
### How to scrape an eBay seller's entire inventory
```json
{ "mode": "seller", "sellers": ["musicmagpie"], "maxItems": 5000 }
```
You can add a keyword to search inside that seller's inventory, and any of the price,
condition or format filters.
### How to get full detail for the results of a search
Search and item detail are two calls on purpose, so you are never billed for detail pages you
did not ask for. Run the search, keep the `itemId` of the rows you actually care about, then feed
those into Item mode:
```js
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: '