POST
/
sessions
/
webdriver
/
create
curl --request POST \
  --url https://api.flyingraccoon.tech/sessions/webdriver/create \
  --header 'Content-Type: application/json' \
  --header 'raccoon-secret-key: <api-key>' \
  --data '{
  "raccoon_passcode": "<end-user-raccoon-passcode>",
  "app_name": "uber",
  "url": "https://www.google.com",
  "browser_type": "chromium",
  "settings": {
    "locales": [
      "en-US",
      "fr-FR"
    ],
    "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36",
    "viewport": {
      "height": 1080,
      "width": 1920
    }
  },
  "advanced": {
    "block_ads": true,
    "proxy": true,
    "solve_captchas": true
  },
  "headless": true,
  "session_timeout": 600
}'
{
  "session_id": "session_12345",
  "connect_url": "https://connect.flyingraccoon.tech/6000?sessionId=session_12345",
  "status": "running"
}

This endpoint is not publicly available yet. If you would like the access, please mail us or use support center on the bottom right.

Use this endpoint to start a new webdriver session and connect via a remote connection using the connect_url field of the response.

Remote Webdriver Example
from selenium import webdriver
from selenium.webdriver.remote.remote_connection import RemoteConnection

options = webdriver.ChromeOptions()
remote_connection = RemoteConnection(connect_url)

remote_driver = webdriver.Remote(remote_connection, options=options)

The session gets terminated when you quit the driver using remote_driver.quit()

Authorizations

​
raccoon-secret-key
string
header
required

Body

application/json
​
raccoon_passcode
string | null

The raccoon passcode associated with the end user on behalf of which the call is being made if any.

Example:

"<end-user-raccoon-passcode>"

​
app_name
string | null

The name of the app for which the session is going to run for, used for streamlining authentication.

Example:

"uber"

​
url
string | null
default:https://www.google.com

The entrypoint url for the session.

Example:

"https://www.google.com"

​
browser_type
string | null
default:chromium

The type of browser to use. Supported values include 'chromium', 'firefox', and 'webkit'.

Example:

"chromium"

​
settings
object | null

Configuration settings for the browser, such as viewport size and User-Agent string.

Example:
{
  "locales": ["en-US", "fr-FR"],
  "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36",
  "viewport": { "height": 1080, "width": 1920 }
}
​
advanced
object | null

Advanced configuration options for the session, such as ad-blocking and CAPTCHA solving.

Example:
{
  "block_ads": true,
  "proxy": true,
  "solve_captchas": true
}
​
headless
boolean | null
default:false

Whether to run the browser in headless mode.

Example:

true

​
session_timeout
integer | null
default:300

The timeout for the browser session in seconds.

Example:

600

Response

200
application/json
Successful Response
​
session_id
string
required

A unique identifier for the created session.

Example:

"session_12345"

​
status
string
required

The current status of the session. Possible values include 'running', 'unknown', or 'terminated'.

Example:

"running"

​
connect_url
string

The Connect URL for interacting with the session.

Example:

"https://connect.flyingraccoon.tech/6000?sessionId=session_12345"

Was this page helpful?

Previous
Upload Extension
Next