Make an HTTP request through the browser's network stack

Sends an HTTP request through Chrome’s HTTP request stack, inheriting the browser’s TLS fingerprint, cookies, proxy configuration, and headers. Returns a structured JSON response with status, headers, body, and timing.

POST /browsers/{id}/curl

JavaScript

JavaScript

import Kernel from '@onkernel/sdk';

const client = new Kernel({
  apiKey: process.env['KERNEL_API_KEY'], // This is the default and can be omitted
});

const response = await client.browsers.curl('id', { url: 'url' });

console.log(response.body);

200

{
  "status": 123,
  "headers": {},
  "body": "<string>",
  "duration_ms": 123
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id · string · required

Browser session ID

Body

application/json

Request to make an HTTP request through the browser's network stack.

url · string · required

Target URL (must be http or https).

method · enum<string> · default: GET

HTTP method.

Available options: GET, HEAD, POST, PUT, PATCH, DELETE, OPTIONS

headers · object

Custom headers merged with browser defaults.

Show child attributes

body · string

Request body (for POST/PUT/PATCH).

timeout_ms · integer · default: 30000

Request timeout in milliseconds.

Required range: 1000 <= x <= 60000

response_encoding · enum<string> · default: utf8

Encoding for the response body. Use base64 for binary content.

Available options: utf8, base64

Response

200

application/json

Response from target URL

Structured response from the browser curl request.

status · integer · required

HTTP status code from target.

headers · object · required

Response headers (multi-value).

Show child attributes

body · string · required

Response body (UTF-8 string or base64 depending on request).

duration_ms · integer · required

Total request duration in milliseconds.