> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spidra.io/llms.txt
> Use this file to discover all available pages before exploring further.

# eBay

> Get eBay search results, item details (including sold items' final price), catalog products, stores, seller profiles and feedback as structured data, on every eBay marketplace, for 1 credit per link.

Send an eBay link to [Scrape](https://docs.spidra.io/scrape.md) or [Batch scrape](https://docs.spidra.io/batch-scrape.md) and you get the page's data as JSON: every listing in a search, an item's full details, a catalog product, a store, or a seller's feedback. eBay.com, .co.uk, .de, .com.au, .ca, .fr, .it, .es and the smaller European sites all work, each read from its own country. Each link costs 1 credit, and links that can't be read cost nothing.

## Example

```json theme={null}
{ "urls": ["https://www.ebay.com/sch/i.html?_nkw=espresso+machine"], "output": "json", "wait": true }
```

The item's `result`, shortened to one listing:

```json theme={null}
{
  "type": "search",
  "marketplace": "ebay.com",
  "query": "espresso machine",
  "totalResults": 25000,
  "itemCount": 60,
  "sponsoredCount": 42,
  "page": 1,
  "hasNextPage": true,
  "items": [
    {
      "itemId": "127591681213",
      "title": "AIRMSEN BCM2316 Espresso Machine w/Grinder, Brushed Stainless Steel",
      "price": 94,
      "currency": "USD",
      "condition": "Open Box",
      "buyingFormat": "buyItNow",
      "soldCount": 213,
      "shippingText": "Free delivery in 2-4 days",
      "seller": { "name": "vipoutlet", "feedbackPercent": 97.2, "feedbackScore": 1000000 }
    }
  ]
}
```

## Links that work

| Link | Example | You get |
| - | - | - |
| Search | `ebay.com/sch/i.html?_nkw=...` with any filters, sort (`_sop`), page (`_pgn`) and page size (`_ipg`) | Every listing, totals, next page and related searches |
| Category | `ebay.com/b/<name>/<id>/...` | Read as a search in that category |
| Item | `ebay.com/itm/<id>` | The item's full details, including ended and sold listings |
| Product | `ebay.com/p/<epid>` | The catalog product and its first page of listings |
| Store or user | `ebay.com/str/<name>`, `ebay.com/usr/<name>` | The seller's details and listings (and recent feedback for users) |
| Feedback | `ebay.com/fdbk/feedback_profile/<name>` | Score, percent, ratings and the 25 entries on the page |

## Fields

**Search listing:** `position`, `itemId`, `title`, `url`, `imageUrl`, `condition`, `price`, `priceMax`, `currency`, `originalPrice`, `shippingCost`, `shippingText`, `deliveryText`, `buyingFormat`, `bestOffer`, `bids`, `timeLeft`, `soldCount`, `watchers`, `location`, `seller` (name and feedback), `rating`, `ratingCount`, `badges`, `sponsored` and `epid`.

**Item:** `itemId`, `title`, `listingStatus`, `sold`, `price`, `approximatePrice`, `originalPrice`, `condition`, `conditionDescription`, `sellerNotes`, `availability`, `quantityAvailable`, `soldCount`, `watchers`, `buyingFormat`, `bids`, `currentBid`, `reserveMet`, `timeLeft`, `startTime`, `endTime`, `shipping`, `returns`, `paymentMethods`, `seller`, `itemSpecifics`, `productDetails`, `variations` (price and stock each), `images`, `breadcrumbs`, `categoryId`, identifiers (`epid`, `upc`, `ean`, `gtin`, `mpn`, `brand`), `rating`, `reviews` and the seller's `description`.

An ended or sold listing still opens, so an item link also gives a sold item's final price.

## Limits

* **Sold searches** (`LH_Sold=1` or `LH_Complete=1`) need a sign-in on eBay, so they fail with an explanation and cost nothing. Open the sold item links themselves instead.
* Pages are read as a signed-out visitor; your cookies are never sent to eBay.

## Templates

Ready-made [templates](https://docs.spidra.io/templates.md) for eBay: listings for a search or category, item details, store listings, seller feedback and seller profiles.

> [!NOTE]
>
> Check eBay's terms before you collect data from it. You're responsible for how you use what you collect.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.