> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bringits.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HTTP Request - Got Scraping

> Execute a single HTTP request using the got-scraping library with scraping capabilities and TLS settings

The HTTP Request - Got Scraping command (Command Type: 100) executes a single HTTP request using the [got-scraping](https://github.com/apify/got-scraping) library. Designed for web scraping with advanced proxy support, header generation, and TLS configuration.

## Command Type

**Command Type ID:** 100

## Parameters

| Parameter                  | Type            | Description                                                    | Required |
| -------------------------- | --------------- | -------------------------------------------------------------- | -------- |
| **url**                    | string          | The target URL                                                 | Yes      |
| **verb**                   | string          | HTTP method: `"GET"`, `"POST"`, `"PUT"`, `"DELETE"`, `"PATCH"` | Yes      |
| **contentType**            | string          | Payload type: `"JSON"` or `"form-data"`                        | Yes      |
| **timeout**                | number          | Timeout in milliseconds                                        | Yes      |
| **body**                   | object          | Request body for POST/PUT                                      | No       |
| **bypassStatusCode**       | Array of number | Status codes to bypass default error handling                  | No       |
| **headers**                | object          | HTTP headers                                                   | No       |
| **headersOptions**         | HeadersOptions  | Custom header generation settings                              | No       |
| **isHttp2**                | boolean         | Enable HTTP/2                                                  | No       |
| **proxy**                  | ProxySettings   | Proxy settings                                                 | No       |
| **proxyConnectionTimeout** | number          | Timeout for proxy connection in milliseconds                   | No       |
| **tlsSettings**            | TlsSettings     | TLS configuration                                              | No       |
| **useHeaderGenerator**     | boolean         | Enable automatic browser-like header generation                | No       |

### HeadersOptions

| Field                | Type                    | Description                                  | Required |
| -------------------- | ----------------------- | -------------------------------------------- | -------- |
| **browsers**         | Array of BrowserOptions | Browser configurations for header generation | Yes      |
| **devices**          | Array of string         | Device types (e.g., `"mobile"`, `"desktop"`) | Yes      |
| **operatingSystems** | Array of string         | OS list (e.g., `"Windows"`, `"macOS"`)       | Yes      |

### TlsSettings

| Field              | Type    | Description                             | Required |
| ------------------ | ------- | --------------------------------------- | -------- |
| **ciphers**        | string  | Comma-separated cipher suites           | Yes      |
| **minVersion**     | string  | Minimum TLS version (e.g., `"TLSv1.2"`) | Yes      |
| **maxVersion**     | string  | Maximum TLS version (e.g., `"TLSv1.3"`) | Yes      |
| **shuffleCiphers** | boolean | Shuffle cipher list to vary fingerprint | Yes      |

## Usage Examples

### Request with Header Generator

```json theme={null}
{
  "command": "http-request-got-scraping",
  "params": {
    "url": "https://target.example.com/data",
    "verb": "GET",
    "contentType": "JSON",
    "timeout": 15000,
    "useHeaderGenerator": true,
    "headersOptions": {
      "browsers": [{ "name": "chrome" }],
      "devices": ["desktop"],
      "operatingSystems": ["Windows"]
    }
  }
}
```

### Request with Custom TLS Settings

```json theme={null}
{
  "command": "http-request-got-scraping",
  "params": {
    "url": "https://secure.example.com/api",
    "verb": "POST",
    "contentType": "JSON",
    "timeout": 20000,
    "body": { "query": "data" },
    "tlsSettings": {
      "ciphers": "TLS_AES_128_GCM_SHA256,TLS_AES_256_GCM_SHA384",
      "minVersion": "TLSv1.2",
      "maxVersion": "TLSv1.3",
      "shuffleCiphers": true
    }
  }
}
```

## Related Commands

* [HTTP Request](/stream/commands/http/http-request) - Basic cloudscraper request
* [HTTP Request - Got](/stream/commands/http/http-request-got) - Standard Got request