1. Sessions
ScrapingDuck API Docs
  • Actions
    • Returns example action objects for each available action.
      GET
  • Browser
    • Executes a list of browser actions.
      POST
    • Fetches the full HTML content of a web page.
      GET
    • Extracts the main article content from a web page.
      GET
  • Devices
    • Gets the list of all available device names.
      GET
    • Gets detailed information for a specific device.
      GET
  • Scrape
    • Fetches the raw HTML source of a web page as a direct text/html response.
      GET
    • Fetches the full scraping result including HTML content and metadata (JSON response).
      GET
    • Extracts the main article content from a web page.
      GET
    • Extracts the main article content as Markdown-friendly text.
      GET
    • Captures a screenshot of a web page as a binary image.
      GET
    • Submits a batch of URLs for asynchronous scraping. Returns 202 Accepted with a batch ID immediately. Results are delivered via webhook callback or polled via GET /v1/scrape/batch/{batchId}.
      POST
    • Polls the status of a previously submitted batch scrape job. Results are retrieved from the webapp's persistent storage.
      GET
  • Billing
    • Estimates the credit cost of a browser automation request without executing it.
      POST
    • Estimates the credit cost of a batch scrape without reserving credits.
      GET
  • Search
    • Performs a web search and returns unified results from SearXNG, TinyFish or Brave Search.
      GET
  • Sessions
    • Opens a new interactive browser session. Creating a session is free; each step is billed.
      POST
    • Lists the caller's active sessions.
      GET
    • Gets a session's metadata and current page snapshot.
      GET
    • Closes the caller's session. Idempotent: always returns 204.
      DELETE
    • Executes a single browser action in the caller's live session.
      POST
  • Schemas
    • ActionExecutionMeta
    • BrowserAction
    • BatchItemResult
    • BrowserActionResult
    • BatchScrapeRequest
    • BrowserActionResultActionExecutionResponse
    • BatchScrapeResponse
    • BrowserAutomationRequest
    • BatchWebhookMeta
    • DeviceContextOptionsDto
    • BatchWebhookPayload
    • BillingEstimateResponse
    • DeviceDetailDto
    • ProblemDetails
    • PublicBrowserAutomationRequest
    • ResultData
    • BrowserActionResultSessionStepResponse
    • ValidationProblemDetails
    • ViewSettings
    • SearchResponse
    • SearchResultItem
    • SessionOpenedResponse
    • SessionSummaryDto
    • TrafficSource
ScrapingDuck
  1. Sessions

Opens a new interactive browser session. Creating a session is free; each step is billed.

POST
https://api.scrapingduck.com/v1/sessions
Last modified:2026-10-04 11:19:25
The session keeps one live browser for up to MaxLifetime and is evicted after IdleTimeout
without activity. At most MaxPerKey sessions may be active per API key.

Request

Authorization
API Key
Add parameter in query
apiKey
Example:
apiKey: ********************
or
Query Params

Responses

🟢201
application/json
Created
Body

🟠400
🟠401
🟠404
🟠429
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.scrapingduck.com/v1/sessions?deviceName=&locale=&timezone=&disableResourceExclusion=&useAdvancedSpoofing=&disableJavaScript=&useResidentialProxy=&apiKey=%3Capi-key%3E'
Response Response Example
201 - Example 1
{
    "sessionId": "string",
    "statusUrl": "string",
    "expiresAtUtc": "2019-08-24T14:15:22.123Z",
    "maxPerKey": 0
}
Modified at 2026-10-04 11:19:25
Previous
Performs a web search and returns unified results from SearXNG, TinyFish or Brave Search.
Next
Lists the caller's active sessions.
Built with