Skip to main content
Use crawl when you already know the exact URLs you want processed.

What crawl is good at

Crawl is a strong fit for:
  • controlled ingestion of a known page list
  • generating normalized result content
  • link discovery and page inspection
  • feeding retrieval or indexing pipelines

Request examples

Node.js and Python examples use the Bulkgrid SDKs. Set BULKGRID_API_KEY in your backend environment; cURL examples also use BULKGRID_BASE_URL=https://bulkgrid.com.

Important options

  • formats: choose outputs such as markdown, cleanHtml, rawHtml, and links
  • timeout: page timeout in milliseconds
  • waitAfterLoad: extra delay after page load
  • waitForSelector: wait for a selector before capture
  • screenshot: request screenshot capture
  • headers: send additional allowed request headers

Operational guidance

Ask only for the content formats you need. Wider output sets mean more downstream handling and more room for inconsistent assumptions in client code.

Workflow

  1. create the crawl run
  2. poll the run status
  3. list run results
  4. retrieve the result content your application needs