# eBay Store Scraper API (x402)

> eBay Store Scraper API (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).

Scrapes structured product listings from eBay stores, categories, or search results and returns structured item data including price, condition, and details.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/ebay-store?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-store-scraper-api-x402-bc7c95c7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3UbP4dj83zeJqFgDPQH3g

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-store-scraper-api-x402-bc7c95c7 -d '<json body>'
```

Example prompt: Pull up to 30 listings from this eBay store — https://www.ebay.com/str/somestore — on ebay.com, including full item details like condition, shipping, and all images.

## When to prefer this

Use this endpoint when you need structured eBay product data — prices, conditions, titles — from a specific seller store or keyword search without building your own scraper. It is especially reliable for store URLs compared to search queries. The pay-per-successful-call model (failed or empty runs are free) makes it low-risk for exploratory queries. Prefer this over generic web scrapers when you need eBay-specific structured fields like condition, original price, and seller details.

## Known failure modes

- eBay challenges scraping bots on search pages, causing empty or partial results
- Store URLs or item pages may be geo-restricted for certain marketplaces
- Anti-bot challenges on item detail pages may fall back to listing card data only
- Invalid or private eBay store URLs return no items
- Rate limits or eBay blocks may result in empty runs (no charge applied)

## 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 found and an array of item objects, each containing the item ID, URL, title, price value, currency, condition, and original price (where available), along with the product identifier 'ebay-store'.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "maxItems": {
   "type": "integer",
   "default": 50,
   "minimum": 1,
   "description": "Maximum unique items across all start URLs and searches."
  },
  "maxPages": {
   "type": "integer",
   "default": 20,
   "minimum": 1,
   "description": "Maximum listing pages visited for each store, category, or search URL."
  },
  "startUrls": {
   "type": "array",
   "default": [],
   "description": "Public eBay item, seller store, store category, or search URLs. A store URL discovers its visible inventory."
  },
  "marketplace": {
   "enum": [
    "https://www.ebay.com",
    "https://www.ebay.co.uk",
    "https://www.ebay.de",
    "https://www.ebay.fr",
    "https://www.ebay.it",
    "https://www.ebay.es",
    "https://www.ebay.ca",
    "https://www.ebay.com.au"
   ],
   "type": "string",
   "default": "https://www.ebay.com",
   "description": "Marketplace used for keyword searches. Start URLs retain their own marketplace."
  },
  "searchQueries": {
   "type": "array",
   "default": [],
   "description": "Keywords to search on the selected marketplace. Search pages may be challenged; store URLs are more reliable."
  },
  "includeItemDetails": {
   "type": "boolean",
   "default": true,
   "description": "Visit each item page for item specifics, all images, seller feedback, shipping, returns, and availability. Listing cards remain available if a detail page is challenged."
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

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