# Request Options

### Request Options

{% hint style="info" %}
**All** of the available **options** already **have reasonable defaults** to make the use of skrape{it} as easy and intuitive as possible.
{% endhint %}

| Option                      | Description                                                                                                                                                                                                                                                                                                   |           Type           | Default                                              |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------: | ---------------------------------------------------- |
| **url**                     | The URL that is used to fetch and parse a web page. The protocol must be `http` or `https`                                                                                                                                                                                                                    |        **String**        | `http://localhost:8080`                              |
| **method**                  | HTTP defines a set of [**request methods**](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods) to indicate the desired action to be performed for a given resource. Although they can also be nouns, these request methods are sometimes referred as *HTTP verbs*.                                    |        **Method**        | `GET`                                                |
| **userAgent**               | The [**User-Agent**](https://developer.mozilla.org/de/docs/Web/HTTP/Headers/User-Agent) request header contains a characteristic string that allows the network protocol peers to identify the application type, operating system, software vendor or software version of the requesting software user agent. |        **String**        | `Mozilla/5.0 skrape.it`                              |
| **headers**                 | [**Request headers** ](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers)containing more information about the resource to be fetched or about the client itself.                                                                                                                                     | **Map\<String, String>** | no additional custom headers will be sent by default |
| **cookies**                 | Will add Cookies to your request                                                                                                                                                                                                                                                                              | **Map\<String, String>** | will send no Cookies by default                      |
| **timeout**                 | Sets the total request timeout duration. A timeout of zero (`0`) is treated as an infinite timeout.                                                                                                                                                                                                           |          **Int**         | `5000`                                               |
| **followRedirects**         | Configures the connection to (not) follow server redirects.                                                                                                                                                                                                                                                   |        **Boolean**       | `true`                                               |
| **ignoreContentType**       | Ignore the document's Content-Type when parsing the response. If set to false, an unrecognized content-type will cause an IOException to be thrown. (This is to prevent producing garbage by attempting to parse a JPEG binary image, for example.)                                                           |        **Boolean**       | `true`                                               |
| **ignoreHttpErrors**        | Configures the connection to not throw exceptions when a HTTP error occurs. (4xx - 5xx, e.g. 404 or 500). An IOException is thrown if an error is encountered. If set to `true` the response is populated with the error body, and the status message will reflect the error.                                 |        **Boolean**       | `true`                                               |
| **validateTLSCertificates** | <p>Disable/enable TLS certificates validation for HTTPS requests. </p><p>All connections over HTTPS perform normal validation of certificates, and will abort requests if the provided certificate does not validate.</p>                                                                                     |        **Boolean**       | `true`                                               |
| **maxBodySize**             | Set the maximum bytes to read from the (uncompressed) connection into the body, before the connection is closed, and the input truncated.                                                                                                                                                                     |          **Int**         | no maximum body size                                 |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.skrape.it/docs/1.0.x/http-client/parse-html-from-web.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
