# eBay Product API (https://www.socialcrawl.dev/platforms/ebay/product)

> Returns full detail for a single eBay listing: title, brand, price, original price, currency, condition and condition notes, MPN and UPC, units available, units sold, watchers, and the seller. The seller block is the reason to call this rather than search: product.ext.seller_reputation carries lifetime feedback percentage and count, top-rated status, items sold, join date, and four detailed sub-ratings for description accuracy, shipping cost, shipping speed, and communication. One known gap: eBay's detail response currently returns a corrupt image array, so image_urls is null here. Use the image on the matching GET /v1/ebay/search row, which is unaffected.

TL;DR: `GET /v1/ebay/product` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `product_id` | yes | eBay item id, the numeric id in a listing URL: ebay.com/itm/327256602116 is item id 327256602116. Item ids also come back on every row of GET /v1/ebay/search. |
| `country` | no | eBay marketplace as a two-letter country code: US (ebay.com, default), GB, AU, CA, DE, FR, IT, ES, IE, AT, CH, NL, BE, PL, SG, MY, PH, HK, or MX. The marketplace sets the listing pool, language, and currency. (US \| GB \| AU \| CA \| DE \| FR \| IT \| ES \| IE \| AT \| CH \| NL \| BE \| PL \| SG \| MY \| PH \| HK \| MX) |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/ebay/product?product_id=327256602116" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What makes this different from a search row?

The seller block. Detail carries lifetime feedback, top-rated status, join date and four detailed sub-ratings, none of which appear on a search row.

### Are item specifics like MPN and UPC included?

Where the seller entered them. A marketplace listing fills whatever specifics its seller bothered with, so these are populated on some listings and null on others.

### Why is there no image on listing detail?

eBay's detail response returns a corrupt image array, so the field stays null rather than carrying a value that cannot resolve. Take the image from the matching search row.

### Does it show how many units are left?

Yes, the available quantity, alongside the number already sold and the watcher count, which together read as demand on a live listing.

### Is the shipping text returned?

No. eBay ships it as an unparsed run-on scrape mixing carrier, cost and location, so there is no canonical field it is honest data for. The clean location is returned instead.

See the full eBay API: https://www.socialcrawl.dev/platforms/ebay

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I look up an eBay listing by item id?
- How to check an eBay seller's detailed ratings with an API
- Can I see how many units are left on an eBay listing?