#ebay #ebay-product-data #live-listings #price-research

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).

Scavio AI@scavio-ai

Install

openclaw skills install @scavio-ai/ebay-product-data

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):

bash

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:

text

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/search with query (add condition and sort_by). Weight each ask by its sold_count, watchers and bids: those are the listings buyers act on. Do not send sold: true; it returns 400 (see below).
Live listings: call /ebay/search with query, filtered by price, condition or format.
Read a listing: call /ebay/product with item_id (the eBay item number, or a full ebay.com/itm/... URL — tracking parameters are discarded).
List a seller's inventory: call /ebay/search with seller set and NO query. That is the paginated route through a seller's catalogue.
Seller reputation: call /ebay/seller with the username as it appears in ebay.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

python

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, alongside count and total_results. sold_count is 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.
/seller is a PROFILE endpoint. It cannot enumerate a catalogue. If the user wants a seller's items, use /search with seller set and no keyword.
per_page accepts only 60, 120 or 240. eBay silently falls back to 60 for any other value, so a request for 100 quietly returns 60 and looks successful.
category_id must be numeric. An unrecognised category id returns the UNFILTERED result set under a 200, 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

400 means an invalid or missing parameter, most often neither query nor seller being supplied, or sold: true (unavailable). Fix and retry.
401 means the API key is invalid or missing. Check SCAVIO_API_KEY.
404 means the item or seller was not found. Check the item number or the ebay.com/usr/<name> spelling.
429 means a rate or usage limit was exceeded. Wait before retrying. See rate limits.
502 / 503 mean the upstream is temporarily unavailable. Wait a few seconds before retrying.
If SCAVIO_API_KEY is not set, prompt the user to export it before continuing.