eBay Product Data API - Live Listings, Units Sold, Sellers
Search live eBay listings with price, condition, bids, units sold and watchers, read a listing in full, and look up a seller's profile card as structured JSON. 3 endpoints, 1 credit each. Sold-listing search is currently unavailable (eBay now requires a signed-in account for it).
eBay via Scavio
Search eBay's live listings, read a single listing in full, and pull a seller's public profile card. Every search row carries demand signals (units sold, watchers, bids). All endpoints return structured JSON and cost 1 credit each.
Sold and completed listings are not available: since late August 2026 eBay shows them only to signed-in accounts, so sold: true returns an unbilled 400.
When to trigger
Use this skill when the user asks to:
- Price an item against live eBay asks, using units sold, watchers and bids to separate listings that sell from optimistic ones
- Search live eBay listings by keyword, price band, condition or buying format
- Filter to auctions, Buy It Now or Best Offer listings
- Read one eBay listing in full: item specifics, shipping, returns, auction state
- List everything a particular eBay seller has for sale
- Look up an eBay seller's feedback score, items sold and location
- Compare eBay resale prices against retail (pair with scavio-amazon, scavio-walmart or scavio-target)
Setup
Get a free API key at scavio.dev (50 free credits to get started, no card required):
export SCAVIO_API_KEY=sk_live_your_key
If you do not have a key yet
An agent running this skill without SCAVIO_API_KEY set will get 401 on every
call below. The whole path from nothing to a working key is self-serve:
- Sign up at dashboard.scavio.dev - email or Google, no card required.
- A key is created for the account automatically at signup. It is on the dashboard under API Keys, ready to copy.
- A new account starts with 50 credits. Endpoints in this skill cost 1 credit each unless the table below says otherwise.
When the balance runs out the API answers 402 with a JSON body carrying
billing_url. Topping up needs no code change - the same key keeps working.
The smallest purchase is 2,500 credits for $25, and monthly plans work out
cheaper per credit if the usage is steady rather than one-off.
Every request is a POST with a JSON body and:
Authorization: Bearer $SCAVIO_API_KEY
Endpoints
Base URL: https://api.scavio.dev. Every endpoint costs 1 credit.
| Endpoint | Credits | Description |
|---|---|---|
POST /api/v1/ebay/search | 1 | Search live listings: price, condition, bids, units sold, watchers, shipping, seller, feedback |
POST /api/v1/ebay/product | 1 | One listing in full: images, item specifics, shipping, returns, auction state, seller |
POST /api/v1/ebay/seller | 1 | Seller profile card: store name, feedback score and percentage, items sold, followers, location, categories |
Workflow
- Price research: call
/ebay/searchwithquery(addconditionandsort_by). Weight each ask by itssold_count,watchersandbids: those are the listings buyers act on. Do not sendsold: true; it returns400(see below). - Live listings: call
/ebay/searchwithquery, filtered by price, condition or format. - Read a listing: call
/ebay/productwithitem_id(the eBay item number, or a fullebay.com/itm/...URL — tracking parameters are discarded). - List a seller's inventory: call
/ebay/searchwithsellerset and NOquery. That is the paginated route through a seller's catalogue. - Seller reputation: call
/ebay/sellerwith the username as it appears inebay.com/usr/<name>.
/search paginates with page. /product and /seller do not paginate.
Parameters
Search (/search)
query or seller is required. At least one must be present.
| Parameter | Type | Default | Description |
|---|---|---|---|
query | string | one of | Search keywords (1-500 chars) |
seller | string | one of | Scope to one seller (1-64 chars). Usable with NO query to page their whole catalogue |
page | integer >= 1 | -- | Results page, 1-based |
per_page | integer | 60 | Accepts ONLY 60, 120 or 240 |
sort_by | string | best_match | best_match, ending_soonest, newly_listed, price_low, price_high |
min_price | number >= 0 | -- | Minimum price filter |
max_price | number >= 0 | -- | Maximum price filter |
condition | string | -- | new, open_box, refurbished, used, for_parts |
buying_format | string | -- | auction, buy_it_now, best_offer |
free_shipping | boolean | -- | Only listings with free shipping |
sold | boolean | -- | Currently unavailable: eBay requires a signed-in account for completed and sold listings, so sold: true returns an unbilled 400 |
category_id | string | -- | Numeric eBay category id, e.g. 112529 |
Product (/product)
| Parameter | Type | Default | Description |
|---|---|---|---|
item_id | string | required | eBay item number (e.g. 168591664725) or a full ebay.com/itm/... URL |
Seller (/seller)
| Parameter | Type | Default | Description |
|---|---|---|---|
seller | string | required | eBay username as in ebay.com/usr/<name>, e.g. red-rock-uk (1-64 chars) |
Examples
import requests
BASE = "https://api.scavio.dev"
# Your key from https://scavio.dev. Load it from your environment or secret
# store in real code - keep it out of source control.
API_KEY = "sk_your_key_here"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# 1. Price research: used asks, with demand signals on every row
used = requests.post(f"{BASE}/api/v1/ebay/search", headers=HEADERS,
json={"query": "nintendo switch oled", "condition": "used"}).json()
for row in used["data"]["products"]:
print(row["price"], row["sold_count"], row["watchers"], row["bids"], row["url"])
# 2. Live listings, cheapest first, 120 per page
live = requests.post(f"{BASE}/api/v1/ebay/search", headers=HEADERS,
json={"query": "nintendo switch oled", "sort_by": "price_low", "per_page": 120}).json()
# 3. One listing in full
item = requests.post(f"{BASE}/api/v1/ebay/product", headers=HEADERS,
json={"item_id": "168591664725"}).json()
# 4. A seller's whole catalogue: /search with seller and no query
catalogue = requests.post(f"{BASE}/api/v1/ebay/search", headers=HEADERS,
json={"seller": "red-rock-uk", "page": 1}).json()
# 5. That seller's reputation card
profile = requests.post(f"{BASE}/api/v1/ebay/seller", headers=HEADERS,
json={"seller": "red-rock-uk"}).json()
Response
Every response uses the envelope { data, response_time, credits_used, credits_remaining }.
- search returns the listing rows with price, condition, bids,
sold_count,watchers, shipping, seller and feedback, alongsidecountandtotal_results.sold_countis capped by eBay above a threshold, so "1,558+ sold" means at least that many. - product returns price, condition, images, item specifics, shipping, returns, auction state and seller.
- seller returns store name, feedback score and percentage, items sold, followers, location and categories.
Guardrails
- Never fabricate prices, item numbers, feedback scores or seller names. Only return data the API returned.
/selleris a PROFILE endpoint. It cannot enumerate a catalogue. If the user wants a seller's items, use/searchwithsellerset and no keyword.per_pageaccepts only60,120or240. eBay silently falls back to 60 for any other value, so a request for 100 quietly returns 60 and looks successful.category_idmust be numeric. An unrecognised category id returns the UNFILTERED result set under a200, which looks like a successful filter and is not one. Verify the id before relying on it.condition: "refurbished"is eBay's parent condition, not one of its three graded refurbished tiers. Do not present it as a specific grade.- There is no "Distance: nearest first" sort. It ranks against a location other than the caller's, so it is deliberately absent. Never recommend it.
- Live asks are not sale prices. When the user asks what something sold for, say that sold history is unavailable and present asks with their units sold, watchers and bids instead.
- Always include the listing URL so the user can verify.
Failure handling
400means an invalid or missing parameter, most often neitherquerynorsellerbeing supplied, orsold: true(unavailable). Fix and retry.401means the API key is invalid or missing. CheckSCAVIO_API_KEY.404means the item or seller was not found. Check the item number or theebay.com/usr/<name>spelling.429means a rate or usage limit was exceeded. Wait before retrying. See rate limits.502/503mean the upstream is temporarily unavailable. Wait a few seconds before retrying.- If
SCAVIO_API_KEYis not set, prompt the user to export it before continuing.
Docs
Related skills
- Downloads
- 842All time
- Security audit
- Pass
- Last updated
- 2w ago
- Current version
- v1.0.6
- License
- MIT-0
