# eBay Search Scraper (x402)

> eBay Search Scraper (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-02).

Searches eBay listings and returns structured product data including prices, titles, and item IDs, with pay-per-call billing via x402.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/ebay-search?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ebay-search-scraper-x402-142af4ea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_prybCR9QW_w3hdY3aRI9x

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-search-scraper-x402-142af4ea -d '<json body>'
```

Example prompt: Search eBay for used mechanical keyboards under $150, sorted by price low to high, and give me the top 50 active listings with their prices and URLs from ebay.com.

## When to prefer this

Choose this endpoint when you need structured eBay listing data programmatically — price research, inventory analysis, resale arbitrage, or market value estimation — especially when you want filtering by price range, condition, seller, listing type, or regional eBay marketplace. Prefer over manual scraping or generic web scrapers because it returns clean JSON with numeric price fields and only charges on successful non-empty runs.

## Known failure modes

- Empty result set if no listings match filters (not charged)
- Invalid category ID returns error or empty results
- Unsupported marketplace domain returns error
- Rate limiting or eBay anti-scrape measures may cause partial results
- Invalid startUrls format causes parsing failure
- Payment failure via x402 prevents execution

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of items and an array of listing objects, each containing the item title, URL, item ID, price (formatted), price value (numeric), currency, and original price if discounted. Failed or empty searches are not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "active",
    "sold",
    "both"
   ],
   "type": "string",
   "default": "active",
   "description": "Collect active listings, sold listings, or both. Sold listings are shown as eBay reports them on search pages."
  },
  "seller": {
   "type": "string",
   "description": "Restrict a keyword search to one public seller username."
  },
  "sortBy": {
   "enum": [
    "best_match",
    "ending_soon",
    "newest",
    "price_asc",
    "price_desc"
   ],
   "type": "string",
   "default": "best_match",
   "description": "Result order for keyword searches."
  },
  "category": {
   "type": "string",
   "description": "Restrict a keyword search to a numeric eBay category ID."
  },
  "maxItems": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Total cap across all searches and modes. Set 0 for no cap."
  },
  "maxPrice": {
   "type": "number",
   "minimum": 0,
   "description": "Maximum price in the marketplace currency for keyword searches."
  },
  "minPrice": {
   "type": "number",
   "minimum": 0,
   "description": "Minimum price in the marketplace currency for keyword searches."
  },
  "condition": {
   "enum": [
    "any",
    "new",
    "open_box",
    "refurbished",
    "used",
    "for_parts"
   ],
   "type": "string",
   "default": "any",
   "description": "Condition filter for keyword searches. Start URLs retain their own filters."
  },
  "startUrls": {
   "type": "array",
   "description": "Optional eBay search URLs or individual item URLs. Regional eBay domains are supported."
  },
  "listingType": {
   "enum": [
    "all",
    "auction",
    "bin",
    "best_offer"
   ],
   "type": "string",
   "default": "all",
   "description": "Auction, Buy It Now, or Best Offer filter for keyword searches."
  },
  "marketplace": {
   "enum": [
    "ebay.com",
    "ebay.co.uk",
    "ebay.de",
    "ebay.fr",
    "ebay.it",
    "ebay.es",
    "ebay.ca",
    "ebay.com.au",
    "ebay.nl",
    "ebay.at",
    "ebay.ch",
    "ebay.ie",
    "ebay.pl",
    "ebay.com.hk",
    "ebay.com.my",
    "ebay.ph",
    "ebay.com.sg"
   ],
   "type": "string",
   "default": "ebay.com",
   "description": "Regional eBay site for keyword searches. A start URL uses its own domain."
  },
  "searchQuery": {
   "type": "string",
   "description": "Keywords to search, such as mechanical keyboard. Combine with the marketplace and filters below."
  },
  "freeShipping": {
   "type": "boolean",
   "def
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "url": null,
    "price": null,
    "title": null,
    "itemId": null,
    "currency": null,
    "priceValue": null,
    "originalPrice": null,
    "originalPriceValue": null
   }
  ],
  "product": "ebay-search"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ebay-search-scraper-x402-142af4ea/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)