Skip to main content
The HTTP Request - Got Scraping command (Command Type: 100) executes a single HTTP request using the got-scraping library. Designed for web scraping with advanced proxy support, header generation, and TLS configuration.

Command Type

Command Type ID: 100

Parameters

ParameterTypeDescriptionRequired
urlstringThe target URLYes
verbstringHTTP method: "GET", "POST", "PUT", "DELETE", "PATCH"Yes
contentTypestringPayload type: "JSON" or "form-data"Yes
timeoutnumberTimeout in millisecondsYes
bodyobjectRequest body for POST/PUTNo
bypassStatusCodeArray of numberStatus codes to bypass default error handlingNo
headersobjectHTTP headersNo
headersOptionsHeadersOptionsCustom header generation settingsNo
isHttp2booleanEnable HTTP/2No
proxyProxySettingsProxy settingsNo
proxyConnectionTimeoutnumberTimeout for proxy connection in millisecondsNo
tlsSettingsTlsSettingsTLS configurationNo
useHeaderGeneratorbooleanEnable automatic browser-like header generationNo

HeadersOptions

FieldTypeDescriptionRequired
browsersArray of BrowserOptionsBrowser configurations for header generationYes
devicesArray of stringDevice types (e.g., "mobile", "desktop")Yes
operatingSystemsArray of stringOS list (e.g., "Windows", "macOS")Yes

TlsSettings

FieldTypeDescriptionRequired
ciphersstringComma-separated cipher suitesYes
minVersionstringMinimum TLS version (e.g., "TLSv1.2")Yes
maxVersionstringMaximum TLS version (e.g., "TLSv1.3")Yes
shuffleCiphersbooleanShuffle cipher list to vary fingerprintYes

Usage Examples

Request with Header Generator

{
  "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

{
  "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
    }
  }
}