Browser actions

Use sharedParams.actions to click, scroll, or wait before capture. Actions run in order, require a paid plan, and bypass the cache.

Load more content

Send this body to POST /web/scrape. See the Quickstart for authentication and SDK setup.

{
  "url": "https://example.com/products",
  "formats": {
    "markdown": true,
    "screenshot": true
  },
  "sharedParams": {
    "actions": [
      {
        "type": "perform",
        "action": "Click the Load more button"
      },
      {
        "type": "waitFor",
        "selector": ".product:nth-child(20)"
      }
    ]
  }
}

Action types

Type	Fields
`perform`	`action`: a natural-language instruction, 1–500 characters.
`scroll`	`direction`: `up` or `down`; `amount`: pixels, `viewport`, or `max`; optional `selector` and `maxScrolls`.
`wait`	`milliseconds`: 0–30,000.
`waitFor`	`selector`: CSS selector up to 2,048 characters.

Send 1–5 actions. A scroll defaults to down, one viewport, once. Pixel amounts range from 1 to 100,000 and maxScrolls from 1 to 50. A scroll-container selector can be up to 2,000 characters.

Scroll a lazy feed

{
  "url": "https://example.com/gallery",
  "formats": {
    "images": true
  },
  "sharedParams": {
    "actions": [
      {
        "type": "scroll",
        "direction": "down",
        "amount": "viewport",
        "maxScrolls": 3
      }
    ]
  }
}

For tabs or menus, use a precise perform instruction followed by waitFor for the resulting content. Request Parse fields to verify the expected element is present.

Failures and deadlines

A failed action marks affected outputs as failed; the request can still return HTTP 200. Fixed waits must fit within the request deadline, including its response reserve. A Free-plan request with actions returns 403 PAID_PLAN_REQUIRED. Use actions with Scrape. To visit several interactive pages, get their URLs through Map and scrape them individually.

Get started

Web data

Company and people data

Automation

Account and billing

Production

Load more content

Action types

Scroll a lazy feed

Failures and deadlines

​Load more content

​Action types

​Scroll a lazy feed

​Failures and deadlines

Load more content

Action types

Scroll a lazy feed

Failures and deadlines