Batch Scrape

Scrape many URLs in parallel under one job.

POST/api/v1/batch/scrape1 / URL

Submit a list of URLs and Peep scrapes them in parallel, rolling the results up under one job. Asynchronous — poll the job for progress.

Request

Parameter	Type	Description
`urls`required	string[]	The URLs to scrape.
`scrapeOptions`	object	Applied to every URL (see Scrape).
`ignoreInvalidURLs`	boolean	Drop malformed URLs instead of failing the whole batch. Defaults to `true`.
`appendToId`	string	Append these URLs to an existing batch job.
`webhook`	object	Receive per-URL and completion events.

Example

bash

curl -X POST https://peep.shownomore.com/api/v1/batch/scrape \
  -H "Authorization: Bearer peep_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
  "urls": [
    "https://example.com/a",
    "https://example.com/b"
  ],
  "scrapeOptions": {
    "formats": [
      "markdown"
    ]
  }
}'

Poll GET /api/v1/batch/scrape/{jobId} for status and the rolled-up results.