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

> eBay's official API is gated behind an application process and a production key. SocialCrawl covers it with 2 endpoints and an ordinary API key: keyword search returning sixty listings a call, and full listing detail by item id. The detail response carries seller reputation at a depth nothing else here sells, including lifetime feedback, top-rated status and four detailed sub-ratings.

TL;DR: SocialCrawl's eBay API exposes 2 endpoints, 5 credits per call, all returning one unified JSON schema with AI-enriched fields. Single x-api-key auth, 100 free credits on signup.

## Endpoints

| Endpoint | Method | Path | Credits | Description |
| --- | --- | --- | --- | --- |
| Search | GET | `/v1/ebay/search` | 5 | Search eBay listings |
| Product | GET | `/v1/ebay/product` | 5 | Get an eBay listing by item id |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/ebay/search?query=airpods%20pro" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

Every response shares one JSON envelope: `{ success, platform, endpoint, data, credits_used, credits_remaining }`.

## FAQ

### Do I need an eBay developer account?

No. You call SocialCrawl with your own API key and we handle the sourcing, so there is no eBay application process, production key or per-marketplace registration to get through.

### Which eBay marketplaces are supported?

Nineteen, selected with a two-letter country code: the US, UK, Australia, Canada, Germany, France, Italy, Spain and others. The marketplace sets the listing pool, language and currency.

### What seller data comes back?

Handle, 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.

### Why is image_urls null on listing detail?

eBay's detail response currently returns a corrupt image array, so we publish null rather than a string that cannot resolve. The matching search row carries a real image URL and is unaffected.

### Can I crawl an entire eBay search?

Yes, though the result total eBay reports is an estimate that changes between pages, so we do not return it. Paginate until a page comes back empty rather than trusting a count.

### Is seller feedback history available?

Not as its own endpoint yet. It proved unreliable on probing, returning empty for sellers with tens of thousands of feedback, so it is held. The reputation summary on every listing covers most needs.

## 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 get eBay listing data without a developer account?
- How to check an eBay seller's feedback score with an API
- How do I track eBay prices programmatically?
- Which eBay marketplaces can I search through one API?