Executes a list of browser actions.

This endpoint allows for the execution of a sequence of actions in a specified browser environment.

Default Behavior:

A realistic, rotating browser fingerprint will be used.

The browser's locale and timezone will be matched to the proxy's IP address geolocation.

Overrides:

Providing a deviceName uses that specific device profile.

Providing a locale or timezone will disable the automatic matching based on the proxy.

Invariants:

The actions list must contain at least 1 and no more than 50 items.

Actions are executed sequentially.

Any URL provided in an action must be an absolute URL using the http or https scheme.

Example Request:

{
  "actions": [
    { "type": "VisitUrlAction", "url": "https://example.com" },
    { "type": "GetHtmlAction" }
  ]
}

Possible error codes:

400 (validation_error): The request body is invalid. This can happen if the actions array is missing, empty, or if the JSON is malformed.

400 (too_many_actions): The number of actions in the actions array exceeds the server limit of 50.

401 (unauthorized): The API key is missing or invalid.

404 (device_not_found): The specified deviceName does not exist. A list of available devices can be retrieved from the /devices endpoint.

400 (unsupported_action): The type of an action in the actions array is not a recognized action.

400 (invalid_url_scheme): An action contains a URL that is not a valid HTTP or HTTPS URL.

500 (unhandled_error): An unexpected server-side error occurred during the execution of the request.

curl --location --request POST 'https://api.scrapingduck.com/v1/browser/actions/execute?deviceName&locale&timezone&disableResourceExclusion&useAdvancedSpoofing&disableJavaScript&apiKey=<api-key>' \ --header 'Content-Type: application/json' \ --data-raw '{ "actions": [ { "type": "VisitUrlAction", "url": "https://news.ycombinator.com" }, { "type": "VisitRandomLinkAction", "viewTime": 5, "stayOnDomain": true, "goBack": true }, { "type": "GetHtmlAction" } ] }'

{ "executionId": "myApiKey_a1b2c3d4", "results": [ { "type": "VisitUrlActionResult", "success": true, "data": { "status": 200 } }, { "type": "GetHtmlActionResult", "success": true, "data": { "html": "<!doctype html><html>...</html>" } } ], "meta": { "actionsRequested": 2, "actionsSucceeded": 2, "startedAtUtc": "2025-01-01T12:00:00Z", "finishedAtUtc": "2025-01-01T12:00:02Z", "durationMs": 2000, "responseSizeBytes": 1234, "maxActionsAllowed": 50 } }

Request

Responses