# eBay Product Search Scraper (x402)

> eBay Product Search Scraper (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/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?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ebay-product-search-scraper-x402-f29061c0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hVlWfyiyjApmBffc6LfUv

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

Example prompt: Search eBay US for 'Sony WH-1000XM5 headphones', show me up to 20 results sorted by lowest price, only new or refurbished condition, buy-it-now listings only, between $150 and $350.

## When to prefer this

Use this endpoint when you need structured eBay listing data — prices, titles, item IDs — without building your own scraper or managing browser automation. Prefer it over generic web scraping tools when you specifically need eBay marketplace data with built-in retry logic, condition and listing-type filters, and multi-marketplace support. Its pay-per-call model (no charge for failed/empty runs) makes it cost-effective for exploratory or low-volume queries.

## Known failure modes

- No listings found for the query (not charged)
- eBay blocks scraping attempt after max retries exhausted (not charged if empty)
- Invalid marketplace code returns validation error
- Search query array is empty — at least one keyword required
- maxSearchPages exceeds 20 — capped at schema maximum
- Payment failure via x402 prevents request from being processed

## 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 matched listings and an array of items, each containing the product title, item ID, price (numeric and formatted string), list price string, listing type, and marketplace. Empty or failed runs are not billed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "enum": [
    "best_match",
    "ending_soonest",
    "newly_listed",
    "price_low",
    "price_high"
   ],
   "type": "string",
   "default": "best_match",
   "description": "How eBay orders search results."
  },
  "maxItems": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Stop after this many products across all searches. Zero means no total cap."
  },
  "maxPrice": {
   "type": "integer",
   "minimum": 0,
   "description": "Maximum listing price in the marketplace currency."
  },
  "minPrice": {
   "type": "integer",
   "minimum": 0,
   "description": "Minimum listing price in the marketplace currency."
  },
  "condition": {
   "type": "array",
   "items": {
    "enum": [
     "new",
     "open_box",
     "refurbished",
     "used",
     "for_parts"
    ],
    "type": "string",
    "enumTitles": [
     "New",
     "Open box",
     "Refurbished",
     "Used",
     "For parts"
    ]
   },
   "default": [],
   "description": "Only include selected conditions. Leave empty for all."
  },
  "listingType": {
   "enum": [
    "all",
    "auction",
    "buy_it_now"
   ],
   "type": "string",
   "default": "all",
   "description": "Include all listings or only auction or fixed-price results."
  },
  "marketplace": {
   "enum": [
    "US",
    "UK",
    "DE",
    "FR",
    "IT",
    "ES",
    "CA",
    "AU"
   ],
   "type": "string",
   "default": "US",
   "description": "Marketplace domain and currency context for the search."
  },
  "searchQueries": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Search terms to run separately. Enter at least one keyword."
  },
  "maxSearchPages": {
   "type": "integer",
   "default": 5,
   "maximum": 20,
   "minimum": 1,
   "description": "Maximum search pages per keyword, with up to 60 listings on each page."
  },
  "maxRequestRetries": {
   "type": "integer",
   "default": 5,
   "maximum": 10,
   "minimum": 2,
   "description": "Maximum browser attempts per search page when access fails."
  },
  "maxProductsPerSearch": {
   "type": "integer",
   "default": 100,
   "minimum": 1,
   "description": "Maximum results to save for each keyword."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "type": null,
    "price": null,
    "title": null,
    "itemId": null,
    "priceMax": null,
    "marketplace": null,
    "priceString": null,
    "listPriceString": null
   }
  ],
  "product": "ebay"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ebay-product-search-scraper-x402-f29061c0/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)