# eBay Search Scraper

> eBay Search Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-02).

Scrapes eBay search results and item listings across regional marketplaces, returning structured product data including price, title, and item ID

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/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-a4886fc3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tI2Eh2p5uMTrJe3BY4kok

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-a4886fc3 -d '<json body>'
```

Example prompt: Search eBay for sold listings of a mechanical keyboard under $150 in used condition, sorted by newest, and give me the first 50 results from ebay.com.

## When to prefer this

Use this endpoint when you need structured eBay listing data — prices, titles, item IDs — for keyword searches or specific seller inventories across regional eBay marketplaces. It supports filtering by condition, listing type, price range, and sort order, and can retrieve both active and sold listings. Prefer this over general web scrapers when you specifically need eBay product data in a clean JSON format with per-item pricing details.

## Known failure modes

- Empty results if search query matches no listings — not charged
- Invalid category ID returns an error or empty result
- Unsupported marketplace enum value causes validation error
- Rate limiting or eBay bot detection may cause empty runs — not charged
- Invalid start URL format causes extraction failure

## 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 items and an array of listing objects, each containing the item title, URL, item ID, price (as a formatted string), price value (numeric), currency, and original price if discounted. Failed or empty runs are not billed.

## 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-a4886fc3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)