# Content

## Get HTML content.

`client.BrowserRendering.Content.New(ctx, params) (*string, error)`

**post** `/accounts/{account_id}/browser-rendering/content`

Fetches rendered HTML content from provided URL or HTML. Check available options like `gotoOptions` and `waitFor*` to control page load behaviour.

### Parameters

- `params ContentNewParams`

  - `AccountID param.Field[string]`

    Path param: Account ID.

  - `URL param.Field[string]`

    Body param: URL to navigate to, eg. `https://example.com`.

  - `CacheTTL param.Field[float64]`

    Query param: Cache TTL default is 5s. Set to 0 to disable.

  - `ActionTimeout param.Field[float64]`

    Body param: The maximum duration allowed for the browser action to complete after the page has loaded (such as taking screenshots, extracting content, or generating PDFs). If this time limit is exceeded, the action stops and returns a timeout error.

  - `AddScriptTag param.Field[[]ContentNewParamsVariant0AddScriptTag]`

    Body param: Adds a `<script>` tag into the page with the desired URL or content.

    - `ID string`

    - `Content string`

    - `Type string`

    - `URL string`

  - `AddStyleTag param.Field[[]ContentNewParamsVariant0AddStyleTag]`

    Body param: Adds a `<link rel="stylesheet">` tag into the page with the desired URL or a `<style type="text/css">` tag with the content.

    - `Content string`

    - `URL string`

  - `AllowRequestPattern param.Field[[]string]`

    Body param: Only allow requests that match the provided regex patterns, eg. '/^.*.(css)'.

  - `AllowResourceTypes param.Field[[]ContentNewParamsVariant0AllowResourceType]`

    Body param: Only allow requests that match the provided resource types, eg. 'image' or 'script'.

    - `const ContentNewParamsVariant0AllowResourceTypeDocument ContentNewParamsVariant0AllowResourceType = "document"`

    - `const ContentNewParamsVariant0AllowResourceTypeStylesheet ContentNewParamsVariant0AllowResourceType = "stylesheet"`

    - `const ContentNewParamsVariant0AllowResourceTypeImage ContentNewParamsVariant0AllowResourceType = "image"`

    - `const ContentNewParamsVariant0AllowResourceTypeMedia ContentNewParamsVariant0AllowResourceType = "media"`

    - `const ContentNewParamsVariant0AllowResourceTypeFont ContentNewParamsVariant0AllowResourceType = "font"`

    - `const ContentNewParamsVariant0AllowResourceTypeScript ContentNewParamsVariant0AllowResourceType = "script"`

    - `const ContentNewParamsVariant0AllowResourceTypeTexttrack ContentNewParamsVariant0AllowResourceType = "texttrack"`

    - `const ContentNewParamsVariant0AllowResourceTypeXHR ContentNewParamsVariant0AllowResourceType = "xhr"`

    - `const ContentNewParamsVariant0AllowResourceTypeFetch ContentNewParamsVariant0AllowResourceType = "fetch"`

    - `const ContentNewParamsVariant0AllowResourceTypePrefetch ContentNewParamsVariant0AllowResourceType = "prefetch"`

    - `const ContentNewParamsVariant0AllowResourceTypeEventsource ContentNewParamsVariant0AllowResourceType = "eventsource"`

    - `const ContentNewParamsVariant0AllowResourceTypeWebsocket ContentNewParamsVariant0AllowResourceType = "websocket"`

    - `const ContentNewParamsVariant0AllowResourceTypeManifest ContentNewParamsVariant0AllowResourceType = "manifest"`

    - `const ContentNewParamsVariant0AllowResourceTypeSignedexchange ContentNewParamsVariant0AllowResourceType = "signedexchange"`

    - `const ContentNewParamsVariant0AllowResourceTypePing ContentNewParamsVariant0AllowResourceType = "ping"`

    - `const ContentNewParamsVariant0AllowResourceTypeCspviolationreport ContentNewParamsVariant0AllowResourceType = "cspviolationreport"`

    - `const ContentNewParamsVariant0AllowResourceTypePreflight ContentNewParamsVariant0AllowResourceType = "preflight"`

    - `const ContentNewParamsVariant0AllowResourceTypeOther ContentNewParamsVariant0AllowResourceType = "other"`

  - `Authenticate param.Field[ContentNewParamsVariant0Authenticate]`

    Body param: Provide credentials for HTTP authentication.

    - `Password string`

    - `Username string`

  - `BestAttempt param.Field[bool]`

    Body param: Attempt to proceed when 'awaited' events fail or timeout.

  - `Cookies param.Field[[]ContentNewParamsVariant0Cookie]`

    Body param: Check [options](https://pptr.dev/api/puppeteer.page.setcookie).

    - `Name string`

      Cookie name.

    - `Value string`

    - `Domain string`

    - `Expires float64`

    - `HTTPOnly bool`

    - `PartitionKey string`

    - `Path string`

    - `Priority ContentNewParamsVariant0CookiesPriority`

      - `const ContentNewParamsVariant0CookiesPriorityLow ContentNewParamsVariant0CookiesPriority = "Low"`

      - `const ContentNewParamsVariant0CookiesPriorityMedium ContentNewParamsVariant0CookiesPriority = "Medium"`

      - `const ContentNewParamsVariant0CookiesPriorityHigh ContentNewParamsVariant0CookiesPriority = "High"`

    - `SameParty bool`

    - `SameSite ContentNewParamsVariant0CookiesSameSite`

      - `const ContentNewParamsVariant0CookiesSameSiteStrict ContentNewParamsVariant0CookiesSameSite = "Strict"`

      - `const ContentNewParamsVariant0CookiesSameSiteLax ContentNewParamsVariant0CookiesSameSite = "Lax"`

      - `const ContentNewParamsVariant0CookiesSameSiteNone ContentNewParamsVariant0CookiesSameSite = "None"`

    - `Secure bool`

    - `SourcePort float64`

    - `SourceScheme ContentNewParamsVariant0CookiesSourceScheme`

      - `const ContentNewParamsVariant0CookiesSourceSchemeUnset ContentNewParamsVariant0CookiesSourceScheme = "Unset"`

      - `const ContentNewParamsVariant0CookiesSourceSchemeNonSecure ContentNewParamsVariant0CookiesSourceScheme = "NonSecure"`

      - `const ContentNewParamsVariant0CookiesSourceSchemeSecure ContentNewParamsVariant0CookiesSourceScheme = "Secure"`

    - `URL string`

  - `EmulateMediaType param.Field[string]`

    Body param

  - `GotoOptions param.Field[ContentNewParamsVariant0GotoOptions]`

    Body param: Check [options](https://pptr.dev/api/puppeteer.gotooptions).

    - `Referer string`

    - `ReferrerPolicy string`

    - `Timeout float64`

    - `WaitUntil ContentNewParamsVariant0GotoOptionsWaitUntilUnion`

      - `ContentNewParamsVariant0GotoOptionsWaitUntilString`

        - `const ContentNewParamsVariant0GotoOptionsWaitUntilStringLoad ContentNewParamsVariant0GotoOptionsWaitUntilString = "load"`

        - `const ContentNewParamsVariant0GotoOptionsWaitUntilStringDomcontentloaded ContentNewParamsVariant0GotoOptionsWaitUntilString = "domcontentloaded"`

        - `const ContentNewParamsVariant0GotoOptionsWaitUntilStringNetworkidle0 ContentNewParamsVariant0GotoOptionsWaitUntilString = "networkidle0"`

        - `const ContentNewParamsVariant0GotoOptionsWaitUntilStringNetworkidle2 ContentNewParamsVariant0GotoOptionsWaitUntilString = "networkidle2"`

      - `ContentNewParamsVariant0GotoOptionsWaitUntilArray`

        - `const ContentNewParamsVariant0GotoOptionsWaitUntilArrayLoad ContentNewParamsVariant0GotoOptionsWaitUntilArray = "load"`

        - `const ContentNewParamsVariant0GotoOptionsWaitUntilArrayDomcontentloaded ContentNewParamsVariant0GotoOptionsWaitUntilArray = "domcontentloaded"`

        - `const ContentNewParamsVariant0GotoOptionsWaitUntilArrayNetworkidle0 ContentNewParamsVariant0GotoOptionsWaitUntilArray = "networkidle0"`

        - `const ContentNewParamsVariant0GotoOptionsWaitUntilArrayNetworkidle2 ContentNewParamsVariant0GotoOptionsWaitUntilArray = "networkidle2"`

  - `RejectRequestPattern param.Field[[]string]`

    Body param: Block undesired requests that match the provided regex patterns, eg. '/^.*.(css)'.

  - `RejectResourceTypes param.Field[[]ContentNewParamsVariant0RejectResourceType]`

    Body param: Block undesired requests that match the provided resource types, eg. 'image' or 'script'.

    - `const ContentNewParamsVariant0RejectResourceTypeDocument ContentNewParamsVariant0RejectResourceType = "document"`

    - `const ContentNewParamsVariant0RejectResourceTypeStylesheet ContentNewParamsVariant0RejectResourceType = "stylesheet"`

    - `const ContentNewParamsVariant0RejectResourceTypeImage ContentNewParamsVariant0RejectResourceType = "image"`

    - `const ContentNewParamsVariant0RejectResourceTypeMedia ContentNewParamsVariant0RejectResourceType = "media"`

    - `const ContentNewParamsVariant0RejectResourceTypeFont ContentNewParamsVariant0RejectResourceType = "font"`

    - `const ContentNewParamsVariant0RejectResourceTypeScript ContentNewParamsVariant0RejectResourceType = "script"`

    - `const ContentNewParamsVariant0RejectResourceTypeTexttrack ContentNewParamsVariant0RejectResourceType = "texttrack"`

    - `const ContentNewParamsVariant0RejectResourceTypeXHR ContentNewParamsVariant0RejectResourceType = "xhr"`

    - `const ContentNewParamsVariant0RejectResourceTypeFetch ContentNewParamsVariant0RejectResourceType = "fetch"`

    - `const ContentNewParamsVariant0RejectResourceTypePrefetch ContentNewParamsVariant0RejectResourceType = "prefetch"`

    - `const ContentNewParamsVariant0RejectResourceTypeEventsource ContentNewParamsVariant0RejectResourceType = "eventsource"`

    - `const ContentNewParamsVariant0RejectResourceTypeWebsocket ContentNewParamsVariant0RejectResourceType = "websocket"`

    - `const ContentNewParamsVariant0RejectResourceTypeManifest ContentNewParamsVariant0RejectResourceType = "manifest"`

    - `const ContentNewParamsVariant0RejectResourceTypeSignedexchange ContentNewParamsVariant0RejectResourceType = "signedexchange"`

    - `const ContentNewParamsVariant0RejectResourceTypePing ContentNewParamsVariant0RejectResourceType = "ping"`

    - `const ContentNewParamsVariant0RejectResourceTypeCspviolationreport ContentNewParamsVariant0RejectResourceType = "cspviolationreport"`

    - `const ContentNewParamsVariant0RejectResourceTypePreflight ContentNewParamsVariant0RejectResourceType = "preflight"`

    - `const ContentNewParamsVariant0RejectResourceTypeOther ContentNewParamsVariant0RejectResourceType = "other"`

  - `SetExtraHTTPHeaders param.Field[map[string, string]]`

    Body param

  - `SetJavaScriptEnabled param.Field[bool]`

    Body param

  - `UserAgent param.Field[string]`

    Body param

  - `Viewport param.Field[ContentNewParamsVariant0Viewport]`

    Body param: Check [options](https://pptr.dev/api/puppeteer.page.setviewport).

    - `Height float64`

    - `Width float64`

    - `DeviceScaleFactor float64`

    - `HasTouch bool`

    - `IsLandscape bool`

    - `IsMobile bool`

  - `WaitForSelector param.Field[ContentNewParamsVariant0WaitForSelector]`

    Body param: Wait for the selector to appear in page. Check [options](https://pptr.dev/api/puppeteer.page.waitforselector).

    - `Selector string`

    - `Hidden ContentNewParamsVariant0WaitForSelectorHidden`

      - `const ContentNewParamsVariant0WaitForSelectorHiddenTrue ContentNewParamsVariant0WaitForSelectorHidden = true`

    - `Timeout float64`

    - `Visible ContentNewParamsVariant0WaitForSelectorVisible`

      - `const ContentNewParamsVariant0WaitForSelectorVisibleTrue ContentNewParamsVariant0WaitForSelectorVisible = true`

  - `WaitForTimeout param.Field[float64]`

    Body param: Waits for a specified timeout before continuing.

### Returns

- `type ContentNewResponseEnvelopeResult string`

  HTML content.

### Example

```go
package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/browser_rendering"
  "github.com/cloudflare/cloudflare-go/option"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  content, err := client.BrowserRendering.Content.New(context.TODO(), browser_rendering.ContentNewParams{
    AccountID: cloudflare.F("account_id"),
    Body: browser_rendering.ContentNewParamsBodyObject{
      URL: cloudflare.F("https://www.example.com/"),
    },
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", content)
}
```

#### Response

```json
{
  "meta": {
    "status": 0,
    "title": "title"
  },
  "success": true,
  "errors": [
    {
      "code": 0,
      "message": "message"
    }
  ],
  "result": "result"
}
```