BrowserElf eBay API

Stealth browser scraping for eBay product pages

Endpoints

GET / — This documentation page

GET /health — Service health check

GET /scrape?url=... — Scrape eBay product URL

POST /scrape — Scrape with full options (JSON body)

GET /logs — Recent request logs

GET /stats?domain=... — Rate limit stats

GET /profiles — Available scraping profiles

GET /profiles/:domain — Specific profile config

GET /cache/stats — Cache metrics

DELETE /cache?domain=... — Clear cache

Scrape Options

Field	Type	Default	Description
`url`	string	—	eBay product URL (required)
`stealth`	bool	true	Use stealth headers/user-agent
`screenshot`	bool	false	Return base64 screenshot
`extract`	array	all	Specific fields to extract
`format`	string	json	Response format: json, html, raw
`showHtml`	bool	false	Include raw HTML in JSON response
`noCache`	bool	false	Skip cache lookup
`noDelay`	bool	false	Skip human-like delay

Allowed Domains

Only these eBay domains are accepted:

ebay.com.au | www.ebay.com.au | ebay.com | www.ebay.com

Examples

GET request

curl "http://localhost:3001/scrape?url=https://www.ebay.com.au/itm/123456&noDelay=true"

POST request

curl -X POST http://localhost:3001/scrape \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.ebay.com.au/itm/123456",
    "extract": ["name", "price", "currency", "condition"],
    "noDelay": true
  }'

Sample Response

{
  "url": "https://www.ebay.com.au/itm/123456",
  "timestamp": "2026-02-15T12:00:00.000Z",
  "loadTimeMs": 4523,
  "cached": false,
  "product": {
    "name": "Example eBay Product",
    "price": 61.60,
    "currency": "AUD",
    "availability": "In Stock",
    "sku": "123456",
    "image": "https://i.ebayimg.com/...",
    "brand": "BrandName",
    "category": "Electronics > Components",
    "description": "Product description...",
    "sellerName": "seller_123",
    "condition": "New"
  }
}

Rate Limits: eBay domains are rate-limited to 5,000 requests/day and 100 requests per 10-minute burst window. Exceeding limits returns HTTP 429.