## Get HTML content and screenshot.

`client.BrowserRendering.Snapshot.New(ctx, params) (*SnapshotNewResponse, error)`

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

Returns the page's HTML content and screenshot. Control page loading with `gotoOptions` and `waitFor*` options. Customize screenshots with `viewport`, `fullPage`, `clip` and others.

### Parameters

- `params SnapshotNewParams`

  - `AccountID param.Field[string]`

    Path param: Account ID.

  - `HTML param.Field[string]`

    Body param: Set the content of the page, eg: `<h1>Hello World!!</h1>`. Either `html` or `url` must be set.

  - `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[[]SnapshotNewParamsVariant0AddScriptTag]`

    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[[]SnapshotNewParamsVariant0AddStyleTag]`

    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[[]SnapshotNewParamsVariant0AllowResourceType]`

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

    - `const SnapshotNewParamsVariant0AllowResourceTypeDocument SnapshotNewParamsVariant0AllowResourceType = "document"`

    - `const SnapshotNewParamsVariant0AllowResourceTypeStylesheet SnapshotNewParamsVariant0AllowResourceType = "stylesheet"`

    - `const SnapshotNewParamsVariant0AllowResourceTypeImage SnapshotNewParamsVariant0AllowResourceType = "image"`

    - `const SnapshotNewParamsVariant0AllowResourceTypeMedia SnapshotNewParamsVariant0AllowResourceType = "media"`

    - `const SnapshotNewParamsVariant0AllowResourceTypeFont SnapshotNewParamsVariant0AllowResourceType = "font"`

    - `const SnapshotNewParamsVariant0AllowResourceTypeScript SnapshotNewParamsVariant0AllowResourceType = "script"`

    - `const SnapshotNewParamsVariant0AllowResourceTypeTexttrack SnapshotNewParamsVariant0AllowResourceType = "texttrack"`

    - `const SnapshotNewParamsVariant0AllowResourceTypeXHR SnapshotNewParamsVariant0AllowResourceType = "xhr"`

    - `const SnapshotNewParamsVariant0AllowResourceTypeFetch SnapshotNewParamsVariant0AllowResourceType = "fetch"`

    - `const SnapshotNewParamsVariant0AllowResourceTypePrefetch SnapshotNewParamsVariant0AllowResourceType = "prefetch"`

    - `const SnapshotNewParamsVariant0AllowResourceTypeEventsource SnapshotNewParamsVariant0AllowResourceType = "eventsource"`

    - `const SnapshotNewParamsVariant0AllowResourceTypeWebsocket SnapshotNewParamsVariant0AllowResourceType = "websocket"`

    - `const SnapshotNewParamsVariant0AllowResourceTypeManifest SnapshotNewParamsVariant0AllowResourceType = "manifest"`

    - `const SnapshotNewParamsVariant0AllowResourceTypeSignedexchange SnapshotNewParamsVariant0AllowResourceType = "signedexchange"`

    - `const SnapshotNewParamsVariant0AllowResourceTypePing SnapshotNewParamsVariant0AllowResourceType = "ping"`

    - `const SnapshotNewParamsVariant0AllowResourceTypeCspviolationreport SnapshotNewParamsVariant0AllowResourceType = "cspviolationreport"`

    - `const SnapshotNewParamsVariant0AllowResourceTypePreflight SnapshotNewParamsVariant0AllowResourceType = "preflight"`

    - `const SnapshotNewParamsVariant0AllowResourceTypeOther SnapshotNewParamsVariant0AllowResourceType = "other"`

  - `Authenticate param.Field[SnapshotNewParamsVariant0Authenticate]`

    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[[]SnapshotNewParamsVariant0Cookie]`

    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 SnapshotNewParamsVariant0CookiesPriority`

      - `const SnapshotNewParamsVariant0CookiesPriorityLow SnapshotNewParamsVariant0CookiesPriority = "Low"`

      - `const SnapshotNewParamsVariant0CookiesPriorityMedium SnapshotNewParamsVariant0CookiesPriority = "Medium"`

      - `const SnapshotNewParamsVariant0CookiesPriorityHigh SnapshotNewParamsVariant0CookiesPriority = "High"`

    - `SameParty bool`

    - `SameSite SnapshotNewParamsVariant0CookiesSameSite`

      - `const SnapshotNewParamsVariant0CookiesSameSiteStrict SnapshotNewParamsVariant0CookiesSameSite = "Strict"`

      - `const SnapshotNewParamsVariant0CookiesSameSiteLax SnapshotNewParamsVariant0CookiesSameSite = "Lax"`

      - `const SnapshotNewParamsVariant0CookiesSameSiteNone SnapshotNewParamsVariant0CookiesSameSite = "None"`

    - `Secure bool`

    - `SourcePort float64`

    - `SourceScheme SnapshotNewParamsVariant0CookiesSourceScheme`

      - `const SnapshotNewParamsVariant0CookiesSourceSchemeUnset SnapshotNewParamsVariant0CookiesSourceScheme = "Unset"`

      - `const SnapshotNewParamsVariant0CookiesSourceSchemeNonSecure SnapshotNewParamsVariant0CookiesSourceScheme = "NonSecure"`

      - `const SnapshotNewParamsVariant0CookiesSourceSchemeSecure SnapshotNewParamsVariant0CookiesSourceScheme = "Secure"`

    - `URL string`

  - `EmulateMediaType param.Field[string]`

    Body param

  - `GotoOptions param.Field[SnapshotNewParamsVariant0GotoOptions]`

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

    - `Referer string`

    - `ReferrerPolicy string`

    - `Timeout float64`

    - `WaitUntil SnapshotNewParamsVariant0GotoOptionsWaitUntilUnion`

      - `SnapshotNewParamsVariant0GotoOptionsWaitUntilString`

        - `const SnapshotNewParamsVariant0GotoOptionsWaitUntilStringLoad SnapshotNewParamsVariant0GotoOptionsWaitUntilString = "load"`

        - `const SnapshotNewParamsVariant0GotoOptionsWaitUntilStringDomcontentloaded SnapshotNewParamsVariant0GotoOptionsWaitUntilString = "domcontentloaded"`

        - `const SnapshotNewParamsVariant0GotoOptionsWaitUntilStringNetworkidle0 SnapshotNewParamsVariant0GotoOptionsWaitUntilString = "networkidle0"`

        - `const SnapshotNewParamsVariant0GotoOptionsWaitUntilStringNetworkidle2 SnapshotNewParamsVariant0GotoOptionsWaitUntilString = "networkidle2"`

      - `SnapshotNewParamsVariant0GotoOptionsWaitUntilArray`

        - `const SnapshotNewParamsVariant0GotoOptionsWaitUntilArrayLoad SnapshotNewParamsVariant0GotoOptionsWaitUntilArray = "load"`

        - `const SnapshotNewParamsVariant0GotoOptionsWaitUntilArrayDomcontentloaded SnapshotNewParamsVariant0GotoOptionsWaitUntilArray = "domcontentloaded"`

        - `const SnapshotNewParamsVariant0GotoOptionsWaitUntilArrayNetworkidle0 SnapshotNewParamsVariant0GotoOptionsWaitUntilArray = "networkidle0"`

        - `const SnapshotNewParamsVariant0GotoOptionsWaitUntilArrayNetworkidle2 SnapshotNewParamsVariant0GotoOptionsWaitUntilArray = "networkidle2"`

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

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

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

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

    - `const SnapshotNewParamsVariant0RejectResourceTypeDocument SnapshotNewParamsVariant0RejectResourceType = "document"`

    - `const SnapshotNewParamsVariant0RejectResourceTypeStylesheet SnapshotNewParamsVariant0RejectResourceType = "stylesheet"`

    - `const SnapshotNewParamsVariant0RejectResourceTypeImage SnapshotNewParamsVariant0RejectResourceType = "image"`

    - `const SnapshotNewParamsVariant0RejectResourceTypeMedia SnapshotNewParamsVariant0RejectResourceType = "media"`

    - `const SnapshotNewParamsVariant0RejectResourceTypeFont SnapshotNewParamsVariant0RejectResourceType = "font"`

    - `const SnapshotNewParamsVariant0RejectResourceTypeScript SnapshotNewParamsVariant0RejectResourceType = "script"`

    - `const SnapshotNewParamsVariant0RejectResourceTypeTexttrack SnapshotNewParamsVariant0RejectResourceType = "texttrack"`

    - `const SnapshotNewParamsVariant0RejectResourceTypeXHR SnapshotNewParamsVariant0RejectResourceType = "xhr"`

    - `const SnapshotNewParamsVariant0RejectResourceTypeFetch SnapshotNewParamsVariant0RejectResourceType = "fetch"`

    - `const SnapshotNewParamsVariant0RejectResourceTypePrefetch SnapshotNewParamsVariant0RejectResourceType = "prefetch"`

    - `const SnapshotNewParamsVariant0RejectResourceTypeEventsource SnapshotNewParamsVariant0RejectResourceType = "eventsource"`

    - `const SnapshotNewParamsVariant0RejectResourceTypeWebsocket SnapshotNewParamsVariant0RejectResourceType = "websocket"`

    - `const SnapshotNewParamsVariant0RejectResourceTypeManifest SnapshotNewParamsVariant0RejectResourceType = "manifest"`

    - `const SnapshotNewParamsVariant0RejectResourceTypeSignedexchange SnapshotNewParamsVariant0RejectResourceType = "signedexchange"`

    - `const SnapshotNewParamsVariant0RejectResourceTypePing SnapshotNewParamsVariant0RejectResourceType = "ping"`

    - `const SnapshotNewParamsVariant0RejectResourceTypeCspviolationreport SnapshotNewParamsVariant0RejectResourceType = "cspviolationreport"`

    - `const SnapshotNewParamsVariant0RejectResourceTypePreflight SnapshotNewParamsVariant0RejectResourceType = "preflight"`

    - `const SnapshotNewParamsVariant0RejectResourceTypeOther SnapshotNewParamsVariant0RejectResourceType = "other"`

  - `ScreenshotOptions param.Field[SnapshotNewParamsVariant0ScreenshotOptions]`

    Body param

    - `CaptureBeyondViewport bool`

    - `Clip SnapshotNewParamsVariant0ScreenshotOptionsClip`

      - `Height float64`

      - `Width float64`

      - `X float64`

      - `Y float64`

      - `Scale float64`

    - `FromSurface bool`

    - `FullPage bool`

    - `OmitBackground bool`

    - `OptimizeForSpeed bool`

    - `Quality float64`

    - `Type SnapshotNewParamsVariant0ScreenshotOptionsType`

      - `const SnapshotNewParamsVariant0ScreenshotOptionsTypePNG SnapshotNewParamsVariant0ScreenshotOptionsType = "png"`

      - `const SnapshotNewParamsVariant0ScreenshotOptionsTypeJPEG SnapshotNewParamsVariant0ScreenshotOptionsType = "jpeg"`

      - `const SnapshotNewParamsVariant0ScreenshotOptionsTypeWebP SnapshotNewParamsVariant0ScreenshotOptionsType = "webp"`

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

    Body param

  - `SetJavaScriptEnabled param.Field[bool]`

    Body param

  - `UserAgent param.Field[string]`

    Body param

  - `Viewport param.Field[SnapshotNewParamsVariant0Viewport]`

    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[SnapshotNewParamsVariant0WaitForSelector]`

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

    - `Selector string`

    - `Hidden SnapshotNewParamsVariant0WaitForSelectorHidden`

      - `const SnapshotNewParamsVariant0WaitForSelectorHiddenTrue SnapshotNewParamsVariant0WaitForSelectorHidden = true`

    - `Timeout float64`

    - `Visible SnapshotNewParamsVariant0WaitForSelectorVisible`

      - `const SnapshotNewParamsVariant0WaitForSelectorVisibleTrue SnapshotNewParamsVariant0WaitForSelectorVisible = true`

  - `WaitForTimeout param.Field[float64]`

    Body param: Waits for a specified timeout before continuing.

### Returns

- `type SnapshotNewResponse struct{…}`

  - `Content string`

    HTML content.

  - `Screenshot string`

    Base64 encoded image.

### 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"),
  )
  snapshot, err := client.BrowserRendering.Snapshot.New(context.TODO(), browser_rendering.SnapshotNewParams{
    AccountID: cloudflare.F("account_id"),
    Body: browser_rendering.SnapshotNewParamsBodyObject{
      URL: cloudflare.F("https://www.example.com/"),
    },
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", snapshot.Content)
}
```

#### Response

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