Skip to main content
POST
/
v1
/
browser
Create a remote browser session
curl --request POST \
  --url https://agent.tinyfish.ai/v1/browser \
  --header 'X-API-Key: <api-key>'
{
  "session_id": "tf-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "cdp_url": "wss://tetra-abc123.cluster.unikraft.cloud/cdp",
  "base_url": "https://tetra-abc123.cluster.unikraft.cloud"
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Get your key from the API Keys page.

Response

Browser session created successfully.

Browser session created successfully. Connect via CDP WebSocket at cdp_url.

​
session_id
string
required

Unique session identifier returned by the browser infrastructure

Example:

"tf-a1b2c3d4-e5f6-7890-abcd-ef1234567890"

​
cdp_url
string
required

CDP WebSocket URL for direct browser connection

Example:

"wss://tetra-abc123.cluster.unikraft.cloud/cdp"

​
base_url
string
required

HTTPS base URL for the browser session

Example:

"https://tetra-abc123.cluster.unikraft.cloud"