soldfetch-com Scrape API
The Scrape API from soldfetch-com — 6 operation(s) for scrape.
The Scrape API from soldfetch-com — 6 operation(s) for scrape.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/soldfetch-com:soldfetch-com-scrape-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: SoldFetch eBay Scrape API
version: 1.0.0
description: SoldComps-compatible core paths with documented limitations. Verified sale-date filters, accepted-offer hydration, and emailed exports are unavailable. All REST aliases require a SoldFetch API key.
servers:
- url: https://soldfetch.com
security:
- BearerAuth: []
tags:
- name: Scrape
paths:
/v1/scrape:
get:
operationId: search
summary: Sold listings
description: One upstream call per request. Up to 200 results. Unverified sale dates and displayed listing prices are explicitly marked. Successful responses consume one request; failed responses do not.
parameters:
- name: keyword
in: query
required: true
schema:
type: string
example: sony wh-1000xm5
- name: ebaySite
in: query
description: Regional eBay site; availability is listed in capabilities.
schema:
type: string
enum:
- ebay.com
- ebay.co.uk
- ebay.de
- ebay.fr
- ebay.it
- ebay.es
- ebay.ca
- ebay.com.au
default: ebay.com
- name: categoryId
in: query
required: false
schema:
type: string
default: '0'
- name: page
in: query
schema:
type: integer
minimum: 1
maximum: 100
default: 1
- name: count
in: query
schema:
type: integer
minimum: 1
maximum: 200
default: 60
- name: sold
in: query
schema:
type: boolean
default: true
- name: itemCondition
in: query
schema:
type: string
enum:
- any
- new
- used
default: any
- name: sortOrder
in: query
schema:
type: string
enum:
- endedRecently
- timeNewlyListed
- pricePlusPostageLowest
- pricePlusPostageHighest
default: endedRecently
- name: minPrice
in: query
schema:
type: number
minimum: 0
- name: maxPrice
in: query
schema:
type: number
minimum: 0
- name: buyingFormat
in: query
schema:
type: string
enum:
- all
- auction
- buyItNow
- acceptsOffers
default: all
- name: exactMatch
in: query
description: Exclude explicitly marked loose matches. Does not guarantee product identity.
schema:
type: boolean
default: true
responses:
'200':
description: Normalized eBay response
content:
application/json:
schema:
type: object
'400':
$ref: '#/components/responses/Error'
'401':
$ref: '#/components/responses/Error'
'403':
$ref: '#/components/responses/Error'
'409':
$ref: '#/components/responses/Error'
'429':
$ref: '#/components/responses/Error'
'502':
$ref: '#/components/responses/Error'
'503':
$ref: '#/components/responses/Error'
'504':
$ref: '#/components/responses/Error'
tags:
- Scrape
/v1/scrape/category:
get:
operationId: category
summary: Category sold listings
description: One upstream call per request. Up to 200 results. Unverified sale dates and displayed listing prices are explicitly marked. Successful responses consume one request; failed responses do not.
parameters:
- name: ebaySite
in: query
description: Regional eBay site; availability is listed in capabilities.
schema:
type: string
enum:
- ebay.com
- ebay.co.uk
- ebay.de
- ebay.fr
- ebay.it
- ebay.es
- ebay.ca
- ebay.com.au
default: ebay.com
- name: categoryId
in: query
required: true
schema:
type: string
default: '0'
- name: page
in: query
schema:
type: integer
minimum: 1
maximum: 100
default: 1
- name: count
in: query
schema:
type: integer
minimum: 1
maximum: 200
default: 60
- name: sold
in: query
schema:
type: boolean
default: true
- name: itemCondition
in: query
schema:
type: string
enum:
- any
- new
- used
default: any
- name: sortOrder
in: query
schema:
type: string
enum:
- endedRecently
- timeNewlyListed
- pricePlusPostageLowest
- pricePlusPostageHighest
default: endedRecently
- name: minPrice
in: query
schema:
type: number
minimum: 0
- name: maxPrice
in: query
schema:
type: number
minimum: 0
- name: buyingFormat
in: query
schema:
type: string
enum:
- all
- auction
- buyItNow
- acceptsOffers
default: all
- name: exactMatch
in: query
description: Exclude explicitly marked loose matches. Does not guarantee product identity.
schema:
type: boolean
default: true
responses:
'200':
description: Normalized eBay response
content:
application/json:
schema:
type: object
'400':
$ref: '#/components/responses/Error'
'401':
$ref: '#/components/responses/Error'
'403':
$ref: '#/components/responses/Error'
'409':
$ref: '#/components/responses/Error'
'429':
$ref: '#/components/responses/Error'
'502':
$ref: '#/components/responses/Error'
'503':
$ref: '#/components/responses/Error'
'504':
$ref: '#/components/responses/Error'
tags:
- Scrape
/v1/scrape/max:
post:
summary: Start a bounded search job; one charged request per successful page
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- keyword
properties:
keyword:
type: string
ebaySite:
type: string
default: ebay.com
maxPages:
type: integer
minimum: 1
maximum: 100
default: 50
count:
type: integer
maximum: 200
default: 200
resultType:
type: string
enum:
- inline
- download
responses:
'200':
description: Normalized eBay response
content:
application/json:
schema:
type: object
'202':
description: Queued job with jobId and resultsUrl
'400':
$ref: '#/components/responses/Error'
'401':
$ref: '#/components/responses/Error'
'403':
$ref: '#/components/responses/Error'
'409':
$ref: '#/components/responses/Error'
'429':
$ref: '#/components/responses/Error'
'502':
$ref: '#/components/responses/Error'
'503':
$ref: '#/components/responses/Error'
'504':
$ref: '#/components/responses/Error'
tags:
- Scrape
operationId: postV1ScrapeMax
x-operation-id-source: derived
/v1/scrape/max/results/{jobId}:
get:
summary: Read owned job status and partial results
parameters:
- name: jobId
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Normalized eBay response
content:
application/json:
schema:
type: object
'400':
$ref: '#/components/responses/Error'
'401':
$ref: '#/components/responses/Error'
'403':
$ref: '#/components/responses/Error'
'409':
$ref: '#/components/responses/Error'
'429':
$ref: '#/components/responses/Error'
'502':
$ref: '#/components/responses/Error'
'503':
$ref: '#/components/responses/Error'
'504':
$ref: '#/components/responses/Error'
tags:
- Scrape
operationId: getV1ScrapeMaxResultsByJobId
x-operation-id-source: derived
/v1/scrape/max/{jobId}:
delete:
summary: Cancel an owned job; an in-flight page may finish
parameters:
- name: jobId
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Normalized eBay response
content:
application/json:
schema:
type: object
'400':
$ref: '#/components/responses/Error'
'401':
$ref: '#/components/responses/Error'
'403':
$ref: '#/components/responses/Error'
'409':
$ref: '#/components/responses/Error'
'429':
$ref: '#/components/responses/Error'
'502':
$ref: '#/components/responses/Error'
'503':
$ref: '#/components/responses/Error'
'504':
$ref: '#/components/responses/Error'
tags:
- Scrape
operationId: deleteV1ScrapeMaxByJobId
x-operation-id-source: derived
/v1/scrape/max/{jobId}/download.csv:
get:
summary: Download owned job as CSV using Bearer authentication
parameters:
- name: jobId
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: CSV
content:
text/csv:
schema:
type: string
tags:
- Scrape
operationId: getV1ScrapeMaxByJobIdDownloadCsv
x-operation-id-source: derived
components:
responses:
Error:
description: Structured error. Workspace rate or concurrency limits return 429. Shared upstream capacity returns 503 with code upstream_rate_limited and Retry-After; failures consume zero units.
headers:
Retry-After:
description: Seconds to wait before retrying a throttled request
schema:
type: integer
minimum: 1
content:
application/json:
schema:
type: object
required:
- error
- code
- requestId
properties:
error:
type: string
code:
type: string
requestId:
type: string
retryAfter:
type: integer
minimum: 1
securitySchemes:
BearerAuth:
type: http
scheme: bearer