Max Mode

Max Mode runs multiple result pages as an asynchronous server-side job. Use it for deeper research when a single page of up to 240 sold listings is not enough.

Start

curl -X POST "https://api.compsniper.com/v1/scrape/max" \
  -H "Authorization: Bearer cs_live_REPLACEWITHYOURKEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: max-mode-2026-08-31" \
  -d '{"keyword":"shure sm7b","maxPages":5,"count":240}'

The response contains a jobId.

Poll

GET /v1/scrape/max/results/:jobId

Poll about every five seconds. Terminal states are done, maxPages_reached, cancelled, and failed. Each successfully fetched result page consumes one account request.

Cancel

DELETE /v1/scrape/max/:jobId

Only one Max Mode or Card Batch job can run per account. A second submission returns 409 conflict with the active job details.

Export

Completed jobs provide a signed CSV URL:

GET /v1/scrape/max/:jobId/download.csv?token=SIGNED_TOKEN

Always provide maxPages, use an idempotency key for submission retries, and stop polling terminal jobs.