AdsCrawl documentation

Authenticate every account-level request

Send your complete API key in the x-api-key header. Keep the key on a trusted server or in a secret manager; never publish it in client-side code.

Cloud browser lifecycle requests also accept a session JWT or cookie. Viewer access requires the profile owner's session; an API key alone does not grant viewer access.

Base URL

Download OpenAPI (YAML)

The public API origin follows the website deployment environment, so local, development, pre-release, and production documentation point to their matching service.

Make your first request

Start with POST /html when you need rendered content. It is synchronous, uses safe browser defaults, and avoids managing a stateful session.

export ADSCRAWL_API_KEY="your-api-key"

curl --fail-with-body -sS -X POST "https://api.adscrawl.net/html" \
  -H "content-type: application/json" \
  -H "x-api-key: $ADSCRAWL_API_KEY" \
  -d '{
    "url": "https://example.com/article",
    "contentMode": "markdown",
    "waitUntil": "domcontentloaded"
  }'

Choose the smallest browser workflow