ebay-product-data
eBay product data API: search live listings with price, condition, bids, units sold, watchers, shipping and seller feedback, read one listing in full with item specifics, shipping, returns and auction state, and pull a seller's feedback score, items sold and location. 3 endpoints, 1 credit each. Sold-listing search is currently unavailable.
scavio-ai · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add scavio-ai/skills --skill ebay-product-data技能说明
name: ebay-product-data description: "eBay product data API: search live listings with price, condition, bids, units sold, watchers, shipping and seller feedback, read one listing in full with item specifics, shipping, returns and auction state, and pull a seller's feedback score, items sold and location. 3 endpoints, 1 credit each. Sold-listing search is currently unavailable." version: 1.0.0 tags: ebay, ebay-product-data, live-listings, price-research, resale, ecommerce, marketplace, product-data, seller-profile, price-monitoring, arbitrage, auctions, langchain, crewai, autogen, structured-data, json, ai-agents metadata: openclaw: requires: env: - SCAVIO_API_KEY primaryEnv: SCAVIO_API_KEY timeout: 120 throttle: 1 emoji: "\U0001F4E6" homepage: https://scavio.dev/docs/ebay-search?utm_source=agent-skills&utm_medium=skill&utm_campaign=ebay-product-data
eBay Product Data API - Live Listings, Units Sold, Sellers
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)
| Pa
阅读完整来源 ↗