---
title: "Start a bounded search job; one charged request per successful page"
method: POST
path: "/v1/scrape/max"
---

# Start a bounded search job; one charged request per successful page

`POST /v1/scrape/max`

## Request

- Base URL: `https://soldfetch.com`
- URL: `https://soldfetch.com/v1/scrape/max`
- Auth: HTTP bearer

## Request body

- object
  - `keyword` string, required
  - `ebaySite` string
  - `maxPages` integer
  - `count` integer
  - `resultType` 'inline' | 'download'

## Response `200`

Normalized eBay response

- object

## Other responses

- `202`: Queued job with jobId and resultsUrl
- `400`: 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.
- `401`: 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.
- `403`: 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.
- `409`: 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.
- `429`: 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.
- `502`: 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.
- `503`: 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.
- `504`: 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.

---

[API](https://skmtc.dev/soldfetch/apis/soldfetch-ebay-api.md) · [All operations](https://skmtc.dev/soldfetch/apis/soldfetch-ebay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/soldfetch/apis/soldfetch-ebay-api/revisions/2012c31d23a5?raw)