eBay Seller Items API — A Store's Active Listings
Send an eBay seller's username or store URL and this source returns their current active listings — subtitle, price, condition and image for each one.
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "ebay_seller_items",
"seller": "musicmagpie",
"max_items": 2,
"start_page": 1,
"human": "# eBay seller items\n\n- **Seller:** musicmagpie\n- **Starting page:** 1\n- **Max items:** 2\n- **Records returned:** 2\n- **Proxy traffic:** 619.0 KB",
"machine": {
"total_items": 2,
"items": [
{
"id": "381476869606",
"url": "https://www.ebay.com/itm/381476869606?itmmeta=01M39RKVHJC9AB0RY5ZY2CBCG7&hash=item58d1cb15e6:g:ih8AAOSw0iBj2Esy",
"price": 5.38,
"currency": "USD",
"list_price": null,
"condition": "Pre-Owned",
"subtitle": "The Stone Roses : The Stone Roses CD (1997) Incredible Value and Free Shipping!Opens in a new window or tab",
"sold_count": null,
"image": "https://i.ebayimg.com/images/g/ih8AAOSw0iBj2Esy/s-l500.webp",
"buying_format": null,
"bid_count": null,
"has_best_offer": false
},
{
"id": "291623911254",
"url": "https://www.ebay.com/itm/291623911254?itmmeta=01M39RKVHJKZTD7HE9W0M2Q52J&hash=item43e623bf56:g:7o4AAOSwr1BoUf9D",
"price": 19.96,
"currency": "USD",
"list_price": null,
"condition": "Pre-Owned",
"subtitle": "Crystal Castles : Crystal Castles CD (2010) Incredible Value and Free Shipping!Opens in a new window or tab",
"sold_count": null,
"image": "https://i.ebayimg.com/images/g/7o4AAOSwr1BoUf9D/s-l500.webp",
"buying_format": null,
"bid_count": null,
"has_best_offer": false
}
],
"proxy_traffic_bytes": 633892
},
"total_points": 2
}- You send
- An eBay seller username or store URL, plus how many listings to return
- You get back
- The seller's active listings: subtitle, price, condition and image
- Coverage
- eBay sellers with public active listings.
- Price
- 1 point per returned result, up to 500 per request — $1 per 1,000
- Billed per record actually returned, capped by max_items. A seller with no active listings costs nothing.
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| Browsing a store by hand | Open the storefront and scroll through listings | Free, and slow for a store with any real inventory | Fine for a quick check, unworkable for ongoing tracking |
| Building a scraper | Write it, host it, repair it when eBay's page markup changes | Engineering time | A maintenance commitment for something that isn't your product |
| NeuralVerge | One request per seller, listing count as a parameter | $1 per 1,000 returned results | Reflects what's listed at request time — a store can add or remove items between calls |
What you get back
Every field in the response shown above.
| Field | Type | Description |
|---|---|---|
id | string | eBay's item ID for the listing. |
url | string | Direct link to the listing. |
price | number | Current listed price. |
currency | string | Currency code the price is in. |
list_price | number | The struck-through "was" price, when eBay publishes one. |
condition | string | Condition as the seller describes it. |
subtitle | string | The listing's title/subtitle text as shown in the seller's storefront. |
sold_count | number | Number of units sold, when eBay publishes a count. |
image | string | Primary listing image URL. |
buying_format | string | eBay's format code, when set, e.g. "FIXED_PRICE" or "AUCTION". |
bid_count | number | Number of bids, for auction-format listings. |
has_best_offer | boolean | Whether the listing accepts best-offer negotiation. |
How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
seller is required; max_items caps results at 500 and defaults to 25. start_page pages through listings beyond that cap.
curl -X POST https://api.neuralverge.ai/functions/v1/run-ebay-seller-items \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "seller": "musicmagpie", "max_items": 25 }'What teams use it for
Where this field shows up in an actual workflow.
See what a competing store currently has listed and at what price.
Pull a supplier's full active listing set before placing an order.
Compare what a store carries against your own catalog to spot what you're missing.
Run the same seller on a schedule and diff the results to catch price or stock changes.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
eBay sellers with public active listings.
Read at request time.
This source returns publicly visible listing information, stamped with the seller identifier it was read from and a session id you can trace.
- —Only covers listings that are active at request time; sold-out or ended items drop off.
- —Large stores can list far more items than fit in one request — raise max_items or page with start_page to get the full set.
- —Reflects what the seller entered, which isn't independently verified.
Questions, answered
This returns what the seller currently has listed. Feedback returns the ratings they've received — same seller identifier, different data.
Related sources
Try ebay seller items on your own data
One request format across every source in the catalog.