Connect to a browser session
curl --request GET \
--url https://api.floppydata.net/v2/browser/sessions/{sessionId}/connectimport requests
url = "https://api.floppydata.net/v2/browser/sessions/{sessionId}/connect"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.floppydata.net/v2/browser/sessions/{sessionId}/connect', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters.",
"details": {
"issues": [
{
"path": "country",
"code": "invalid_format",
"message": "Expected a 2-letter country code."
}
]
}
}
}{
"error": {
"code": "unauthorized",
"message": "Unauthorized",
"details": {}
}
}{
"error": {
"code": "insufficient_balance",
"message": "Insufficient proxy traffic balance.",
"details": {}
}
}{
"error": {
"code": "forbidden",
"message": "Forbidden",
"details": {}
}
}{
"error": {
"code": "not_found",
"message": "Rotating proxy credential was not found.",
"details": {}
}
}{
"error": {
"code": "account_not_configured",
"message": "Account is not configured for proxy products.",
"details": {}
}
}{
"error": {
"code": "internal_error",
"message": "Internal Server Error",
"details": {}
}
}{
"error": {
"code": "upstream_error",
"message": "Failed to fetch data from an upstream service.",
"details": {
"upstreamStatus": 503
}
}
}Cloud Browser
Connect to a Session
WebSocket relay used by the connectUrl returned from create/get session. It accepts one active relay connection per session.
GET
https://api.floppydata.net
/
v2
/
browser
/
sessions
/
{sessionId}
/
connect
Connect to a browser session
curl --request GET \
--url https://api.floppydata.net/v2/browser/sessions/{sessionId}/connectimport requests
url = "https://api.floppydata.net/v2/browser/sessions/{sessionId}/connect"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.floppydata.net/v2/browser/sessions/{sessionId}/connect', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters.",
"details": {
"issues": [
{
"path": "country",
"code": "invalid_format",
"message": "Expected a 2-letter country code."
}
]
}
}
}{
"error": {
"code": "unauthorized",
"message": "Unauthorized",
"details": {}
}
}{
"error": {
"code": "insufficient_balance",
"message": "Insufficient proxy traffic balance.",
"details": {}
}
}{
"error": {
"code": "forbidden",
"message": "Forbidden",
"details": {}
}
}{
"error": {
"code": "not_found",
"message": "Rotating proxy credential was not found.",
"details": {}
}
}{
"error": {
"code": "account_not_configured",
"message": "Account is not configured for proxy products.",
"details": {}
}
}{
"error": {
"code": "internal_error",
"message": "Internal Server Error",
"details": {}
}
}{
"error": {
"code": "upstream_error",
"message": "Failed to fetch data from an upstream service.",
"details": {
"upstreamStatus": 503
}
}
}Do not construct this URL or call it with
X-Api-Key. Pass the signed connectUrl returned by create/get session directly to Playwright or Puppeteer. It expires with the session, authorizes one active relay, and should not be logged or shared. The HTTP playground cannot establish this WebSocket upgrade.Path Parameters
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Response
Browser CDP WebSocket relay.
Was this page helpful?
⌘I