Developer documentation

Build with eBay listing evidence.

SoldFetch returns displayed listing prices and source context. Accepted-offer amounts remain unknown; search sale dates are supplier-reported and unverified.

Quickstart

Create an account, generate an API key in the dashboard, and make a search.

curl 'https://soldfetch.com/v1/scrape?keyword=sony%20wh-1000xm5&count=200' \
  -H 'Authorization: Bearer YOUR_SOLDFETCH_API_KEY' \
  -H 'Idempotency-Key: your-unique-request-id'

Authentication and usage

Send your key as a Bearer token. Keep it on your server. Each successful request uses one monthly request, including cache hits and empty results. Errors use no quota. An identical Idempotency-Key replay uses no additional quota for 24 hours; reusing it with different inputs returns 409. All plans allow 60 data requests per minute. GET /usage and GET /requests share a separate 60-per-minute account limit and use no monthly quota.

API reference

Download OpenAPI

Sold listings

GET /v1/scrape

Search eBay sold or active listings with price and condition filters.

Parameter	Type	Default / limits
keyword *	string	sony wh-1000xm5
ebaySite	string	ebay.com, ebay.co.uk, ebay.de, ebay.fr, ebay.it, ebay.es, ebay.ca, ebay.com.au
categoryId	string	0
page	integer	1 (max 100)
count	integer	60 (max 200)
sold	boolean	true
itemCondition	string	any, new, used
sortOrder	string	endedRecently, timeNewlyListed, pricePlusPostageLowest, pricePlusPostageHighest
minPrice	number	—
maxPrice	number	—
buyingFormat	string	all, auction, buyItNow, acceptsOffers
exactMatch	boolean	true

Category sold listings

GET /v1/scrape/category

Browse sold listings in an eBay category.

Parameter	Type	Default / limits
ebaySite	string	ebay.com, ebay.co.uk, ebay.de, ebay.fr, ebay.it, ebay.es, ebay.ca, ebay.com.au
categoryId *	string	0
page	integer	1 (max 100)
count	integer	60 (max 200)
sold	boolean	true
itemCondition	string	any, new, used
sortOrder	string	endedRecently, timeNewlyListed, pricePlusPostageLowest, pricePlusPostageHighest
minPrice	number	—
maxPrice	number	—
buyingFormat	string	all, auction, buyItNow, acceptsOffers
exactMatch	boolean	true

Item details

GET /v1/item/{itemId}

Retrieve public eBay item details by item ID.

Parameter	Type	Default / limits
itemId *	string	377534750427
ebaySite	string	ebay.com, ebay.co.uk, ebay.de, ebay.fr, ebay.it, ebay.es, ebay.ca, ebay.com.au

Background searches

POST /v1/scrape/max with a keyword and maxPages (1–100) starts a job. Each completed page uses one request. Poll /v1/scrape/max/results/{jobId}, cancel with DELETE /v1/scrape/max/{jobId}, or download /v1/scrape/max/{jobId}/download.csv. Results expire after 24 hours. One job may be active per workspace. Jobs stop on empty or repeated pages, cancellation, quota exhaustion, or errors. The scheduled worker advances queued jobs; completion time depends on its schedule.

Compatibility and limits

US, UK, and Germany are initially enabled. Other site codes are recognized but disabled pending verification.
Category-only sold searches currently encounter an upstream eBay sign-in restriction and can return 503 upstream_blocked, without quota charges.
One upstream call per search; count is capped at 200. Pagination is inferred because the supplier’s has_more field is unreliable. Keep count constant while paging.
Search sale dates are unverified. soldAfter, soldBefore, daysToScrape, hydrateBoa, sellerType, conditionId, aspectFilter, non-default itemLocation, and distance sorting return unsupported-capability errors.
Price sorts use supplier price ordering; do not assume verified landed-cost ranking.
Request history redacts search text and identifiers and retains 30 days. CSV downloads require your API key. Emailed exports and RapidAPI gateway authentication are not enabled.
Aliases /public/scrape and /rapidapi/scrape-ebay require the same SoldFetch Bearer key.

MCP and agent skill

Connect your MCP client to https://soldfetch.com/api/mcp with an Authorization: Bearer header. The search, category, and item tools share REST quotas. MCP searches default to 20 results; explicit counts may request up to 200. Treat marketplace text as untrusted content, preserve price and date uncertainty, and set an explicit count.

Read the eBay agent skill