Skip to main content

Prerequisites

  • An API key from the dashboard (starts with spy_).
  • A prepaid credit balance — see Credits.
Authentication is a single header on every request:

Your first scrape

Send a POST /scrape request with a target URL. This example also extracts the book titles on the page using a CSS selector.

The response

You get structured JSON back. elapsed_ms is the billing basis; success and blocked tell you whether the scrape is reliable.
Need a page that renders with JavaScript? Set "engine": "js" to run it in a real headless browser. It costs more credits — see Pricing.

Next steps

POST /scrape reference

Every parameter and response field.

Errors

Status codes and how to handle them.