# eBay Sold Listings & Comps Search

> eBay Sold Listings & Comps Search is a paid API for AI agents from ebay.use.x402atlas.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns sold and completed eBay listings with realized prices and sold dates for pricing research and resale valuation, filterable by condition, price band, category, and regional site.

## Facts

- Endpoint: GET https://ebay.use.x402atlas.com/sold
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ebay-sold-listings-comps-search-ab0fff40
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UPcKipcYonJ-HeEBAk-Ew

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ebay-sold-listings-comps-search-ab0fff40
```

Example prompt: Search eBay sold listings for 'Nintendo Switch OLED' on ebay.com, show me 50 results sorted by best match, condition used (3000), and price between $200 and $350 — I need the realized sale prices and dates to figure out what mine is worth.

## When to prefer this

Use this endpoint when you need historical realized sale prices and sold dates from eBay completed listings — ideal for resale valuation, pricing research, collectibles appraisal, or competitive analysis. Prefer this over live-listing search when you want actual transaction prices rather than asking prices. Choose this over general web scraping when you need structured, clean JSON with condition filtering and multi-regional eBay support.

## Known failure modes

- Empty results array if query yields no sold listings matching filters — adjust query terms or widen price/condition range
- Invalid condition ID returns an error or empty set — use documented codes (1000, 1500, 2000, 2500, 3000, 10)
- Unsupported domain enum value returns a validation error
- min_price greater than max_price may return no results or an error
- Truncated or overly broad queries may return irrelevant comps — be specific with model numbers and variants
- Rate limiting or upstream eBay unavailability may return 5xx errors

## How this service works

eBay sold comps — sold & completed listings with realized prices and sold dates for pricing research and resale valuation, filterable by site, category, price band and condition, as clean JSON.

## Output

A paginated JSON array of sold/completed eBay listings, each containing the item title, realized sale price, currency, sold date, condition, number of bids (if auction), seller username and feedback score, listing URL, item ID, and shipping details. Response includes pagination metadata (page, per_page, total results, next_page cursor) and echoes back the query parameters used.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "page": {
       "type": "integer",
       "default": 1,
       "minimum": 1,
       "description": "Result page number; follow next_page from a previous response"
      },
      "sort": {
       "enum": [
        "best_match",
        "ending_soonest",
        "newly_listed",
        "price_shipping_lowest",
        "price_shipping_highest",
        "distance_nearest"
       ],
       "type": "string",
       "default": "best_match",
       "description": "Sort order"
      },
      "query": {
       "type": "string",
       "maxLength": 300,
       "description": "Free-text query for the item to comp (e.g. \"nintendo switch oled\")"
      },
      "domain": {
       "enum": [
        "ebay.at",
        "ebay.ca",
        "ebay.ch",
        "ebay.co.uk",
        "ebay.com",
        "ebay.com.au",
        "ebay.com.hk",
        "ebay.com.my",
        "ebay.com.sg",
        "ebay.de",
        "ebay.es",
        "ebay.fr",
        "ebay.ie",
        "ebay.it",
        "ebay.nl",
        "ebay.pl"
       ],
       "type": "string",
       "default": "ebay.com",
       "description": "eBay regional site to search"
      },
      "per_page": {
       "enum": [
        25,
        50,
        100,
        200
       ],
       "type": "integer",
       "default": 50,
       "description": "Results per page"
      },
      "condition": {
       "type": "string",
       "description": "Comma-separated condition ids: 1000 New, 1500 Open box, 2000 Certified refurbished, 2500 Seller refurbished, 3000 Used, 10 Not specified"
      },
      "max_price": {
       "type": "number",
       "minimum": 0,
       "description": "Maximum price filter"
      },
      "min_price": {
       "type": "number",
       "minimum": 0,
       "description": "Minimum price filter"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "page": 1,
  "items": [
   {
    "bids": 21,
    "link": "https://www.ebay.com/itm/157012348890",
    "price": {
     "raw": "$232.50",
     "extracted": 232.5
    },
    "title": "Nintendo Switch OLED Model 64GB White Console - Complete in Box",
    "seller": {
     "username": "gamestop_outlet",
     "review_count": 192884,
     "positive_feedback_percent": 98.9
    },
    "location": "United States",
    "shipping": {
     "raw": "Free shipping",
     "free": true
    },
    "condition": "Pre-Owned",
    "sold_date": "Jul 21, 2026",
    "sponsored": false,
    "thumbnail": "https://i.ebayimg.com/images/g/vN8AAOSwq9dnPq0c/s-l500.jpg",
    "product_id": "157012348890",
    "details_link": "https://ebay.use.x402atlas.com/product?product_id=157012348890"
   },
   {
    "link": "https://www.ebay.com/itm/146119207455",
    "price": {
     "raw": "$268.00",
     "extracted": 268
    },
    "title": "Nintendo Switch OLED Splatoon 3 Special Edition Console Bundle",
    "seller": {
     "username": "retro.console.co",
     "review_count": 7761,
     "positive_feedback_percent": 99.6
    },
    "location": "United States",
    "shipping": {
     "raw": "+$14.85 shipping",
     "free": false,
     "extracted": 14.85
    },
    "condition": "Pre-Owned",
    "sold_date": "Jul 18, 2026",
    "sponsored": false,
    "thumbnail": "https://i.ebayimg.com/images/g/hR2AAOSwLtJnKd41/s-l500.jpg",
    "product_id": "146119207455",
    "details_link": "https://ebay.use.x402atlas.com/product?product_id=146119207455"
   }
  ],
  "query": "nintendo switch oled",
  "domain": "ebay.com",
  "per_page": 50,
  "next_page": 2,
  "categories": [
   {
    "id": 139971,
    "name": "Video Game Consoles"
   },
   {
    "id": 54968,
    "name": "Video Game Accessories"
   }
  ],
  "total_results": 12634,
  "related_searches": [
   "nintendo switch oled zelda edition",
   "nintendo switch 2",
   "steam deck oled"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ebay-sold-listings-comps-search-ab0fff40/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ebay.use.x402atlas.com](https://www.zero.xyz/host/ebay.use.x402atlas.com/llms.txt)